Siêu dữ liệu phản hồi

Thư viện ứng dụng PHP ghi nhật ký phản hồi siêu dữ liệu, bao gồm cả mã yêu cầu, theo mặc định. Ngoài ra, bạn có thể lấy siêu dữ liệu phản hồi theo cách lập trình khi gọi các phương thức dịch vụ ứng dụng bằng cách đặt tham số không bắt buộc withResponseMetadata thành true.

Sau khi gọi phương thức dịch vụ khách, bạn có thể nhận được GoogleAdsResponseMetadata! từ một đối tượng có liên quan, chẳng hạn như ứng dụng dịch vụ hoặc luồng, theo mà bạn gọi. Đối tượng này chứa getMetadata() và getRequestId(), lần lượt trả về siêu dữ liệu phản hồi và mã yêu cầu của lệnh gọi API. Phương thức getMetadata() trả về một mảng có dạng như sau:

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

Phương thức getRequestId() giúp đơn giản hoá quá trình trích xuất mã yêu cầu khỏi mảng siêu dữ liệu, giúp bạn tiết kiệm công sức phân tích cú pháp dữ liệu theo cách thủ công.

Các phần sau đây giải thích cách truy xuất GoogleAdsResponseMetadata cho từng phương thức.

SearchStream

Để lấy đối tượng của GoogleAdsResponseMetadata, hãy gọi getResponseMetadata() trên đối tượng stream:

$stream = $googleAdsServiceClient->searchStream(
    SearchGoogleAdsStreamRequest::build($customerId, $query),
    ['withResponseMetadata' => true]
);

// Prints the request ID.
print $stream->getResponseMetadata()->getRequestId() . PHP_EOL;

$stream->getResponseMetadata() là một đối tượng của GoogleAdsResponseMetadata

Tìm kiếm và các phương thức thay đổi khác

Để lấy đối tượng của GoogleAdsResponseMetadata, hãy gọi getResponseMetadata() trên đối tượng 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() và $googleAdsServiceClient->getResponseMetadata() là một đối tượng của GoogleAdsResponseMetadata.