Recherche et SearchStream

L'API Search Ads 360 Reporting offre 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 l'outil de requête Search Ads 360 Langue. Cela permet d'exécuter des requêtes complexes qui peuvent renvoyer de grandes quantités de données sur de comptes individuels Search Ads 360.

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 tailles de page personnalisables, ce qui vous permet d'itérer sur un ensemble de résultats à l'aide de la pagination. Cela peut être avantageux avec une faible bande passante. ou des conditions de réseau peu fiables (par exemple, pour segmenter un vaste ensemble de résultats). en réponses plus petites qui peuvent être récupérées si une connexion est perdue. La La méthode SearchStream, quant à elle, transmet l'intégralité des résultats une seule réponse, ce qui peut s'avérer plus efficace pour la récupération groupée de données.

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

    https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360

La méthode de recherche basée sur les pages utilise un paramètre pageSize facultatif qui limite le nombre de résultats renvoyés dans une seule réponse d'API.

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchAds360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN

{
"pageSize": 10000,
"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'"
}

S'il y a plus de lignes dans les résultats que pageSize, une nextPageToken est renvoyé dans la réponse:

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

Répéter la même requête avec pageToken ajouté avec la valeur ci-dessus permet d'extraire la page de résultats suivante:

POST /v0/customers/CUSTOMER_ID/searchAds360:search HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_TOKEN


{
"pageSize": 10000,
"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 simplement la méthode de service dans l'URL par searchStream. (pageSize et pageToken ne sont pas obligatoires pour SearchStream):

POST /v0/customers/CUSTOMER_ID/searchAds360:searchStream HTTP/1.1
Host: searchads360.googleapis.com
Content-Type: application/json
Authorization: Bearer ACCESS_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'"
}