ReachPlanService को किए गए अनुरोधों में, मंज़ूरी पा चुका डेवलपर टोकन, OAuth क्रेडेंशियल, और ऐसा ग्राहक आईडी देना ज़रूरी है जिसे आपके OAuth क्रेडेंशियल ऐक्सेस कर सकें.
इस गाइड में, ReachPlanService के लिए पुष्टि करने से जुड़ी जानकारी दी गई है. अगर आपने अब तक ऐसा नहीं किया है, तो सबसे पहले शुरू करें में दिए गए चरणों को पूरा करें. इसके बाद, इस पर वापस आएं.
डेवलपर टोकन और OAuth क्रेडेंशियल
शुरू करें में दी गई सलाह के अलावा, इन बातों का भी ध्यान रखें:
ReachPlanServiceसे कनेक्ट करने के लिए, आपके डेवलपर टोकन को सही अनुमति वाली सूची में जोड़ा जाना चाहिए. भले ही, इसे Google Ads API की अन्य सेवाओं के साथ इस्तेमाल करने की अनुमति पहले ही मिल चुकी हो. ज़्यादा जानकारी के लिए, ज़रूरी शर्तें देखें.- Google Ads API से कनेक्ट करने के लिए, आपको Google Ads API की सेवा की शर्तें स्वीकार करनी होंगी.
- OAuth रीफ़्रेश टोकन का मालिक यह तय करता है कि
ReachPlanServiceमें किन ग्राहक आईडी के लिए क्वेरी की जा सकती है. इससे आपके इंटिग्रेशन के बारे में जानकारी मिलती है. इसके बारे में ज़्यादा जानकारी यहां दी गई है.
ग्राहक आईडी:
Google Ads API की ज़्यादातर सेवाएं, कुछ खास Google Ads खातों और कैंपेन पर काम करती हैं. इसलिए, ज़्यादातर अनुरोधों के लिए, आपको इन दोनों की ज़रूरत होगी: पहला, ग्राहक आईडी. इससे उस खाते की पहचान की जा सकेगी जिसे मैनेज किया जा रहा है या जिसके बारे में क्वेरी की जा रही है. दूसरा, OAuth क्रेडेंशियल. इससे यह पुष्टि की जा सकेगी कि आपके पास उस ग्राहक आईडी को ऐक्सेस करने की अनुमति है. हालांकि, ReachPlanService
का इस्तेमाल वीडियो प्लान करने से जुड़ी गतिविधियों के लिए किया जाता है. ये गतिविधियां, उस ग्राहक आईडी के बारे में पता चलने से पहले हो सकती हैं जिसके लिए आपको कैंपेन चलाना है.
अंदरूनी टूल
अगर आपको अपने संगठन में इस्तेमाल करने के लिए टूल बनाने हैं, तो यहां हमारे सुझाव दिए गए हैं.
ऐसे प्लानर जिनके पास क्लाइंट खाते का सीधा ऐक्सेस नहीं है
अगर आपके प्लानर के पास आपके क्लाइंट के Google Ads खातों का ऐक्सेस नहीं है, तो इंस्टॉल किए गए ऐप्लिकेशन के फ़्लो का इस्तेमाल करके, OAuth क्रेडेंशियल जनरेट करें. ऐसा उस उपयोगकर्ता के लिए करें जिसके पास आपके डेवलपर टोकन के मैनेजर खाते का ऐक्सेस है. इसके बाद, आपकी टूल का इस्तेमाल करने वाली हर टीम के लिए, Google Ads खाता बनाएं या पाएं. साथ ही, उन्हें अपने मैनेजर खाते से लिंक करें. ReachPlanService से अनुरोध करते समय, उपयोगकर्ता की टीम से जुड़ा ग्राहक आईडी दें.
क्लाइंट खाते का ऐक्सेस रखने वाले प्लानर
अगर आपके प्लानर के पास ऐसे Google Ads मैनेजर खाते का ऐक्सेस है जो आपके क्लाइंट के खातों को मैनेज करता है, तो वेब ऐप्लिकेशन फ़्लो लागू करें. इससे आपका ऐप्लिकेशन, आपके प्लानर के OAuth क्रेडेंशियल का इस्तेमाल कर पाएगा. इसके बाद, अपने प्लान के ग्राहक से जुड़ा ग्राहक आईडी पास किया जा सकता है.
बाहरी टूल
अगर आपको बाहरी उपयोगकर्ताओं के लिए कोई टूल बनाना है, तो हमारा सुझाव है कि आप इसी तरह के तरीके अपनाएं:
हर क्लाइंट खाते के हिसाब से
इंस्टॉल किए गए ऐप्लिकेशन के फ़्लो का इस्तेमाल करके, उस उपयोगकर्ता के लिए OAuth क्रेडेंशियल जनरेट करें जिसके पास आपके डेवलपर टोकन के मैनेजर खाते का ऐक्सेस है. हर बाहरी क्लाइंट के लिए एक Google Ads खाता बनाएं और उन्हें अपने मैनेजर खाते से लिंक करें. इसके बाद, अपने टूल को कॉन्फ़िगर करें, ताकि प्लान जनरेट करते समय क्लाइंट को उससे जुड़ा ग्राहक आईडी मिल सके.
उपयोगकर्ता ने ऐक्सेस दिया है
अपने उपयोगकर्ताओं को यह सुविधा दें कि वे वेब ऐप्लिकेशन फ़्लो का इस्तेमाल करके, आपके टूल को अपने खातों का ऐक्सेस दे सकें. जब कोई उपयोगकर्ता अनुमति दे देता है, तो CustomerService का इस्तेमाल करके, उसे उन Google Ads खातों की सूची दिखाएं जिन्हें वह ऐक्सेस कर सकता है.
इसका मकसद यह पक्का करना है कि प्लानर को ReachPlanService का इस्तेमाल करते समय, कम से कम मुश्किलों का सामना करना पड़े. एपीआई को इंटिग्रेट करने से पहले, अपनी स्थिति के हिसाब से इन दो तरीकों में से कोई एक चुनें. साथ ही, टेस्ट करने के लिए कुछ ग्राहक आईडी चुनें. अगर आपको कोई शक है, तो अपने टूल टाइप के लिए सुझाए गए पहले तरीके का इस्तेमाल करें.
आगे क्या करना है
मीडिया प्लान तय करने का तरीका जानें.