Metadados de resposta

A biblioteca de cliente PHP registra a resposta metadados, incluindo um ID de solicitação, por padrão. Como alternativa, você pode obter o metadados de resposta programaticamente ao chamar métodos de serviço ao cliente por definindo o parâmetro opcional withResponseMetadata como true.

Depois de chamar os métodos de serviço ao cliente, você poderá obter GoogleAdsResponseMetadata, de um objeto relevante, como um cliente de serviço ou um stream, de acordo com que você chamar. Esse objeto contém getMetadata() e getRequestId(), que retornam metadados de resposta e o ID da solicitação da chamada de API, respectivamente. O método getMetadata() retorna uma matriz parecida com esta:

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

O método getRequestId() simplifica o processo de extração do ID da solicitação. da matriz de metadados, poupando o esforço de analisá-los manualmente.

As seções a seguir explicam como recuperar GoogleAdsResponseMetadata para cada método.

SearchStream

Para conseguir um objeto de GoogleAdsResponseMetadata, chame getResponseMetadata(). no objeto stream:

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

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

O $stream->getResponseMetadata() é um objeto de GoogleAdsResponseMetadata.

Pesquisa e outros métodos de mutação

Para conseguir um objeto de GoogleAdsResponseMetadata, chame getResponseMetadata(). no objeto 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;

Os métodos $campaignServiceClient->getResponseMetadata() e $googleAdsServiceClient->getResponseMetadata() são objetos de GoogleAdsResponseMetadata