Search Ads 360 एपीआई को पुष्टि करने के लिए, सभी अनुरोधों में OAuth 2.0 का ऐक्सेस टोकन डालना ज़रूरी है. टोकन जनरेट करने और उसे Search Ads 360 एपीआई को पास करने के लिए, किसी भी स्टैंडर्ड OAuth 2.0 पुष्टि वर्कफ़्लो का पालन करें. हमारा सुझाव है कि आप नीचे दिया गया वर्कफ़्लो इस्तेमाल करें, क्योंकि यह पूरी तरह से अपने-आप कन्वर्ज़न अपलोड और रिपोर्ट डाउनलोड करने के लिए सही है.
नीचे बताए गए वर्कफ़्लो के विकल्पों के लिए, इंस्टॉल किए गए ऐप्लिकेशन के लिए
OAuth 2.0 का इस्तेमाल करना या
सर्वर से सर्वर ऐप्लिकेशन के लिए OAuth 2.0 का इस्तेमाल करना देखें. अगर किसी दूसरे वर्कफ़्लो का इस्तेमाल किया जाता है,
तो OAuth 2.0 के ऑथराइज़ेशन कोड का अनुरोध करते समय,
scope पैरामीटर के तौर पर इस वैल्यू का इस्तेमाल करें:
https://www.googleapis.com/auth/doubleclicksearch
अगर आप सर्वर रूट के सर्वर को फ़ॉलो करते हैं, तो सेवा खाते को Search Ads 360 के उपयोगकर्ता के तौर पर जोड़ें.
अनुमति देने के लिए सुझाया गया वर्कफ़्लो
- Google API (एपीआई) कंसोल पर जाएं और अपना प्रोजेक्ट चुनें.
अगर आपने पहले से Google API Console प्रोजेक्ट और OAuth क्रेडेंशियल नहीं बनाए हैं, तो अपने क्लाइंट के लिए Google API कंसोल प्रोजेक्ट और OAuth क्रेडेंशियल बनाएं में दिए गए निर्देशों का पालन करें.
अपने प्रोजेक्ट का OAuth क्लाइंट आईडी और सीक्रेट ढूंढने के लिए, ये काम करें:
- क्रेडेंशियल पेज खोलें.
- नाम कॉलम में, अपने OAuth क्लाइंट के नाम पर क्लिक करें.
- पेज पर क्लाइंट आईडी और सीक्रेट की जानकारी मौजूद होती है.
- कोई वेब ब्राउज़र खोलें. इसके बाद, उस Google खाते से Google में साइन इन करें
जिसके पास Search Ads 360 में डेटा ऐक्सेस करने की अनुमति है.
इस Google खाते से, आपका एपीआई क्लाइंट, Search Ads 360 की पुष्टि करेगा. अगर Google खाते का मालिक आपकी कंपनी को छोड़ देता है और आप खाते से Search Ads 360 का ऐक्सेस हटा देते हैं, तो आपको इस अनुमति वर्कफ़्लो को दोहराना होगा और एक अलग Google खाता तय करना होगा.
- Search Ads 360 के इस्तेमाल से जुड़ी स्क्रिप्ट लागू करके, रीफ़्रेश टोकन पाएं:
sa360Api.py --loginस्क्रिप्ट आपको OAuth टोकन पाने की प्रक्रिया और रीफ़्रेश टोकन पाने के सीक्रेट की जानकारी देती है. रीफ़्रेश टोकन सिर्फ़ उसी Google खाते के लिए मान्य होता है जिसमें आपने पिछले चरण के दौरान साइन इन किया था.
इस प्रोसेस के तहत, स्क्रिप्ट एक यूआरएल जनरेट करती है. साथ ही, आपको वेब ब्राउज़र में, यूआरएल पर जाने का निर्देश देती है.
-
जब ब्राउज़र आपसे OAuth क्लाइंट को Search Ads 360 के डेटा का ऐक्सेस देने के लिए कहे, तो पक्का करें कि आपने जिस Google खाते से साइन इन किया था वह आपको दिखे. (अगर आपने एक से ज़्यादा Google खातों में साइन इन किया हुआ है, तो हो सकता है कि आपको अलग खाता दिखाया जाए.)
प्रोसेस के आखिर में,
sa360Api.pyस्क्रिप्ट, कॉमा से अलग की गई स्ट्रिंग दिखाती है. पहली वैल्यू, आपका क्लाइंट आईडी होती है. दूसरी वैल्यू वह क्लाइंट सीक्रेट होती है जो आपने दी है और तीसरी वैल्यू, रीफ़्रेश टोकन होती है. नीचे दिए गए उदाहरण में, रीफ़्रेश टोकन बोल्ड टेक्स्ट में दिया गया है:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef,1/HIJklM01OPQR23NOP456rst890uvw - Client-ID, क्लाइंट सीक्रेट, और रीफ़्रेश टोकन को किसी बैकएंड डेटाबेस या ऐसी दूसरी सुरक्षित जगह में स्टोर करें जिसे आपके ऐप्लिकेशन से ऐक्सेस किया जा सकता है.
अगर आप
sa360Api.pyका इस्तेमाल करके, Search Ads 360 एपीआई को सैंपल JSON अनुरोध भेजना चाहते हैं, तो पूरे कॉमा लगाकर अलग की गई स्ट्रिंग को सुविधाजनक जगह पर रखें. हर बार स्क्रिप्ट शुरू करने पर, आपको पूरी स्ट्रिंग एक पैरामीटर के तौर पर पास करनी होगी. - अपने ऐप्लिकेशन में कोड जोड़ें जो नीचे दिए गए काम करता है:
- नया OAuth 2.0 ऐक्सेस टोकन पाने के लिए, क्लाइंट आईडी, क्लाइंट सीक्रेट, और रीफ़्रेश टोकन का इस्तेमाल करें.
- नए ऐक्सेस टोकन का इस्तेमाल करके, Search Ads 360 एपीआई को अनुरोध भेजें.
अगर आप क्लाइंट लाइब्रेरी का इस्तेमाल कर रहे हैं, तो अगला सेक्शन, अपना ऐप्लिकेशन सेट अप करें, अपने ऐप्लिकेशन में यह ऑथराइज़ेशन कोड जोड़ने का तरीका बताता है.
अगर किसी क्लाइंट लाइब्रेरी का इस्तेमाल नहीं किया जा रहा है, तो नए ऐक्सेस टोकन पाने के सुझावों के लिए, इंस्टॉल किए गए ऐप्लिकेशन के लिए OAuth 2.0 का इस्तेमाल करना देखें.