Recherche et SearchStream

Vidéo: création de rapports

L'API Google Ads propose un système unifié de récupération des attributs et de création de rapports sur les métriques. mécanisme qui vous permet de créer des requêtes à l'aide de la fonction Requête Google Ads Langue. Cela permet d'exécuter des requêtes complexes qui peuvent renvoyer de grandes quantités de données sur comptes Google Ads individuels.

Vous pouvez créer des requêtes à l'aide des méthodes Search ou SearchStream. Les deux méthodes acceptent les mêmes requêtes et renvoient des résultats équivalents. La La méthode Search renvoie des données dans des pages de taille fixe de 10 000 lignes, ce qui vous permet pour itérer sur un ensemble de résultats à l'aide de la pagination. Cela peut être avantageux dans les cas de bande passante ou de conditions réseau peu fiables, par exemple pour segmenter ensemble de résultats sous forme de réponses plus petites pouvant être récupérées à nouveau si une connexion est perdu. En revanche, la méthode SearchStream diffuse l'intégralité du résultat. le retard dans une seule réponse, ce qui peut s'avérer plus efficace pour les volumes de données la récupération.

Search et SearchStream utilisent la même URL de base:

    https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds
POST /v17/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'"
}

Si les résultats comportent plus de 10 000 lignes,une nextPageToken est renvoyée dans la réponse:

{
  "results": [
    // ...
    // ...
    // ...
  ],
  "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B",
  "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status"
}

En répétant la même requête avec un pageToken ajouté avec les valeurs du La requête précédente récupère la page de résultats suivante:

POST /v17/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"
}

Pour utiliser la méthode SearchStream, qui renvoie tous les résultats dans un seul flux continu , remplacez la méthode de service dans l'URL par searchStream. (pageSize et pageToken ne sont pas obligatoires pour SearchStream):

POST /v17/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'"
}