खास जानकारी

Authorized Buyers Marketplace API का इस्तेमाल करके, डेटा सेगमेंट बनाए और मैनेज किए जा सकते हैं. यह एपीआई, curators.dataSegments रिसॉर्स को दिखाता है. यह एक REST API है. इसमें जनरेट की गई क्लाइंट लाइब्रेरी होती हैं, जिनका इस्तेमाल इंटिग्रेशन के लिए किया जा सकता है.

पुष्टि करने की सुविधा सेट अप करना

Google API, पुष्टि करने और अनुमति देने के लिए OAuth 2.0 प्रोटोकॉल का इस्तेमाल करते हैं. Marketplace API को ऐक्सेस करने के लिए, सेवा खाता सेट अप करने का तरीका यहां बताया गया है.

  1. अगर आपने अब तक ऐसा नहीं किया है, तो Google Cloud प्रोजेक्ट बनाएं. इसमें एपीआई को ऐक्सेस करने के लिए इस्तेमाल किए जाने वाले क्रेडेंशियल सेव किए जाते हैं.

  2. Google Cloud Console में चालू किए गए एपीआई वाले पेज पर जाएं. पहले से बनाया गया प्रोजेक्ट चुनें.

  3. आपको चालू किए गए एपीआई और सेवाओं की सूची दिखेगी. Marketplace API को ऐक्सेस करने के लिए, आपको इसे चालू करना होगा. अगर Marketplace API चालू नहीं है, तो +एपीआई और सेवाएं चालू करें पर क्लिक करें. इसके बाद, यह तरीका अपनाएं:

    1. आपको खोज बॉक्स वाले पेज पर रीडायरेक्ट किया जाता है. Authorized Buyers Marketplace API खोजें.
    2. नतीजे वाले पेज पर, Authorized Buyers Marketplace API को चुनें.
    3. चालू करें पर क्लिक करें.

  4. नेविगेशन मेन्यू में, क्रेडेंशियल को चुनें.

  5. +क्रेडेंशियल बनाएं पर क्लिक करें. इसके बाद, ड्रॉप-डाउन मेन्यू में सेवा खाता चुनें.

  6. सेवा खाते के लिए नाम डालें. सेवा खाता आईडी, खाता बनाते समय अपने-आप बन जाता है. इस वैल्यू को नोट कर लें, क्योंकि इसकी ज़रूरत आपको बाद में 14वें चरण में पड़ेगी. जानकारी डालें. हालांकि, ऐसा करना ज़रूरी नहीं है. बनाएं और जारी रखें पर क्लिक करें.

  7. सेवा खाते के लिए अनुमतियां कॉन्फ़िगर करें. यह ज़रूरी नहीं है. इसके बाद, जारी रखें पर क्लिक करें.

  8. वैकल्पिक रूप से, उन उपयोगकर्ताओं या ग्रुप को कॉन्फ़िगर करें जो सेवा खाते के तौर पर कार्रवाइयां कर सकते हैं. इसके बाद, हो गया पर क्लिक करें.

  9. आपका नया सेवा खाता, सेवा खाते में दिखता है. अभी बनाए गए सेवा खाते का आईडी ढूंढें और उस पर क्लिक करें.

  10. कुंजियां टैब पर क्लिक करें.

  11. कुंजी जोड़ें ड्रॉप-डाउन मेन्यू में, नई कुंजी बनाएं चुनें.

  12. कुंजी का टाइप के तौर पर JSON चुनें. इसके बाद, बनाएं पर क्लिक करें.

  13. कुंजी को अपनी वर्किंग डायरेक्ट्री में डाउनलोड करें. अपनी कुंजी को सुरक्षित तरीके से सेव करने के बारे में ज़्यादा जानने के लिए, सेवा खाते की कुंजियां मैनेज करना लेख पढ़ें. इस कुंजी का इस्तेमाल, आपका ऐप्लिकेशन एपीआई कॉल करने के लिए करता है.

  14. अपने सेवा खाते को अपने खाते से लिंक करने के लिए, सेवा खाते का आईडी अपने तकनीकी खाता मैनेजर के साथ शेयर करें.

एपीआई स्कोप

एपीआई कॉल करने के लिए इस्तेमाल किया जाने वाला ऐक्सेस टोकन पाने के लिए, OAuth 2.0 फ़्लो का इस्तेमाल करते समय, आपको उन एपीआई के बारे में बताना होगा जिन्हें उस टोकन का इस्तेमाल करके ऐक्सेस किया जा सकता है. Authorized Buyers Marketplace API के लिए, यह स्कोप https://www.googleapis.com/auth/authorized-buyers-marketplace है.

एपीआई और रीयल-टाइम में कॉन्टेंट को व्यवस्थित करने की सुविधा में डेटा सेगमेंट की पहचान कैसे करें

Marketplace API में, डेटा सेगमेंट की पहचान एपीआई के लिए खास तौर पर बनाए गए नाम वाले संसाधन से की जाती है. जैसे:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

रीयल-टाइम क्युरेशन में, विज्ञापन दिखाने के लिए काम के डेटा सेगमेंट की पहचान करते समय, API के इस्तेमाल किए गए पूरे संसाधन name के बजाय, DATA_SEGMENT_ID संसाधन आईडी की वैल्यू डालें.

अगले चरण