Conversion: get
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Recupera una lista de conversiones de una cuenta de motor de DoubleClick Search.
Pruébalo ahora.
Solicitud
Solicitud HTTP
GET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion
Parámetros
| Nombre del parámetro |
Valor |
Descripción |
| Parámetros de ruta de acceso |
advertiserId |
long |
Es el ID numérico del anunciante.
|
agencyId |
long |
ID numérico de la agencia
|
engineAccountId |
long |
Es el ID numérico de la cuenta de motor.
|
| Parámetros de consulta obligatorios |
endDate |
integer |
Es la fecha más reciente (incluida) en la que se recuperarán las conversiones. El formato es aaaammdd.
Los valores aceptables son 20091101 a 99991231, ambos inclusive.
|
rowCount |
integer |
Es la cantidad de conversiones que se generan por llamada.
Los valores aceptables son 1 a 1000, ambos inclusive.
|
startDate |
integer |
Primera fecha (incluida) en la que se recuperarán las conversiones. El formato es aaaammdd.
Los valores aceptables son 20091101 a 99991231, ambos inclusive.
|
startRow |
unsigned integer |
El índice de inicio basado en 0 para recuperar resultados de conversiones.
|
| Parámetros de consulta opcionales |
adGroupId |
long |
Es el ID numérico del grupo de anuncios.
|
adId |
long |
Es el ID numérico del anuncio.
|
campaignId |
long |
Es el ID numérico de la campaña.
|
criterionId |
long |
Es el ID numérico del criterio.
|
Autorización
Esta solicitud requiere una autorización con el siguiente alcance:
| Alcance |
|---|
https://www.googleapis.com/auth/doubleclicksearch |
Para obtener más información, consulta la página de autenticación y autorización.
Cuerpo de la solicitud
No proporciones un cuerpo de la solicitud con este método.
Respuesta
Si se aplica correctamente, este método muestra un recurso de conversión en el cuerpo de la respuesta.
Pruébalo
Usa el Explorador de APIs que se muestra a continuación para llamar a este método en datos en vivo y ver la respuesta.
También puedes probar la
independiente
del navegador.
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: 2024-08-20 (UTC)
[null,null,["Última actualización: 2024-08-20 (UTC)"],[[["\u003cp\u003eRetrieves a list of conversions from a specified DoubleClick Search engine account within a given date range.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/doubleclicksearch\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eRequest parameters include specifying the agency, advertiser, engine account, date range, and result pagination.\u003c/p\u003e\n"],["\u003cp\u003eOptionally filter conversions by ad group, ad, campaign, or criterion IDs.\u003c/p\u003e\n"],["\u003cp\u003eResponse provides a Conversion resource containing details about the retrieved conversions.\u003c/p\u003e\n"]]],["This method retrieves conversions from a DoubleClick Search engine account. It requires authorization and uses a GET request with specific path and query parameters. Mandatory parameters include `agencyId`, `advertiserId`, `engineAccountId`, `endDate`, `rowCount`, `startDate`, and `startRow`. Optional parameters include `adGroupId`, `adId`, `campaignId`, and `criterionId`. The successful response contains a list of conversion resources. No request body is needed.\n"],null,["# Conversion: get\n\n| **Note:** Requires [authorization](#auth).\n\nRetrieves a list of conversions from a DoubleClick Search engine account.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nGET https://www.googleapis.com/doubleclicksearch/v2/agency/agencyId/advertiser/advertiserId/engine/engineAccountId/conversion\n```\n\n### Parameters\n\n| Parameter name | Value | Description |\n|-------------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------|\n| **Path parameters** |||\n| `advertiserId` | `long` | Numeric ID of the advertiser. |\n| `agencyId` | `long` | Numeric ID of the agency. |\n| `engineAccountId` | `long` | Numeric ID of the engine account. |\n| **Required query parameters** |||\n| `endDate` | `integer` | Last date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `rowCount` | `integer` | The number of conversions to return per call. Acceptable values are `1` to `1000`, inclusive. |\n| `startDate` | `integer` | First date (inclusive) on which to retrieve conversions. Format is yyyymmdd. Acceptable values are `20091101` to `99991231`, inclusive. |\n| `startRow` | `unsigned integer` | The 0-based starting index for retrieving conversions results. |\n| **Optional query parameters** |||\n| `adGroupId` | `long` | Numeric ID of the ad group. |\n| `adId` | `long` | Numeric ID of the ad. |\n| `campaignId` | `long` | Numeric ID of the campaign. |\n| `criterionId` | `long` | Numeric ID of the criterion. |\n\n### Authorization\n\nThis request requires authorization with the following scope:\n\n| Scope |\n|-----------------------------------------------------|\n| `https://www.googleapis.com/auth/doubleclicksearch` |\n\nFor more information, see the [authentication and authorization](/search-ads/v2/authorizing) page.\n\n### Request body\n\nDo not supply a request body with this method.\n\nResponse\n--------\n\nIf successful, this method returns a [Conversion resource](/search-ads/v2/reference/conversion#resource) in the response body.\n\nTry it!\n-------\n\n\nUse the APIs Explorer below to call this method on live data and see the response.\nAlternatively, try the\n[standalone\nExplorer](https://developers.google.com/apis-explorer/#p/doubleclicksearch/v2/doubleclicksearch.conversion.get)."]]
