Method: lookupByExternalId

همه موجودیت ها را با شناسه خارجی فهرست شده در درخواست بازیابی می کند.

  • اگر شناسه‌ها با دارایی مطابقت نداشته باشند، کد خطا NOT_FOUND را برمی‌گرداند.
  • اگر چندین نهاد با شناسه خارجی یکسان پیدا شود، کد خطا FAILED_PRECONDITION را برمی‌گرداند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
فیلدها
lineExternalIds[]

string

شناسه های خارجی برای واکشی نام از جدول خطوط.

orderExternalIds[]

string

شناسه های خارجی برای واکشی نام از جدول سفارشات.

productExternalIds[]

string

شناسه‌های خارجی برای واکشی نام از جدول محصولات.

adUnitExternalIds[]

string

شناسه های خارجی برای واکشی نام از جدول AdUnits.

creativeAssetsExternalIds[]

string

شناسه های خارجی برای واکشی نام از جدول CreativeAsset.

assignmentsExternalIds[]

string

شناسه های خارجی برای واکشی نام از جدول تکالیف.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON 
{
  "lines": {
    string: string,
    ...
  },
  "orders": {
    string: string,
    ...
  },
  "products": {
    string: string,
    ...
  },
  "adUnits": {
    string: string,
    ...
  },
  "creativeAssets": {
    string: string,
    ...
  },
  "assignments": {
    string: string,
    ...
  }
}
فیلدها
lines

map (key: string, value: string)

نقشه شناسه های خارجی به نام خطوط.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

orders

map (key: string, value: string)

نقشه شناسه های خارجی برای سفارش نام.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

products

map (key: string, value: string)

نقشه شناسه های خارجی به نام محصولات.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

adUnits

map (key: string, value: string)

نقشه شناسه های خارجی به نام واحدهای تبلیغاتی.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

creativeAssets

map (key: string, value: string)

نقشه شناسه های خارجی به نام دارایی های خلاق.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

assignments

map (key: string, value: string)

نقشه شناسه های خارجی به نام تکالیف.

یک شی حاوی لیستی از "key": value . مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" } .

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.