Antwortmetadaten

Die PHP-Clientbibliothek protokolliert die Antwort. einschließlich einer Anfrage-ID. Alternativ erhalten Sie den durch den programmatischen Aufruf von Clientdienstmethoden über Der optionale Parameter withResponseMetadata wird auf true festgelegt.

Nachdem Sie Clientdienstmethoden aufgerufen haben, können Sie GoogleAdsResponseMetadata, aus einem relevanten Objekt, wie einem Dienstclient oder einem Stream, aufgerufen wird. Dieses Objekt enthält getMetadata() und getRequestId(). die Antwortmetadaten bzw. die Anfrage-ID des API-Aufrufs zurückgeben. Die Methode getMetadata() gibt ein Array zurück, das so aussieht:

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

Die Methode getRequestId() vereinfacht das Extrahieren der Anfrage-ID aus dem Metadatenarray, sodass Sie es nicht manuell parsen müssen.

In den folgenden Abschnitten wird erläutert, wie Sie GoogleAdsResponseMetadata für für die einzelnen Methoden.

SearchStream

Rufen Sie getResponseMetadata() auf, um ein GoogleAdsResponseMetadata-Objekt zu erhalten. für das stream-Objekt:

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

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

$stream->getResponseMetadata() ist ein Objekt von GoogleAdsResponseMetadata.

Suche und andere mutate-Methoden

Rufen Sie getResponseMetadata() auf, um ein GoogleAdsResponseMetadata-Objekt zu erhalten. für das client-Objekt:

// 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;

Die $campaignServiceClient->getResponseMetadata() und $googleAdsServiceClient->getResponseMetadata() sind ein Objekt von GoogleAdsResponseMetadata