البيانات الوصفية للرد

تتولّى مكتبة برامج PHP تسجيل البيانات الوصفية للاستجابة، بما في ذلك رقم تعريف الطلب، تلقائيًا. بدلاً من ذلك، يمكنك الحصول على البيانات الوصفية للرد آليًا عند استدعاء طرق خدمة العميل من خلال ضبط المَعلمة الاختيارية withResponseMetadata على true.

بعد استدعاء طرق خدمة العميل، يمكنك الحصول على GoogleAdsResponseMetadata من عنصر ذي صلة، مثل عميل خدمة أو بث، وفقًا للطريقة التي تستدعيها. يحتوي هذا العنصر على getMetadata() وgetRequestId()، اللذين يعرضان البيانات الوصفية للاستجابة ومعرّف الطلب الخاص باستدعاء واجهة برمجة التطبيقات، على التوالي. تعرض الطريقة getMetadata() صفيفًا يبدو على النحو التالي:

object(Google\Ads\GoogleAds\Lib\V21\GoogleAdsResponseMetadata)#51 (1) {
  ["metadata":"Google\Ads\GoogleAds\Lib\V21\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:

$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.