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

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

OAuth2 क्रेडेंशियल बनाएं

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

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

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

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

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

    Gradle का इस्तेमाल करके कमांड लाइन से चलाने के लिए

    ./gradlew --console=plain --quiet runExample \
      --example="authentication.GenerateUserCredentials \
      --oAuthClientFile ${HOME}/client_secret_XXX.apps.googleusercontent.com.json"
    
  2. इस उदाहरण में आपको ऐसे यूआरएल पर जाने का निर्देश मिलेगा जहां आपको अपनी ओर से Google Ads खाते को ऐक्सेस करने के लिए OAuth2 क्रेडेंशियल की अनुमति देनी होगी.

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

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

    वह स्क्रीन जहां सहमति दी जाती है

  3. इसके बाद, आपको एक पेज पर ले जाया जाएगा. इस पेज पर यह जानकारी होगी कि पुष्टि की प्रक्रिया पूरी हो गई है.

    ऑथराइज़ेशन कोड वापस मिल गया.

    आगे के निर्देशों के लिए, GenerateUserCredentials से कंसोल के आउटपुट को देखें.

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

    #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=........................
    
  5. अपनी ads.properties फ़ाइल में, टिप्पणी की तारीख # से लेकर आउटपुट के आखिर तक की लाइनों को कॉपी करें.

    INSERT_DEVELOPER_TOKEN_HERE को अपने डेवलपर टोकन से बदलें.

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