Yanıt Meta Verileri

PHP istemci kitaplığı, varsayılan olarak istek kimliği dahil yanıt meta verilerini günlüğe kaydeder. Alternatif olarak, isteğe bağlı withResponseMetadata parametresini true olarak ayarlayarak istemci hizmeti yöntemlerini çağırırken yanıt meta verilerini programatik olarak elde edebilirsiniz.

Müşteri hizmetleri yöntemlerini çağırdıktan sonra, çağırdığınız yönteme göre hizmet istemcisi veya akış gibi alakalı bir nesneden GoogleAdsResponseMetadata elde edebilirsiniz. Bu nesne, sırasıyla yanıt meta verilerini ve API çağrısının istek kimliğini döndüren getMetadata() ve getRequestId() öğelerini içerir. getMetadata() yöntemi, aşağıdaki gibi görünen bir dizi döndürür:

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

getRequestId() yöntemi, istek kimliğini meta veri dizisinden ayıklama sürecini basitleştirerek manuel olarak ayrıştırma zahmetinden kurtarır.

Aşağıdaki bölümlerde her yöntem için GoogleAdsResponseMetadata değerinin nasıl alınacağı açıklanmaktadır.

SearchStream

GoogleAdsResponseMetadata nesnesi almak için stream nesnesinde getResponseMetadata() işlevini çağırın:

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

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

$stream->getResponseMetadata(), GoogleAdsResponseMetadata sınıfının bir nesnesi olmalıdır.

Arama ve diğer mutasyon yöntemleri

GoogleAdsResponseMetadata nesnesi almak için istemci nesnesinde getResponseMetadata()'yi çağırın:

// 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() ve $googleAdsServiceClient->getResponseMetadata(), GoogleAdsResponseMetadata nesnesi altındadır.