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

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

بعد استدعاء طرق خدمة العملاء، يمكنك الحصول على GoogleAdsResponseMetadata، من عنصر ذي صلة، مثل برنامج خدمة أو بث، وذلك وفقًا الطريقة التي تستدعيها. يتضمّن هذا الكائن getMetadata() وgetRequestId()، الذي يعرض البيانات الوصفية للاستجابة ومعرّف الطلب لطلب بيانات من واجهة برمجة التطبيقات، على التوالي. تُرجع الطريقة 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:

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

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

$stream->getResponseMetadata() عبارة عن كائن GoogleAdsResponseMetadata

البحث وطرق التغيير الأخرى

للحصول على كائن GoogleAdsResponseMetadata، يمكنك طلب getResponseMetadata(). في الكائن client:

// 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