Method: adPlays.createWithExternalIds

Membuat pemutaran iklan dengan ID eksternal.

  • Menampilkan pemutaran iklan yang baru dibuat jika berhasil.
  • Menampilkan kode error INVALID_ARGUMENT jika ID eksternal unit iklan, ID eksternal pesanan, ID eksternal baris, atau ID eksternal aset materi iklan tidak valid.
  • Menampilkan kode error INVALID_ARGUMENT jika pemutaran iklan untuk unit iklan, pesanan, baris, dan materi iklan yang sama dengan startTime yang sama sudah ada.
  • Menampilkan kode error NOT_FOUND jika tidak ditemukan ID eksternal unit iklan yang cocok, ID eksternal pesanan, ID eksternal baris, atau ID eksternal aset materi iklan.

Permintaan HTTP

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

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
Kolom
lineExternalId

string

Wajib diisi. ID eksternal dari baris yang memiliki pemutaran iklan ini. Format: 123.
orderExternalId

string

Wajib diisi. ID eksternal dari urutan pemutaran iklan ini. Format: 456.
adUnitExternalId

string

Wajib diisi. ID eksternal unit iklan tempat pemutaran iklan ini ditayangkan. Format: 789.
creativeAssetExternalId

string

Wajib diisi. ID eksternal materi iklan yang ditayangkan pemutaran iklan ini. Format: 3210.
startTime

string (Timestamp format)

Wajib diisi. Waktu saat iklan mulai diputar (inklusif). Harus sudah berlalu dan dalam 3 hari terakhir.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

Wajib diisi. Waktu pemutaran iklan berakhir (eksklusif). Harus pada waktu lampau dan setelah waktu mulai.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

Opsional. Waktu pemutaran iklan ini direkam. Harus berada di waktu lampau dan setelah waktu berakhir.

Stempel waktu dalam RFC3339 UTC "Zulu" , dengan resolusi nanodetik dan hingga sembilan digit pecahan. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".
impressions

number

Wajib diisi. Total jumlah tayangan.

Isi respons

Jika berhasil, isi respons memuat instance AdPlay.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.