Métadonnées de réponse

La bibliothèque cliente PHP enregistre la réponse des métadonnées, y compris un ID de requête, par défaut. Vous pouvez également obtenir les métadonnées de réponse de manière programmatique lors de l'appel de méthodes de service client en Définissez le paramètre facultatif withResponseMetadata sur true.

Après avoir appelé les méthodes du service client, vous pouvez obtenir GoogleAdsResponseMetadata, d'un objet pertinent, comme un client de service ou un flux, selon que vous appelez. Cet objet contient getMetadata() et getRequestId(), qui renvoient respectivement les métadonnées de réponse et l'ID de requête de l'appel d'API. La méthode getMetadata() renvoie un tableau qui se présente comme suit:

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

La méthode getRequestId() simplifie le processus d'extraction de l'ID de requête. à partir du tableau de métadonnées, ce qui vous évite d'avoir à l'analyser manuellement.

Les sections suivantes expliquent comment récupérer GoogleAdsResponseMetadata pour chaque méthode.

SearchStream

Pour obtenir un objet de GoogleAdsResponseMetadata, appelez getResponseMetadata(). sur l'objet stream:

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

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

$stream->getResponseMetadata() est un objet de GoogleAdsResponseMetadata

Recherche et autres méthodes mutate

Pour obtenir un objet de GoogleAdsResponseMetadata, appelez getResponseMetadata(). sur l'objet 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;

Les $campaignServiceClient->getResponseMetadata() et $googleAdsServiceClient->getResponseMetadata() sont un objet de GoogleAdsResponseMetadata