बैकग्राउंड

पुष्टि की प्रक्रिया शुरू करने से पहले

  1. अपने खाता प्रतिनिधि से उन खातों के लिए सही अनुमतियां सेट अप करने के लिए कहें जिन्हें आपका ऐप्लिकेशन ऐक्सेस करेगा.
  2. अगर आपको Authorized Buyers के कॉन्सेप्ट के बारे में कुछ नहीं पता है, तो Authorized Buyers सहायता केंद्र पर जाएं और यूज़र इंटरफ़ेस के साथ प्रयोग करें. अगर आपके ऐप्लिकेशन से रीयल-टाइम बिडिंग की उम्मीद की जाती है, तो आरटीबी प्रोटोकॉल का दस्तावेज़ पढ़ें.
  3. नया प्रोजेक्ट सेट अप करने के लिए, एपीआई कंसोल पर जाएं. अपने डेवलपर 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 API में, क्लाइंट 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 एचटीटीपी कार्रवाइयों पर मैप करते हैं, जैसा कि एपीआई ऑपरेशन में बताया गया है.

एपीआई यूआरआई के लिए खास फ़ॉर्मैट ये हैं:

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 देखें.