Method: lookupByExternalId

İstekte listelenen harici kimliğe göre tüm varlıkları alır.

  • Herhangi bir kimlik bir öğeyle eşleşmezse NOT_FOUND hata kodunu döndürür.
  • Aynı harici kimliğe sahip birden çok varlık bulunursa FAILED_PRECONDITION hata kodunu döndürür.

HTTP isteği

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

URL, gRPC Kod Dönüştürme söz dizimini kullanır.

İstek içeriği

İstek gövdesi, aşağıdaki yapıya sahip verileri içerir:

JSON gösterimi 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
Alanlar
lineExternalIds[]

string

Adları Satırlar tablosundan getirilecek harici kimlikler.
orderExternalIds[]

string

Adları Siparişler tablosundan getirilecek harici kimlikler.
productExternalIds[]

string

Ürünler tablosundan isimleri getirilecek harici kimlikler.
adUnitExternalIds[]

string

Adı, AdUnits tablosundan getirilecek harici kimlikler.
creativeAssetsExternalIds[]

string

Adlarını CreativeAsset tablosundan getirilecek harici kimlikler.
assignmentsExternalIds[]

string

Adlarını Ödevler tablosundan getirilecek harici kimlikler.

Yanıt gövdesi

Başarılı olursa yanıt metni aşağıdaki yapıyla birlikte verileri içerir:

JSON gösterimi 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
Alanlar
lines

map (key: string, value: string)

Harici kimliklerin satır adlarıyla eşlemesi.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
orders

map (key: string, value: string)

Harici kimliklerin sipariş adlarıyla haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
products

map (key: string, value: string)

Harici kimliklerin ürün adlarıyla haritası.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
adUnits

map (key: string, value: string)

Harici kimliklerin reklam birimi adlarıyla eşlemesi.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
creativeAssets

map (key: string, value: string)

Harici kimliklerin reklam öğesi adlarıyla eşlemesi.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
assignments

map (key: string, value: string)

Harici kimliklerin atama adlarıyla eşlemesi.

"key": value çiftlerinin listesini içeren bir nesne. Örnek: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Yetkilendirme Kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

Daha fazla bilgi için OAuth 2.0 Overview (OAuth 2.0'a Genel Bakış) sayfasına göz atın.