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

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

إليك مثال على إرسال طلب بحث إلى GoogleAdsService.SearchStream() وضبط withResponseMetadata على true:

[$response, $metadata] = $googleAdsServiceClient->searchStream(
    $customerId,
    $query,
    ['withResponseMetadata' => true]
);

يتم عرض صفيف، مع $response تتكون من نتائج الاستعلام من SearchGoogleAdsStreamResponse.

يحتوي العضو الثاني في الصفيف، $metadata، على البيانات الوصفية للاستجابة في الحقل metadata، وهو صفيف نفسه:

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

يمكنك استرداد معرّف الطلب من مفتاح request-id على غرار استخدام GoogleAdsResponseMetadata::getRequestId().