מטא-נתונים של תשובות

ספריית הלקוח של PHP מתעדת ביומן את המטא-נתונים של התגובה, כולל מזהה בקשה, כברירת מחדל. לחלופין, אפשר לקבל את מטא-נתוני התגובה באופן פרוגרמטי כשקוראים לשיטות של שירות לקוחות על ידי הגדרת הפרמטר האופציונלי withResponseMetadata לערך true.

אחרי שמפעילים שיטות של שירות לקוחות, אפשר לקבל את GoogleAdsResponseMetadata מאובייקט רלוונטי, כמו לקוח שירות או סטרימינג, בהתאם לשיטה שהופעלה. האובייקט הזה מכיל את getMetadata() ואת getRequestId(), שמחזירים מטא-נתונים של התגובה ומזהה הבקשה של קריאת ה-API, בהתאמה. השיטה 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() באובייקט 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.