Métadonnées de réponse

Avertissement:À compter du 31 mars 2024, la bibliothèque cliente de l'API Google Ads pour PHP ne sera plus compatible avec les versions de PHP antérieures à la version 8.1. Pour assurer un fonctionnement fluide, nous vous recommandons vivement de mettre à niveau votre version de PHP avant cette date.

Par défaut, la bibliothèque cliente PHP enregistre les métadonnées de réponse, y compris un ID de requête. Vous pouvez également obtenir les métadonnées de réponse par programmation lorsque vous appelez des méthodes de service client en définissant le paramètre facultatif withResponseMetadata sur true.

Voici un exemple d'envoi d'une requête à GoogleAdsService.SearchStream() et de définition de withResponseMetadata sur true:

[$response, $metadata] = $googleAdsServiceClient->searchStream(
    $customerId,
    $query,
    ['withResponseMetadata' => true]
);

Un tableau est renvoyé, avec $response constitué des résultats de la requête provenant de SearchGoogleAdsStreamResponse.

Le deuxième membre du tableau, $metadata, contient les métadonnées de réponse dans le champ metadata, qui est lui-même un tableau:

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

Vous pouvez récupérer l'ID de requête à partir de la clé request-id, de la même manière que pour GoogleAdsResponseMetadata::getRequestId().