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

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

किसी एक खाते के लिए, OAuth2 क्रेडेंशियल जनरेट करें

Google Ads API खातों को कॉल करने का सबसे आसान तरीका यह है कि

  1. उन सभी खातों को एक ही Google Ads मैनेजर खाते में जोड़ें जिनमें आप एपीआई कॉल करना चाहते हैं.

  2. मैनेजर खाते का ऐक्सेस रखने वाले उपयोगकर्ता के लिए, OAuth2 क्रेडेंशियल जनरेट करने के लिए GenerateUserCredentials उदाहरण का इस्तेमाल करें.

  3. Google Ads API का इस्तेमाल करके, जिन खातों को मैनेज करना है उन सभी को कॉल करने के लिए, OAuth2 क्रेडेंशियल का इस्तेमाल करें.

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

पहला चरण - OAuth2 क्रेडेंशियल बनाएं

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

  2. क्लाइंट आईडी और सीक्रेट को नोट करें. इसके बाद, इस पेज पर वापस आएं.

दूसरा चरण - क्लाइंट लाइब्रेरी सेट अप करना

  1. टर्मिनल में, GenerateUserCredentials का उदाहरण चलाएं. इससे आपको OAuth2 क्लाइंट आईडी और सीक्रेट डालने के लिए कहा जाएगा.

    यह एक इंटरैक्टिव उदाहरण है, जिसके लिए आपको इनपुट देना होगा.

    dotnet run GenerateUserCredentials.csproj
    
  2. इस उदाहरण में, आपसे OAuth2 क्लाइंट आईडी और सीक्रेट की जानकारी मांगी गई है. पहले चरण में दी गई जानकारी दें.

  3. उदाहरण से, ब्राउज़र में यूआरएल अपने-आप खुल जाता है. अगर आपने ब्राउज़र सेशन में साइन इन नहीं किया है, तो वेब पेज आपको Google खाते में साइन इन करने का प्रॉम्प्ट देगा. अगर आपने पहले से ही साइन इन किया हुआ है, तो यह साइन इन करने के प्रॉम्प्ट को छोड़कर आपको उस यूआरएल पर रीडायरेक्ट कर देगा जहां आपको ऐप्लिकेशन को आपकी ओर से Google Ads खाते को ऐक्सेस करने की अनुमति देने के लिए कहा जाएगा.

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

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

    आपका रीफ़्रेश टोकन फ़ेच किया गया. ज़्यादा निर्देशों के लिए कंसोल के आउटपुट देखें.

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

    Copy the following content into your App.config file.
    
    <add key = 'OAuth2Mode' value = 'APPLICATION' />
    <add key = 'OAuth2ClientId' value = '******' />
    <add key = 'OAuth2ClientSecret' value = '******' />
    <add key = 'OAuth2RefreshToken' value = '******' />
    
    Make sure you also set the LOGIN_CUSTOMER_ID header. See
    https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration#google_ads_api_settings
    to learn more.
    
    <add key = 'LoginCustomerId' value = 'INSERT_LOGIN_CUSTOMER_ID_HERE' />
    
    See https://developers.google.com/google-ads/api/docs/client-libs/dotnet/configuration
    for alternate configuration options.
    

इंटरैक्टिव ऐप्लिकेशन के लिए, OAuth2 क्रेडेंशियल जनरेट करें

अगर आपको पहले से ही एपीआई कॉल करने के लिए Google Ads खाते की जानकारी नहीं है, तो रनटाइम के दौरान सेशन के लिए साइन इन किए हुए उपयोगकर्ता के क्रेडेंशियल का इस्तेमाल करके, इसकी जानकारी रनटाइम के दौरान देखी जा सकती है. AuthenticateInAspNetCoreApplication देखें कि फ़िलहाल जिस उपयोगकर्ता ने साइन इन किया हुआ है उसकी पुष्टि हुई है और OAuth2 क्रेडेंशियल, रनटाइम के दौरान मिलते हैं.