فراداده پاسخ

کتابخانه مشتری PHP فراداده پاسخ، از جمله شناسه درخواست را به طور پیش فرض ثبت می کند . از طرف دیگر، می‌توانید با تنظیم پارامتر اختیاری withResponseMetadata روی true ، فراداده پاسخ را به صورت برنامه‌نویسی هنگام فراخوانی روش‌های سرویس مشتری دریافت کنید.

پس از فراخوانی روش‌های خدمات مشتری، می‌توانید GoogleAdsResponseMetadata از یک شی مرتبط، مانند سرویس گیرنده یا جریان، مطابق روشی که فراخوانی می‌کنید، دریافت کنید. این شی شامل getMetadata() و getRequestId() است که به ترتیب متاداده پاسخ و شناسه درخواست فراخوانی API را برمی گرداند. متد getMetadata() آرایه ای را به شکل زیر برمی گرداند:

object(Google\Ads\GoogleAds\Lib\V17\GoogleAdsResponseMetadata)#51 (1) {
  ["metadata":"Google\Ads\GoogleAds\Lib\V17\GoogleAdsResponseMetadata":private]=>
  array(17) {
    ["content-disposition"]=>
    array(1) {
      [0]=>
      string(10) "attachment"
    }
    ["request-id"]=>
    array(1) {
      [0]=>
      string(22) "REQUEST_ID"
    }
    ...
  }
}

متد getRequestId() فرآیند استخراج شناسه درخواست از آرایه ابرداده را ساده می کند و در تلاش برای تجزیه دستی آن صرفه جویی می کند.

بخش‌های زیر نحوه بازیابی GoogleAdsResponseMetadata برای هر روش را توضیح می‌دهد.

SearchStream

برای به دست آوردن یک شی از GoogleAdsResponseMetadata ، getResponseMetadata() را در شی جریان فراخوانی کنید:

$stream = $googleAdsServiceClient->searchStream(
    SearchGoogleAdsStreamRequest::build($customerId, $query),
    ['withResponseMetadata' => true]
);

// Prints the request ID.
print $stream->getResponseMetadata()->getRequestId() . PHP_EOL;

$stream->getResponseMetadata() یک شی از GoogleAdsResponseMetadata است.

جستجو و سایر روش های جهش

برای به دست آوردن یک شی از GoogleAdsResponseMetadata ، getResponseMetadata() را در شی مشتری فراخوانی کنید:

// Retrieves objects.
$response = $googleAdsServiceClient->search(
    SearchGoogleAdsRequest::build($customerId, $query),
    ['withResponseMetadata' => true]
);

// Prints the request ID.
print $googleAdsServiceClient->getResponseMetadata()->getRequestId() . PHP_EOL;

// Mutates campaigns.
$response = $campaignServiceClient->mutateCampaigns(
    MutateCampaignsRequest::build($customerId, $campaignOperations),
    ['withResponseMetadata' => true]
);

// Prints the request ID.
print $campaignServiceClient->getResponseMetadata()->getRequestId() . PHP_EOL;

$campaignServiceClient->getResponseMetadata() و $googleAdsServiceClient->getResponseMetadata() یک شی از GoogleAdsResponseMetadata هستند.