Method: adPlays.createWithExternalIds

Crea una reproducción de anuncios con IDs externos.

  • Devuelve la reproducción del anuncio creada recientemente si se realizó correctamente.
  • Muestra el código de error INVALID_ARGUMENT si se especifican un ID externo de la unidad de anuncios, un ID externo de pedido, un ID externo de línea o un ID externo del elemento de creatividad.
  • Muestra el código de error INVALID_ARGUMENT si ya existe un anuncio para la misma unidad de anuncios, pedido, línea y creatividad con el mismo startTime.
  • Muestra el código de error NOT_FOUND si no se encontró ningún ID externo de unidad de anuncios, ID externo de pedido, ID externo de línea ni ID externo de elemento de creatividad.

Solicitud HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

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 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Campos
lineExternalId

string

Obligatorio. Es el ID externo de la línea a la que pertenece esta reproducción de anuncios. Formato: 123.
orderExternalId

string

Obligatorio. Es el ID externo del pedido al que pertenece esta reproducción de anuncios. Formato: 456.
adUnitExternalId

string

Obligatorio. Es el ID externo de la unidad de anuncios en la que se publicó esta reproducción de anuncios. Formato: 789.
creativeAssetExternalId

string

Obligatorio. Es el ID externo de la creatividad que publicó esta reproducción de anuncios. Formato: 3210.
startTime

string (Timestamp format)

Obligatorio. Hora en la que el anuncio comenzó a reproducirse (incluido). Debe ser en el pasado y estar dentro de los últimos 3 días.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Obligatorio. Hora en que finalizó la reproducción del anuncio (exclusivo). Debe ser una hora en el pasado y una fecha posterior a la hora de inicio.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

Opcional. Hora en la que se grabó esta reproducción de anuncio. Debe ser una hora en el pasado y una hora de finalización posterior.

Una marca de tiempo en formato RFC3339 UTC “Zulú”, con una resolución de nanosegundos y hasta nueve dígitos fraccionarios. Ejemplos: "2014-10-02T15:01:23Z" y "2014-10-02T15:01:23.045123456Z".
impressions

number

Obligatorio. Indica la cantidad total de impresiones.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de AdPlay.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

  • https://www.googleapis.com/auth/doubleclickbidmanager

Para obtener más información, consulta la descripción general de OAuth 2.0.