Authentication

ReachPlanService को किए जाने वाले अनुरोधों में, मंज़ूरी पा चुका डेवलपर टोकन, OAuth क्रेडेंशियल, और ऐसा कस्टमर आईडी शामिल होना चाहिए जिसे आपके OAuth क्रेडेंशियल ऐक्सेस कर सकें.

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

डेवलपर टोकन और OAuth क्रेडेंशियल

शुरू करें सेक्शन में दिए गए दिशा-निर्देशों के अलावा, इन बातों का भी ध्यान रखें:

  1. ReachPlanService से कनेक्ट करने के लिए, आपके डेवलपर टोकन को अनुमति वाली सूची में शामिल होना चाहिए. भले ही, उसे Google Ads API की अन्य सेवाओं के साथ इस्तेमाल करने की अनुमति पहले ही मिल चुकी हो. ज़्यादा जानकारी के लिए, ज़रूरी शर्तें देखें.
  2. Google Ads API से कनेक्ट करने के लिए, आपको Google Ads API की सेवा की शर्तें स्वीकार करनी होंगी.
  3. आपके OAuth रीफ़्रेश टोकन का मालिकाना हक रखने वाला उपयोगकर्ता यह तय करता है कि ReachPlanService में किन ग्राहक आईडी के लिए क्वेरी की जा सकती है. इससे आपके इंटिग्रेशन के बारे में जानकारी मिलती है. इस बारे में ज़्यादा जानकारी यहां दी गई है.

ग्राहक आईडी:

Google Ads API में मौजूद ज़्यादातर सेवाएं, खास Google Ads खातों और कैंपेन पर काम करती हैं. इसलिए, ज़्यादातर अनुरोधों के लिए, उस खाते की पहचान करने के लिए ग्राहक आईडी और OAuth क्रेडेंशियल, दोनों की ज़रूरत होती है जिसे मैनेज किया जा रहा है या जिसकी क्वेरी की जा रही है. साथ ही, इन क्रेडेंशियल के पास उस ग्राहक आईडी को ऐक्सेस करने की अनुमति होनी चाहिए. हालांकि, ReachPlanService का मतलब वीडियो प्लानिंग से जुड़ी उन गतिविधियों से है जो उस ग्राहक आईडी के बारे में जानने से पहले हो सकती हैं जहां आपको कैंपेन चलाना है.

अपने संगठन में इंटरनल इस्तेमाल के लिए टूल बनाने वाले पार्टनर के लिए, हम इनमें से किसी एक विकल्प का सुझाव देते हैं:

  1. अगर आपके प्लानर के पास आपके क्लाइंट के Google Ads खातों का ऐक्सेस नहीं है, तो: इंस्टॉल किए गए ऐप्लिकेशन के फ़्लो का इस्तेमाल करके, उस उपयोगकर्ता के लिए OAuth क्रेडेंशियल जनरेट करें जिसके पास आपके डेवलपर टोकन के मैनेजर खाते का ऐक्सेस है. इसके बाद, अपने टूल का इस्तेमाल करने वाली हर टीम के लिए Google Ads खाता बनाएं या हासिल करें. साथ ही, उन्हें अपने मैनेजर खाते से लिंक करें. ReachPlanService से अनुरोध करते समय, उपयोगकर्ता की टीम से जुड़ा ग्राहक आईडी दें.

  2. अगर आपके प्लानर के पास, आपके क्लाइंट खातों को मैनेज करने वाले Google Ads मैनेजर खाते का ऐक्सेस है, तो वेब ऐप्लिकेशन फ़्लो लागू करें. इससे आपके ऐप्लिकेशन को आपके प्लानर के OAuth क्रेडेंशियल इस्तेमाल करने की अनुमति मिल जाएगी. इसके बाद, अपने प्लान के ग्राहक से जुड़ा ग्राहक आईडी डाला जा सकता है.

संगठन से बाहर के उपयोगकर्ताओं के लिए टूल बनाने वाले पार्टनर के लिए, हम इन तरीकों का सुझाव देते हैं:

  1. इंस्टॉल किए गए ऐप्लिकेशन फ़्लो का इस्तेमाल करके, ऐसे उपयोगकर्ता के लिए OAuth क्रेडेंशियल जनरेट करें जिसके पास आपके डेवलपर टोकन के मैनेजर खाते का ऐक्सेस है. हर बाहरी क्लाइंट के लिए Google Ads खाता बनाएं और उन्हें अपने मैनेजर खाते से लिंक करें. इसके बाद, अपने टूल को कॉन्फ़िगर करें, ताकि क्लाइंट प्लान जनरेट करते समय, उससे जुड़ा ग्राहक आईडी दिया जा सके.

  2. वेब ऐप्लिकेशन फ़्लो का इस्तेमाल करके, अपने उपयोगकर्ताओं को अपने टूल को अपने खातों का ऐक्सेस देने की सुविधा दें. जब उपयोगकर्ता अनुमति दे दे, तो CustomerService का इस्तेमाल करके, उन Google Ads खातों की सूची दें जिन्हें वह ऐक्सेस कर सकता है.

इसका मकसद यह पक्का करना है कि प्लानर, ReachPlanService का इस्तेमाल करते समय कम से कम परेशानी का सामना करें. एपीआई को इंटिग्रेट करने से पहले, अपनी स्थिति के हिसाब से इनमें से कोई एक तरीका चुनें और टेस्ट करने के लिए कुछ ग्राहक आईडी की पहचान करें. अगर आपको कोई समस्या आ रही है, तो अपने टूल टाइप के लिए सुझाए गए पहले तरीके का इस्तेमाल करें.