Method: lookupByExternalId

अनुरोध में शामिल बाहरी आईडी की मदद से सभी इकाइयों को हासिल करता है.

  • अगर कोई आईडी किसी एसेट से मेल नहीं खाता है, तो गड़बड़ी का कोड NOT_FOUND दिखाता है.
  • अगर एक ही बाहरी आईडी वाली कई इकाइयां मिलती हैं, तो गड़बड़ी का कोड FAILED_PRECONDITION दिखाता है.

एचटीटीपी अनुरोध

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

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

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

Assignments टेबल से नाम फ़ेच करने के लिए बाहरी आईडी.

जवाब का मुख्य भाग

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

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 की खास जानकारी देखें.