حمل و نقل

دو نوع روش انتقال وجود دارد که می‌توان هنگام ارسال درخواست‌ها به API از آنها استفاده کرد. کتابخانه کلاینت PHP به طور خودکار روش انتقال بهینه را بر اساس محیط شما انتخاب می‌کند:

  • ترجیحی ( grpc ) : gRPC . این روش نیاز به نصب افزونه PHP مربوط به gRPC دارد و مبتنی بر HTTP/2 است.
  • Fallback ( rest ) : REST . به طور خودکار زمانی که افزونه gRPC در دسترس نیست، استفاده می‌شود. نیازی به نصب هیچ افزونه PHP اضافی ندارد و مبتنی بر HTTP/1.1 است.

پیکربندی حمل و نقل

اگر ترجیح می‌دهید به جای تکیه بر قوانین انتخاب خودکار پیش‌فرض که در بخش قبل توضیح داده شد، نوع انتقال ( grpc یا rest ) را به طور صریح مشخص کنید، می‌توانید تنظیمات transport را در فایل google_ads_php.ini یا به صورت برنامه‌نویسی پیکربندی کنید.

پیکربندی در google_ads_php.ini

ویژگی transport را در بخش CONNECTION از فایل google_ads_php.ini خود تنظیم کنید:

[CONNECTION]
; Optional transport settings.
; By default, "grpc" is used if available; otherwise, "rest" is used.
transport = "grpc"

پیکربندی از طریق برنامه‌نویسی

از طرف دیگر، می‌توانید تنظیمات انتقال را به صورت برنامه‌نویسی شده هنگام ساخت کلاینت پیکربندی کنید:

$googleAdsClient = (new GoogleAdsClientBuilder())
    // ...
    ->withTransport('grpc')
    ->build();