Method: lookupByExternalId

Mengambil semua entity berdasarkan ID eksternal yang tercantum dalam permintaan.

  • Menampilkan kode error NOT_FOUND jika ID tidak cocok dengan aset.
  • Menampilkan kode error FAILED_PRECONDITION jika ditemukan beberapa entity dengan ID eksternal yang sama.

Permintaan HTTP

POST https://dv360outofhomeseller.googleapis.com/v1beta1:lookupByExternalId

URL menggunakan sintaksis gRPC Transcoding.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Kolom
lineExternalIds[]

string

ID eksternal untuk mengambil nama dari tabel Lines.
orderExternalIds[]

string

ID eksternal untuk mengambil nama dari tabel Pesanan.
productExternalIds[]

string

ID eksternal untuk mengambil nama dari tabel Produk.
adUnitExternalIds[]

string

ID eksternal untuk mengambil nama dari tabel AdUnits.
creativeAssetsExternalIds[]

string

ID eksternal yang akan diambil nama dari tabel CreativeAsset.
assignmentsExternalIds[]

string

ID eksternal yang akan diambil namanya dari tabel Tugas.

Isi respons

Jika berhasil, isi respons memuat data dengan struktur berikut:

Representasi JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Kolom
lines

map (key: string, value: string)

Peta ID eksternal ke nama baris.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Peta ID eksternal untuk mengurutkan nama.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Peta ID eksternal ke nama produk.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Peta ID eksternal ke nama unit iklan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Peta ID eksternal ke nama aset materi iklan.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Peta ID eksternal ke nama tugas.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut:

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

Untuk informasi selengkapnya, lihat Ringkasan OAuth 2.0.