Yanıt Meta Verileri

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

Müşteri hizmeti yöntemlerini çağırdıktan sonra, çağırdığınız yönteme göre hizmet istemcisi veya akış gibi ilgili 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 bir dizi döndürür:

object(Google\Ads\GoogleAds\Lib\V21\GoogleAdsResponseMetadata)#51 (1) {
  ["metadata":"Google\Ads\GoogleAds\Lib\V21\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 çıkarma sürecini basitleştirerek manuel olarak ayrıştırma zahmetinden kurtulmanızı sağlar.

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

SearchStream

GoogleAdsResponseMetadata nesnesini elde etmek için stream nesnesinde getResponseMetadata() çağrısı yapın:

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

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

$stream->getResponseMetadata(), GoogleAdsResponseMetadata öğesinin nesnesidir.

Arama ve diğer değiştirme yöntemleri

GoogleAdsResponseMetadata nesnesi elde etmek için istemci nesnesinde getResponseMetadata() işlevini ç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 adlı kuruluşun bünyesinde yer alıyor.