Method: lookupByExternalId

يسترد جميع الكيانات حسب رقم التعريف الخارجي الوارد في الطلب.

  • تعرض رمز الخطأ NOT_FOUND إذا لم تتطابق أي أرقام تعريف مع مادة عرض.
  • تعرض رمز الخطأ FAILED_PRECONDITION إذا تم العثور على كيانات متعددة بالمعرِّف الخارجي نفسه.

طلب HTTP

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

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "lineExternalIds": [
    string
  ],
  "orderExternalIds": [
    string
  ],
  "productExternalIds": [
    string
  ],
  "adUnitExternalIds": [
    string
  ],
  "creativeAssetsExternalIds": [
    string
  ],
  "assignmentsExternalIds": [
    string
  ]
}
الحقول
lineExternalIds[]

string

المعرّفات الخارجية لجلب الأسماء لها من جدول Lines.
orderExternalIds[]

string

المعرّفات الخارجية لجلب الأسماء لها من جدول الطلبات.
productExternalIds[]

string

المعرّفات الخارجية لاسترجاع أسمائها من جدول "المنتجات"
adUnitExternalIds[]

string

أرقام التعريف الخارجية المطلوب استرجاع أسمائها من جدول الوحدات الإعلانية.
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.