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

כברירת מחדל, ספריית הלקוח של 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().