OAuth डेस्कटॉप और वेब ऐप्लिकेशन फ़्लो

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

OAuth 2.0 क्रेडेंशियल बनाना

1. Google Ads API के लिए, Google API Console प्रोजेक्ट को कॉन्फ़िगर करने का तरीका जानें.

2. क्लाइंट की JSON फ़ाइल डाउनलोड करने के लिए, सबसे पहले उसके OAuth क्लाइंट डाउनलोड करें आइकॉन पर क्लिक करें. इसके बाद, अगली स्क्रीन पर मौजूद JSON डाउनलोड करें बटन पर क्लिक करें.

   फ़ाइल को अपनी होम डायरेक्ट्री में सेव करें, ताकि अब आपके पास लोकल फ़ाइल ~/client_secret_XXX.apps.googleusercontent.com.json हो (जहां XXX आपके प्रोजेक्ट के हिसाब से वैल्यू होंगी). हम इस फ़ाइल का इस्तेमाल अगले चरण में, कोड का उदाहरण चलाने के लिए करेंगे.

क्लाइंट लाइब्रेरी सेट अप करना

1. टर्मिनल में, GenerateUserCredentials कोड का उदाहरण चलाएं. डाउनलोड की गई OAuth 2.0 JSON फ़ाइल को पास करने के लिए, कमांड-लाइन फ़्लैग का इस्तेमाल करें.

   Gradle का इस्तेमाल करके, कमांड लाइन से कोड के उदाहरण को चलाने के लिए, इस कमांड का इस्तेमाल किया जा सकता है:

   ./gradlew --console=plain --quiet runExample \
         --example="authentication.GenerateUserCredentials \
         --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
       

2. कोड के इस उदाहरण में, आपको एक यूआरएल पर जाने के लिए कहा जाएगा. यहां आपको ऐप्लिकेशन को अपनी ओर से, Google Ads खाता ऐक्सेस करने की अनुमति देनी होगी.

   Paste this URL in your browser:
   https://accounts.google.com/o/oauth2/auth?access_type=offline&client_id=****...
       

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

   

   आपको एक ऐसे पेज पर ले जाया जाएगा जहां यह मैसेज दिखेगा कि अनुमति मिल गई है.

   Authorization code was successfully retrieved.
   
   Check the console output from `GenerateUserCredentials` for further instructions.
       

3. उस कंसोल पर वापस जाएं जहां कोड का उदाहरण चलाया जा रहा है. आपको दिखेगा कि कोड का उदाहरण पूरा हो गया है और इसमें आपका रीफ़्रेश टोकन और कुछ निर्देश दिख रहे हैं. इसके बाद, आपको क्लाइंट लाइब्रेरी कॉन्फ़िगर करने के लिए, ये निर्देश दिखेंगे:

       #Mon Apr 18 09:07:51 EDT 2022
       api.googleads.refreshToken=1/Yw.........................................
       api.googleads.clientId=...........-...............apps.googleusercontent.com
       api.googleads.developerToken=INSERT_DEVELOPER_TOKEN_HERE
       api.googleads.clientSecret=........................
       

4. तारीख वाली टिप्पणी # से लेकर आउटपुट के आखिर तक की लाइनों को अपनी ads.properties फ़ाइल में कॉपी करें.

   INSERT_DEVELOPER_TOKEN_HERE की जगह अपना डेवलपर टोकन डालें.

   सेटअप को आसान बनाने के लिए, ads.properties फ़ाइल को अपनी होम डायरेक्ट्री में रखें.