ข้อมูลเมตาของการตอบกลับ

ไลบรารีของไคลเอ็นต์ PHP บันทึกการตอบกลับ ข้อมูลเมตา ซึ่งรวมถึงรหัสคำขอโดยค่าเริ่มต้น หรือคุณสามารถขอรับ ตอบกลับข้อมูลเมตาแบบเป็นโปรแกรมเมื่อเรียกใช้เมธอดของบริการไคลเอ็นต์โดย กำลังตั้งค่าพารามิเตอร์ที่ไม่บังคับ withResponseMetadata เป็น true

หลังจากที่คุณเรียกใช้เมธอดการบริการลูกค้าแล้ว คุณสามารถดู GoogleAdsResponseMetadata จากออบเจ็กต์ที่เกี่ยวข้อง เช่น ไคลเอ็นต์บริการหรือสตรีม ตาม วิธีที่คุณเรียกใช้ ออบเจ็กต์นี้มี getMetadata() และ getRequestId() ซึ่งจะแสดงผลข้อมูลเมตาการตอบกลับและรหัสคำขอของการเรียก API ตามลำดับ เมธอด getMetadata() จะแสดงอาร์เรย์ที่มีลักษณะเช่นนี้

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"
    }
    ...
  }
}

เมธอด getRequestId() ทำให้กระบวนการดึงข้อมูลรหัสคำของ่ายขึ้น จากอาร์เรย์ข้อมูลเมตา ทำให้ช่วยประหยัดเวลาในการแยกวิเคราะห์ด้วยตนเอง

ส่วนต่อไปนี้จะอธิบายวิธีเรียกข้อมูล 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