बैकग्राउंड

शुरू करने से पहले

  1. अपने खाता प्रतिनिधि से, खातों के लिए सही अनुमतियां सेट अप करने के लिए कहें आपका ऐप्लिकेशन ऐक्सेस करेगा.
  2. अगर आपको Authorized Buyers के सिद्धांतों के बारे में जानकारी नहीं है, तो Authorized Buyers सहायता केंद्र और यूज़र इंटरफ़ेस के साथ प्रयोग करके देखें. अगर आपके ऐप्लिकेशन से रीयल-टाइम बिडिंग करने की उम्मीद है, तो RTB प्रोटोकॉल दस्तावेज़.
  3. YouTube Studio के एपीआई कंसोल नया प्रोजेक्ट सेट अप करें. अपने डेवलपर Google खाते में साइन इन करें या एक खाता बनाएं. इसके बाद, आपको एक प्रोजेक्ट बनाने और साइन ऑफ़ करने के लिए कहा जाएगा कुछ शर्तों को पूरा किया है.

माता-पिता और बच्चे के खाते

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

चाइल्ड खाते

चाइल्ड खाते का ऐक्सेस देने वाले क्रेडेंशियल वाला उपयोगकर्ता ही उनके खाते से जुड़े संसाधनों को देख सकता है और उनमें बदलाव कर सकता है. बच्चे के खातों का इस्तेमाल नहीं किया जा सकता चाइल्ड या पैरंट खातों से जुड़े संसाधनों को देखना या उनमें बदलाव करना.

अभिभावक के खाते

जिस उपयोगकर्ता के पास पैरंट खाते का ऐक्सेस देने वाले क्रेडेंशियल हैं वह देख सकता है और पैरंट खाते से जुड़े सभी संसाधनों के अलावा, पैरंट खाते के संसाधनों में बदलाव किया जा सकता है. चाइल्ड खाते. दिए गए सभी संसाधनों की सूची बनाने वाली कार्रवाइयों के लिए, यह उपयोगकर्ता को जवाब देते समय उनके खाते और उनके सभी खातों का डेटा शामिल होगा चाइल्ड खाते. ध्यान दें कि चाइल्ड सीट के लिए संसाधनों को टारगेट करने वाले अन्य तरह के अनुरोधों के लिए, पैरंट खाते को बच्चे के लिए, accountId पाथ पैरामीटर तय करना होगा खाते के बजाय, अपने accountId खाते से साइन इन करना होगा.

REST API का डेटा मॉडल

संसाधन, एक यूनीक आइडेंटिफ़ायर वाली व्यक्तिगत डेटा इकाई होता है. कॉन्टेंट बनाने खातों का संसाधन, Authorized Buyers खाते में की गई एंट्री को दिखाता है और इसका रूट होता है Ad Exchange Buyer API के लिए डेटा क्लास. एपीआई के तरीके व्यक्तिगत तौर पर खाता संसाधन, और खाता संसाधनों का संग्रह.

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

खातों के संसाधन और कलेक्शन के अलावा, Ad Exchange Buyer API इन डेटा स्ट्रक्चर के बारे में बताता है:

बिड करने वाले की जगह की जानकारी

बिड करने वाले की जगह की जानकारी, खाता संसाधन की मदद से लौटाए गए स्ट्रक्चर होते हैं वह यूआरएल दें जिस पर विज्ञापन एक्सचेंज को बोली अनुरोध भेजना चाहिए और विज्ञापन एक्सचेंज की तरफ़ से भेजे जाने वाले हर सेकंड के लिए क्वेरी की ज़्यादा से ज़्यादा संख्या. यहाँ है बिडिंग करने वाले की जगह का उदाहरण, जिसे JSON में दिखाया गया है: 

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

आइटम

आइटम में खातों की सूची होती है. यहां आइटम का एक उदाहरण दिया गया है, जिसकी जानकारी JSON में दी गई है: 

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

काम करने वाली कार्रवाइयां

आप चाहें, तो कलेक्शन और रिसॉर्स के लिए तीन अलग-अलग तरीकों का इस्तेमाल करें. Ad Exchange Buyer API नीचे दी गई टेबल में बताया गया है. सभी कार्रवाइयों के लिए ज़रूरी है अनुमति देना.

कार्रवाई ब्यौरा REST एचटीटीपी मैपिंग
list यह उन सभी खातों की सूची बनाता है जिन्हें ऐसे खाते से ऐक्सेस किया जा सकता है जिसको फ़िलहाल पुष्टि हुई है उपयोगकर्ता. संग्रह यूआरआई पर GET.
पाएं खातों के लिए खास संसाधन पाएं. संसाधन यूआरआई पर GET.
अपडेट करें किसी खाता संसाधन को अपडेट करता है. संसाधन यूआरआई पर PUT, जहां आप इसके लिए डेटा पास करते हैं अपडेट किया गया संसाधन.

कॉल करने का तरीका

REST, सॉफ़्टवेयर आर्किटेक्चर की एक स्टाइल है. यह डेटा का अनुरोध करने और उसमें बदलाव करने के लिए, आसान और एक जैसा तरीका उपलब्ध कराती है.

REST शब्द "रिप्रज़ेंटेशनल स्टेट ट्रांसफ़र" का छोटा रूप है. Google API के संदर्भ में, यह Google के सेव किए गए डेटा को दिखाने और उसमें बदलाव करने के लिए एचटीटीपी क्रियाओं का इस्तेमाल करता है.

RESTful सिस्टम में, संसाधनों को डेटा स्टोर में सेव किया जाता है; जब कोई क्लाइंट अनुरोध भेजता है कि सर्वर कोई खास कार्रवाई करता है (जैसे कि संसाधन बनाना, वापस पाना, अपडेट करना या मिटाना), तो सर्वर कार्रवाई करता है और रिस्पॉन्स भेजता है. यह रिस्पॉन्स, अक्सर बताए गए संसाधन के बारे में बताता है.

Google के RESTful एपीआई में, क्लाइंट एचटीटीपी कार्रवाई के बारे में बताता है, जैसे कि POST, GET, PUT या DELETE. यह ऐसे संसाधन के बारे में बताता है जो नीचे दिए गए फ़ॉर्म के, दुनिया भर में मौजूद यूनीक यूआरआई की मदद से मिलता है:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

सभी एपीआई संसाधनों में, एचटीटीपी से ऐक्सेस किए जा सकने वाले यूनीक यूआरआई होते हैं. इसलिए, REST डेटा कैश करने की सुविधा को चालू करती है. साथ ही, उसे वेब के डिस्ट्रिब्यूटेड इन्फ़्रास्ट्रक्चर के साथ काम करने के लिए ऑप्टिमाइज़ किया जाता है.

आपको एचटीटीपी 1.1 स्टैंडर्ड वाले दस्तावेज़ में तरीका की परिभाषाएं काम की लग सकती हैं; उनमें GET, POST, PUT, और DELETE के लिए खास जानकारी शामिल होती है.

Ad Exchange Buyer API में REST

साथ काम करने वाली कार्रवाइयां सीधे REST एचटीटीपी क्रियाओं से जुड़ी होती हैं, जैसा कि एपीआई से जुड़ी कार्रवाइयां.

API यूआरआई का खास फ़ॉर्मैट इस तरह से बनाया जाता है:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

जहां resourceID, खातों के संसाधन और parameters इनमें से कोई भी हैं पैरामीटर का इस्तेमाल करें. यहां जाएं: स्टैंडर्ड क्वेरी पैरामीटर और पहचान फ़ाइल के लिए दस्तावेज़ देखें.

resourceID पाथ एक्सटेंशन का फ़ॉर्मैट आपको उस संसाधन की पहचान करने देता है जिस पर आप अभी काम कर रहे हैं, उदाहरण के लिए:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

एपीआई में काम करने वाली हर कार्रवाई के लिए इस्तेमाल किए जाने वाले यूआरआई का पूरा सेट यह है इसमें कम शब्दों में जानकारी दी गई है: रेफ़रंस दस्तावेज़.

यहां एक उदाहरण दिया गया है, जिसमें बताया गया है कि Ad Exchange Buyer API में यह कैसे काम करता है.

पुष्टि किए गए उपयोगकर्ता खातों की सूची पाएं:

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

डेटा फ़ॉर्मैट

JSON

JSON (JavaScript ऑब्जेक्ट नोटेशन), आम तौर पर भाषा पर आधारित डेटा फ़ॉर्मैट है. यह आर्बिट्रेरी डेटा स्ट्रक्चर को टेक्स्ट में आसान तरीके से दिखाता है. ज़्यादा जानकारी के लिए, json.org पर जाएं.