Search Ads 360 Reporting API का नया वर्शन अब उपलब्ध है. आने वाले समय में किए जाने वाले बदलावों और रिलीज़ के बारे में अप-टू-डेट रहने के लिए, searchads-api-announcements Google ग्रुप में शामिल हों.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

OAuth प्लेग्राउंड

OAuth2 क्रेडेंशियल जनरेट करने का एक विकल्प यह है कि आप OAuth2 प्लेग्राउंड का इस्तेमाल करें. Google Ads API कंसोल के साथ, OAuth2 प्लेग्राउंड का इस्तेमाल करके, मैन्युअल रूप से OAuth2 टोकन बनाए जा सकते हैं.

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

क्लाइंट आईडी और क्लाइंट सीक्रेट पाएं

अगर आपके पास कोई मौजूदा क्लाउड प्रोजेक्ट नहीं है, तो:

Google API Console के क्रेडेंशियल वाला पेज खोलें.
प्रोजेक्ट के ड्रॉप-डाउन मेन्यू से, कोई मौजूदा प्रोजेक्ट चुनें या कोई नया प्रोजेक्ट बनाएं.
क्रेडेंशियल पेज पर, क्रेडेंशियल बनाएं चुनें. इसके बाद, OAuth क्लाइंट आईडी चुनें.
ऐप्लिकेशन प्रकार में, वेब ऐप्लिकेशन चुनें.
अनुमति वाले रीडायरेक्ट यूआरआई में जाकर, इनके साथ एक लाइन जोड़ें: https://developers.google.com/oauthplayground
बनाएं पर क्लिक करें.
Client-ID पेज पर, क्लाइंट आईडी और क्लाइंट सीक्रेट का ध्यान रखें. आपको अगले चरण में इनकी ज़रूरत पड़ेगी.

अगर आपके पास कोई मौजूदा क्लाउड प्रोजेक्ट है, तो ऊपर दिए गए अनुमति वाले रीडायरेक्ट यूआरआई को सेट करके उन्हें फिर से इस्तेमाल किया जा सकता है.

टोकन जनरेट करें

चेतावनी: आपने अपने ब्राउज़र में, Search Ads 360 के जिस उपयोगकर्ता से साइन इन किया है उससे यह तय होता है कि जनरेट किए गए OAuth2 क्रेडेंशियल का इस्तेमाल करके, कौनसे खाते ऐक्सेस किए जा सकेंगे. इसलिए, हो सकता है कि आप गुप्त विंडो में या Search Ads 360 खाते में साइन इन न होने पर यह तरीका अपनाना चाहें. ऐसा इसलिए हो सकता है, क्योंकि हो सकता है कि आप जिस उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करना चाहते हैं वह वही उपयोगकर्ता न हो जिससे आपने क्लाइंट आईडी और सीक्रेट मिलने पर साइन इन किया था.

OAuth2 प्लेग्राउंड पर जाएं, (इस लिंक का इस्तेमाल करके, आपके लिए कुछ ज़रूरी वैल्यू अपने-आप भर जानी चाहिए).
सबसे ऊपर दाएं कोने में मौजूद, गियर आइकॉन पर क्लिक करें. इसके बाद, अपने OAuth क्रेडेंशियल इस्तेमाल करें लेबल वाले बॉक्स को चुनें. ऐसा तब करें, जब आपने उस पर पहले से सही का निशान न लगाया हो.
सुनिश्चित करें कि:
- OAuth फ़्लो, सर्वर-साइड पर सेट है.
- ऐक्सेस टाइप को ऑफ़लाइन पर सेट किया गया है. इससे यह पक्का होता है कि आपको सिर्फ़ ऐक्सेस टोकन के बजाय, रीफ़्रेश टोकन और ऐक्सेस टोकन मिलेगा.
ऊपर मिला OAuth2 क्लाइंट आईडी और OAuth2 क्लाइंट सीक्रेट डालें.
पहला चरण - एपीआई चुनें और अनुमति दें लेबल वाले सेक्शन में, सूची में से Search Ads 360 Reporting API पर क्लिक करें और इसका दायरा चुनें, https://www.googleapis.com/auth/doubleclicksearch. इसके बाद, एपीआई को अनुमति दें पर क्लिक करें:
अगर आपसे कहा जाए, तो उस खाते में साइन इन करें जिसे आपको ऐक्सेस और अनुमति देना है. अगर ऐसा नहीं है, तो पुष्टि करें कि सबसे ऊपर दाएं कोने में मौजूद मौजूदा उपयोगकर्ता, वह क्लाइंट या मैनेजर खाता है जिसके लिए आपको क्रेडेंशियल चाहिए.

अगर आपको अपना क्लाइंट आईडी और सीक्रेट कुछ मिनट पहले ही मिला है और आपको गड़बड़ी: redirect_uri_mismatch जैसी कोई गड़बड़ी मिलती है, तो हो सकता है कि आपने जो बदलाव किए हैं वे लागू न हुए हों. अपने ब्राउज़र में 'वापस जाएं' बटन पर क्लिक करें और कुछ मिनट इंतज़ार करें. इसके बाद, एपीआई को अनुमति दें पर दोबारा क्लिक करके देखें.
अगर आपको यह गड़बड़ी मिलती है कि आपको डेवलपर ने ऐक्सेस नहीं दिया है और ऐप्लिकेशन की अभी जांच की जा रही है, तो आपको अपने GCP प्रोजेक्ट में उस स्क्रीन पेज पर जाना होगा जहां OAuth के लिए सहमति दी जाती है. इसके बाद, इनमें से कोई एक काम करना होगा:
- ऐप्लिकेशन पब्लिश करें.
- ऐप्लिकेशन को टेस्टिंग स्टेटस में रखें और खुद को टेस्ट उपयोगकर्ता के तौर पर जोड़ें.
इसके बाद, आपको एक प्रॉम्प्ट दिखेगा, जो यह बताता है कि आपका ऐप्लिकेशन आपके Search Ads 360 कैंपेन मैनेज करना चाहता है. जारी रखने के लिए स्वीकार करें पर क्लिक करें.
दूसरा चरण - टोकन के लिए Exchange ऑथराइज़ेशन कोड लेबल वाले टैब में, ऑथराइज़ेशन कोड दिखेगा. टोकन के लिए ऑथराइज़ेशन कोड एक्सचेंज करें पर क्लिक करें.
अगर सब ठीक रहता है, तो रीफ़्रेश टोकन और ऐक्सेस टोकन भरा होना चाहिए (आपको इन्हें फिर से बड़ा करना पड़ सकता है दूसरा चरण - टोकन के लिए Exchange ऑथराइज़ेशन कोड):
अपनी पसंद की क्लाइंट लाइब्रेरी की कॉन्फ़िगरेशन फ़ाइल में रीफ़्रेश टोकन के साथ-साथ, क्लाइंट आईडी और क्लाइंट सीक्रेट को कॉपी करें.
Search Ads 360 Reporting API में OAuth के लिए क्लाइंट लाइब्रेरी कॉन्फ़िगर करना.

अपने क्लाइंट आईडी से OAuth2 Playground को हटाना

अब आपके पास रीफ़्रेश टोकन है, इसलिए अब आपको OAuth2 प्लेग्राउंड को अनुमति वाले रीडायरेक्ट यूआरआई के तौर पर बनाने की ज़रूरत नहीं है. इसे, अनुमति वाले रीडायरेक्ट यूआरआई की सूची से हटाने के लिए:

Google API Console के क्रेडेंशियल वाले पेज पर जाएं.
प्रोजेक्ट ड्रॉप-डाउन से, अपना प्रोजेक्ट चुनें.
क्रेडेंशियल पेज पर जाकर, बदलाव करने के लिए क्लाइंट आईडी के नाम पर क्लिक करें.
अनुमति वाले रीडायरेक्ट यूआरआई से https://developers.google.com/oauthplayground को हटाएं. ध्यान दें कि आपको अपनी जगह पर कम से कम एक रीडायरेक्ट यूआरआई छोड़ना होगा.
सेव करें पर क्लिक करें.