खास जानकारी

Curation Partners API का इस्तेमाल करके, डेटा सेगमेंट बनाए और मैनेज किए जा सकते हैं. इस एपीआई में, curators.dataSegments रिसोर्स उपलब्ध होता है. यह REST API है. इसमें जनरेट की गई क्लाइंट लाइब्रेरी शामिल होती हैं. इनका इस्तेमाल इंटिग्रेशन के लिए किया जा सकता है .

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

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

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

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

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

    1. खोज बॉक्स में जाकर, Curation Partners API खोजें.
    2. नतीजों वाले पेज पर, Curation Partners API चुनें.
    3. चालू करें पर क्लिक करें.

    यह एक जानी-मानी समस्या है कि Google Cloud Console के खोज बॉक्स में, Curation Partners API नहीं मिल पाता. इसके बजाय, एपीआई को चालू करने के लिए Google Cloud CLI का इस्तेमाल किया जा सकता है. gcloud CLI इंस्टॉल करने के बाद, Curation Partners API को इस कमांड से चालू किया जा सकता है:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

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

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

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

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

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

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

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

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

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

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

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

एपीआई के स्कोप

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

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

Curation Partners API में, डेटा सेगमेंट की पहचान एपीआई के लिए खास रिसोर्स नाम से की जाती है. जैसे:

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

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

अगले चरण