Method: adPlays.createWithExternalIds

बाहरी आईडी के साथ विज्ञापन प्ले बनाता है.

  • सफल होने पर, नया विज्ञापन दिखाया जाता है.
  • अगर अमान्य विज्ञापन यूनिट का बाहरी आईडी, ऑर्डर का बाहरी आईडी, लाइन का बाहरी आईडी या क्रिएटिव एसेट का बाहरी आईडी दिया गया है, तो गड़बड़ी का कोड INVALID_ARGUMENT दिखाता है.
  • अगर कोई विज्ञापन एक ही विज्ञापन यूनिट, ऑर्डर, लाइन, और क्रिएटिव के लिए पहले से मौजूद है, तो गड़बड़ी का कोड INVALID_ARGUMENT दिखाता है.
  • अगर कोई मेल खाने वाली विज्ञापन यूनिट का बाहरी आईडी, ऑर्डर का बाहरी आईडी, लाइन का बाहरी आईडी या क्रिएटिव एसेट का बाहरी आईडी नहीं मिलता, तो गड़बड़ी का कोड NOT_FOUND दिखाता है.

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

POST https://dv360outofhomeseller.googleapis.com/v1beta1/adPlays:createWithExternalIds

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

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

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

JSON के काेड में दिखाना 
{
  "lineExternalId": string,
  "orderExternalId": string,
  "adUnitExternalId": string,
  "creativeAssetExternalId": string,
  "startTime": string,
  "endTime": string,
  "recordTime": string,
  "impressions": number
}
फ़ील्ड
lineExternalId

string

ज़रूरी है. यह विज्ञापन चलाने वाली लाइन का बाहरी आईडी है. फ़ॉर्मैट: 123.
orderExternalId

string

ज़रूरी है. इस विज्ञापन को चलाने के क्रम की बाहरी आईडी. फ़ॉर्मैट: 456.
adUnitExternalId

string

ज़रूरी है. उस विज्ञापन यूनिट का बाहरी आईडी जिस पर यह विज्ञापन दिखाया गया था. फ़ॉर्मैट: 789.
creativeAssetExternalId

string

ज़रूरी है. इस विज्ञापन को दिखाए जाने वाले क्रिएटिव का बाहरी आईडी. फ़ॉर्मैट: 3210.
startTime

string (Timestamp format)

ज़रूरी है. विज्ञापन चलना शुरू होने का समय (शामिल है). पिछले तीन दिन और पिछले तीन दिनों के अंदर की जानकारी होनी चाहिए.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
endTime

string (Timestamp format)

ज़रूरी है. विज्ञापन खत्म होने का समय (खास तौर पर). तारीख, शुरू होने के समय से पहले की और बाद की होनी चाहिए.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
recordTime

string (Timestamp format)

ज़रूरी नहीं. इस विज्ञापन को रिकॉर्ड किए जाने का समय. तारीख, खत्म होने के समय से पहले की और बाद की होनी चाहिए.

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
impressions

number

ज़रूरी है. इंप्रेशन की कुल संख्या.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में AdPlay का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.