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

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

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

object(Google\Ads\GoogleAds\Lib\V19\GoogleAdsResponseMetadata)#51 (1) {
  ["metadata":"Google\Ads\GoogleAds\Lib\V19\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() على عنصر 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.