Die Google Ads API bietet einen einheitlichen Abrufmechanismus für Attribute und Messwertberichte, mit dem Sie Abfragen mit der Google Ads-Abfragesprache erstellen können. So sind komplexe Abfragen möglich, mit denen große Datenmengen zu einzelnen Google Ads-Konten zurückgegeben werden können.
Sie können Abfragen mit der Methode Search oder SearchStream erstellen.
Beide Methoden unterstützen dieselben Abfragen und geben dieselben Ergebnisse zurück. Die Methode Search gibt Daten in Seiten mit fester Größe von 10.000 Zeilen zurück. So können Sie einen Ergebnissatz mithilfe der Paginierung durchgehen. Das kann bei geringer Bandbreite oder bei unzuverlässigen Netzwerkbedingungen von Vorteil sein, z. B. um einen großen Ergebnissatz in kleinere Antworten zu segmentieren, die bei einer Verbindungsunterbrechung neu abgerufen werden können. Bei der SearchStream-Methode wird dagegen der gesamte Ergebnissatz in einer einzigen Antwort gestreamt, was für das Abrufen von Bulk-Daten effizienter sein kann.
Sowohl Search als auch SearchStream verwenden dieselbe Basis-URL:
https://googleads.googleapis.com/v18/customers/CUSTOMER_ID/googleAds
POST /v18/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}
Wenn die Ergebnisse mehr als 10.000 Zeilen enthalten,wird in der Antwort ein nextPageToken zurückgegeben:
{
"results": [
// ...
// ...
// ...
],
"nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
"fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}
Wenn Sie dieselbe Abfrage mit einem pageToken wiederholen, das die Werte aus der vorherigen Anfrage enthält, wird die nächste Ergebnisseite abgerufen:
POST /v18/customers/CUSTOMER_ID/googleAds:search HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'",
"pageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B"
}
Wenn Sie die Methode SearchStream verwenden möchten, die alle Ergebnisse in einer einzelnen gestreamten Antwort zurückgibt, ändern Sie die Dienstmethode in der URL zu searchStream. pageToken ist für SearchStream nicht erforderlich:
POST /v18/customers/CUSTOMER_ID/googleAds:searchStream HTTP/1.1
Host: googleads.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
{
"query": "SELECT ad_group_criterion.keyword.text, ad_group_criterion.status FROM ad_group_criterion WHERE ad_group_criterion.type = 'KEYWORD' AND ad_group_criterion.status = 'ENABLED'"
}