回應中繼資料

PHP 用戶端程式庫預設會記錄回應中繼資料,包括要求 ID。或者,您也可以將選用的參數 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 鍵擷取要求 ID,與使用 GoogleAdsResponseMetadata::getRequestId() 類似。