Method: adPlays.createWithExternalIds

Cria uma reprodução de anúncios com IDs externos.

  • Retorna a reprodução do anúncio recém-criada, se for bem-sucedida.
  • Retorna o código de erro INVALID_ARGUMENT se os IDs externos do bloco de anúncios, do pedido, da linha ou do recurso do criativo inválidos forem especificados.
  • Retorna o código de erro INVALID_ARGUMENT caso uma reprodução de anúncio para o mesmo bloco de anúncios, pedido, linha e criativo com o mesmo startTime já exista.
  • Retorna o código de erro NOT_FOUND se nenhum código externo do bloco de anúncios, código externo do pedido, código externo da linha ou código externo do recurso do criativo correspondente foi encontrado.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Campos
lineExternalId

string

Obrigatório. O código externo da linha a que a reprodução de anúncios pertence. Formato: 123.
orderExternalId

string

Obrigatório. O código externo do pedido a que a reprodução de anúncios pertence. Formato: 456.
adUnitExternalId

string

Obrigatório. O ID externo do bloco de anúncios em que a reprodução de anúncios foi veiculada. Formato: 789.
creativeAssetExternalId

string

Obrigatório. O ID externo do criativo veiculado por esse anúncio. Formato: 3210.
startTime

string (Timestamp format)

Obrigatório. Hora em que o anúncio começou a ser reproduzido (inclusive). Precisa estar no passado e nos últimos 3 dias.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Obrigatório. Hora em que a reprodução do anúncio terminou (exclusivo). Precisa estar no passado e depois do horário de início.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

Opcional. Hora em que a reprodução do anúncio foi registrada. Precisa estar no passado e depois do horário de término.

Um carimbo de data/hora no formato RFC3339 UTC "Zulu", com resolução de nanossegundos e até nove dígitos fracionários. Exemplos: "2014-10-02T15:01:23Z" e "2014-10-02T15:01:23.045123456Z".
impressions

number

Obrigatório. Número total de impressões.

Corpo da resposta

Se a solicitação for bem-sucedida, o corpo da resposta conterá uma instância de AdPlay.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Para mais informações, consulte a Visão geral do OAuth 2.0.