La API de Search Ads 360 Reporting tiene un mecanismo unificado de recuperación de atributos y generación de informes de métricas que te permite crear consultas con el lenguaje de consultas de Search Ads 360. Esto permite realizar consultas complejas que pueden devolver grandes cantidades de datos sobre cuentas individuales de Search Ads 360.
Puedes crear consultas con los métodos Search o SearchStream.
Ambos métodos admiten las mismas consultas y devuelven resultados equivalentes. El método Search devuelve datos en tamaños de página personalizables, lo que te permite iterar un conjunto de resultados con paginación. Esto podría ser ventajoso en condiciones de ancho de banda bajo o de red poco confiable, por ejemplo, para segmentar un conjunto de resultados grande en respuestas más pequeñas que se pueden volver a recuperar si se pierde la conexión. Por otro lado, el método SearchStream transmite todo el conjunto de resultados en una sola respuesta, lo que puede ser más eficiente para la recuperación de datos masivos.
Tanto Search como SearchStream usan la misma URL base:
https://searchAds360.googleapis.com/v0/customers/CUSTOMER_ID/searchAds360
El método de búsqueda basado en páginas toma un parámetro pageSize opcional que limita la cantidad de resultados que se devuelven en una sola respuesta de la 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'" }
Si hay más filas en los resultados que pageSize, se devuelve un nextPageToken en la respuesta:
{ "results": [ // ... // ... // ... ], "nextPageToken": "CPii5aS87vfFTBAKGJvk36qpLiIWUW5SZk8xa1JPaXJVdXdIR05JUUpxZyoCVjMwADjUBkD___________8B", "fieldMask": "adGroupCriterion.keyword.text,adGroupCriterion.status" }
Si repites la misma búsqueda y agregas un pageToken con el valor anterior, se recuperará la siguiente página de resultados:
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" }
Para usar el método SearchStream, que devuelve todos los resultados en una sola respuesta transmitida, simplemente cambia el método de servicio en la URL a searchStream (pageSize y pageToken no son necesarios para 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'" }