回應中繼資料

PHP 用戶端程式庫會記錄回應 中繼資料 (包含要求 ID) 所組成。此外，您也可以取得 呼叫用戶端服務方法時，以程式輔助的方式呼叫回應中繼資料 將選用參數 withResponseMetadata 設為 true。

呼叫用戶端服務方法後， GoogleAdsResponseMetadata、 並根據 您呼叫的方法。這個物件包含 getMetadata() 和 getRequestId()， ，分別傳回回應中繼資料和 API 呼叫的要求 ID。 getMetadata() 方法會傳回類似下方的陣列：

object(Google\Ads\GoogleAds\Lib\V22\GoogleAdsResponseMetadata)#51 (1) {
  ["metadata":"Google\Ads\GoogleAds\Lib\V22\GoogleAdsResponseMetadata":private]=>
  array(17) {
    ["content-disposition"]=>
    array(1) {
      [0]=>
      string(10) "attachment"
    }
    ["request-id"]=>
    array(1) {
      [0]=>
      string(22) "REQUEST_ID"
    }
    ...
  }
}

getRequestId() 方法可簡化要求 ID 的擷取程序。 移除中繼資料，因此您不必手動剖析。

下列各節說明如何擷取 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。