Conversion: update
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Actualiza un lote de conversiones en DoubleClick Search.
Pruébalo ahora.
Solicitud
Solicitud HTTP
PUT https://www.googleapis.com/doubleclicksearch/v2/conversion
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
En el cuerpo de la solicitud, proporciona un Recurso de conversión con las siguientes propiedades:
| Nombre de la propiedad |
Valor |
Descripción |
Notas |
| Propiedades opcionales |
conversion[].currencyCode |
string |
El código de moneda de los ingresos de la conversión. Debe estar en formato alfabético ISO 4217 (3 caracteres). |
admite escritura
|
conversion[].quantityMillis |
long |
La cantidad de esta conversión, en milésimas de segundo. |
admite escritura
|
conversion[].revenueMicros |
long |
El importe de los ingresos de esta conversión de TRANSACTION, en micros (valor multiplicado por 1,000,000, sin decimal). Por ejemplo, para especificar un valor de ingresos de "10" ingresa "10,000,000" (diez millones) en la solicitud. |
admite escritura
|
conversion[].state |
string |
El estado de la conversión, es decir, ACTIVE o REMOVED Nota: El estado DELETED dejó de estar disponible.
Los valores aceptables son los siguientes:
- "
ACTIVE"
- "
DELETED": (obsoleto)
- "
REMOVED"
|
admite escritura
|
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\u003eUpdates a batch of conversions in DoubleClick Search using the \u003ccode\u003ePUT\u003c/code\u003e method.\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\u003eThe request body should contain a Conversion resource with properties like \u003ccode\u003ecurrencyCode\u003c/code\u003e, \u003ccode\u003equantityMillis\u003c/code\u003e, \u003ccode\u003erevenueMicros\u003c/code\u003e, and \u003ccode\u003estate\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eSuccessful requests return a Conversion resource in the response body.\u003c/p\u003e\n"]]],["This outlines how to update conversions in DoubleClick Search via a PUT request to `https://www.googleapis.com/doubleclicksearch/v2/conversion`, requiring `https://www.googleapis.com/auth/doubleclicksearch` authorization. The request body should include a Conversion resource with optional properties like `currencyCode`, `quantityMillis`, `revenueMicros`, and `state` (either `ACTIVE` or `REMOVED`). Successful requests return a Conversion resource.\n"],null,["# Conversion: update\n\n| **Note:** Requires [authorization](#auth).\n\nUpdates a batch of conversions in DoubleClick Search.\n[Try it now](#try-it).\n\nRequest\n-------\n\n### HTTP request\n\n```\nPUT https://www.googleapis.com/doubleclicksearch/v2/conversion\n```\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\nIn the request body, supply a [Conversion resource](/search-ads/v2/reference/conversion#resource) with the following properties:\n\n| Property name | Value | Description | Notes |\n|-------------------------------|----------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|----------|\n| **Optional Properties** ||||\n| conversion[].`currencyCode` | `string` | The currency code for the conversion's revenue. Should be in ISO 4217 alphabetic (3-char) format. | writable |\n| conversion[].`quantityMillis` | `long` | The quantity of this conversion, in millis. | writable |\n| conversion[].`revenueMicros` | `long` | The revenue amount of this `TRANSACTION` conversion, in micros (value multiplied by 1000000, no decimal). For example, to specify a revenue value of \"10\" enter \"10000000\" (10 million) in your request. | writable |\n| conversion[].`state` | `string` | The state of the conversion, that is, either `ACTIVE` or `REMOVED`. Note: state DELETED is deprecated. \u003cbr /\u003e Acceptable values are: - \"`ACTIVE`\" - \"`DELETED`\": (Deprecated) - \"`REMOVED`\" | writable |\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.update)."]]
