La nueva API de informes de Search Ads 360 ya está disponible. Únete al grupo de Google
searchads-api-announcements para mantenerte al tanto de las próximas mejoras y lanzamientos.
Method: searchAds360Fields.search
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Solicitud HTTP
POST https://searchads360.googleapis.com/v0/searchAds360Fields:search
La URL usa la sintaxis de la transcodificación gRPC.
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
| Representación JSON |
{
"query": string,
"pageToken": string,
"pageSize": integer
} |
| Campos |
query |
string
Obligatorio. Es la cadena de consulta.
|
pageToken |
string
Es el token de la página que se recuperará. Si no se especifica, se mostrará la primera página de resultados. Usa el valor obtenido de nextPageToken en la respuesta anterior para solicitar la siguiente página de resultados.
|
pageSize |
integer
Es la cantidad de elementos que se recuperarán en una sola página. Cuando se solicita una página demasiado grande, el servidor puede decidir limitar aún más la cantidad de recursos que se muestran.
|
Cuerpo de la respuesta
Mensaje de respuesta para SearchAds360FieldService.SearchSearchAds360Fields.
Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:
| Representación JSON |
{
"results": [
{
object (SearchAds360Field)
}
],
"nextPageToken": string,
"totalResultsCount": string
} |
| Campos |
results[] |
object (SearchAds360Field)
Es la lista de campos que coincidieron con la consulta.
|
nextPageToken |
string
Es el token de paginación que se usa para recuperar la siguiente página de resultados. Pasa el contenido de esta cadena como el atributo pageToken de la siguiente solicitud. No se muestra nextPageToken para la última página.
|
totalResultsCount |
string (int64 format)
Es la cantidad total de resultados que coinciden con la consulta, sin tener en cuenta la cláusula LIMIT.
|
Alcances de autorización
Requiere el siguiente alcance de OAuth:
https://www.googleapis.com/auth/doubleclicksearch
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-04-02 (UTC)
[null,null,["Última actualización: 2025-04-02 (UTC)"],[[["\u003cp\u003eSearch and retrieve SearchAds360 fields that match a specific query using the provided endpoint.\u003c/p\u003e\n"],["\u003cp\u003eRequests can specify query parameters for filtering, pagination, and the number of results to return.\u003c/p\u003e\n"],["\u003cp\u003eResponses include a list of matching fields, pagination information, and the total number of results.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization requires the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003ePotential errors include AuthenticationError, AuthorizationError, HeaderError, InternalError, QueryError, QuotaError, and RequestError.\u003c/p\u003e\n"]]],["This document details how to search for fields using the Search Ads 360 API. A `POST` request is sent to `https://searchads360.googleapis.com/v0/searchAds360Fields:search`, including a JSON body with a `query` string, optional `pageToken`, and `pageSize`. The response includes a list of matching field `results`, a `nextPageToken` for pagination, and a `totalResultsCount`. This operation requires the `https://www.googleapis.com/auth/doubleclicksearch` OAuth scope. Several errors such as `AuthenticationError` and `QuotaError` can be thrown.\n"],null,["# Method: searchAds360Fields.search\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.SearchSearchAds360FieldsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n\nReturns all fields that match the search [query](/search-ads/reporting/concepts/field-service#use_a_query_to_get_field_details).\n\nList of thrown errors: [AuthenticationError]() [AuthorizationError]() [HeaderError]() [InternalError]() [QueryError]() [QuotaError]() [RequestError]()\n\n### HTTP request\n\n`POST https://searchads360.googleapis.com/v0/searchAds360Fields:search`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------|\n| ``` { \"query\": string, \"pageToken\": string, \"pageSize\": integer } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `query` | `string` Required. The query string. |\n| `pageToken` | `string` Token of the page to retrieve. If not specified, the first page of results will be returned. Use the value obtained from `nextPageToken` in the previous response in order to request the next page of results. |\n| `pageSize` | `integer` Number of elements to retrieve in a single page. When too large a page is requested, the server may decide to further limit the number of returned resources. |\n\n### Response body\n\nResponse message for [SearchAds360FieldService.SearchSearchAds360Fields](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields/search#google.ads.searchads360.v0.services.SearchAds360FieldService.SearchSearchAds360Fields).\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"results\": [ { object (/search-ads/reporting/api/reference/rest/v0/searchAds360Fields#SearchAds360Field) } ], \"nextPageToken\": string, \"totalResultsCount\": string } ``` |\n\n| Fields ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `results[]` | `object (`[SearchAds360Field](/search-ads/reporting/api/reference/rest/v0/searchAds360Fields#SearchAds360Field)`)` The list of fields that matched the query. |\n| `nextPageToken` | `string` Pagination token used to retrieve the next page of results. Pass the content of this string as the `pageToken` attribute of the next request. `nextPageToken` is not returned for the last page. |\n| `totalResultsCount` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Total number of results that match the query ignoring the LIMIT clause. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/doubleclicksearch`"]]
