OAuth को सेट अप करना और उसका इस्तेमाल करना

Local Services API के सभी कॉल को OAuth 2.0 के ज़रिए अनुमति दी जानी चाहिए. इससे आपका Local Services API क्लाइंट ऐप्लिकेशन, उपयोगकर्ता के Local Services Ads खाते को ऐक्सेस कर पाता है. इसके लिए, उसे उपयोगकर्ता की लॉगिन जानकारी को मैनेज या सेव करने की ज़रूरत नहीं होती.

Local Services API, लोगों की पुष्टि करने के लिए OAuth 2.0 प्रोटोकॉल का इस्तेमाल करता है. OAuth 2.0 के बारे में ज़्यादा जानने के लिए, OAuth 2.0 का इस्तेमाल करके, Google API को ऐक्सेस करना लेख पढ़ें.

Local Services API के लिए, Google API Console प्रोजेक्ट को कॉन्फ़िगर करना

Google Ads के उपयोगकर्ताओं की पुष्टि करने और उन्हें अनुमति देने के लिए, आपके पास Google के OAuth 2.0 सर्वर को ऐक्सेस करने के क्रेडेंशियल होने चाहिए. इन क्रेडेंशियल से, Google को आपके ऐप्लिकेशन की पहचान करने में मदद मिलती है. साथ ही, इनकी मदद से Google Ads उपयोगकर्ताओं को मैनेज करने के लिए OAuth टोकन जनरेट किए जा सकते हैं. Google API Console का इस्तेमाल करके, Google OAuth 2.0 क्रेडेंशियल के ऐक्सेस को मैनेज करें.

ये क्रेडेंशियल पाने के लिए, यह तरीका अपनाएं:

1. प्रोजेक्ट बनाएं. इसके लिए, Google API Console पर जाएं. प्रोजेक्ट बनाएं पर क्लिक करें. इसके बाद, कोई नाम डालें और बनाएं पर क्लिक करें.

2. अपने प्रोजेक्ट में Local Services API चालू करें:

   1. Google API Console में, एपीआई लाइब्रेरी खोलें. अगर कहा जाए, तो अपना प्रोजेक्ट चुनें या नया प्रोजेक्ट बनाएं. एपीआई लाइब्रेरी में, उपलब्ध सभी एपीआई की सूची दी गई है. इन्हें प्रॉडक्ट फ़ैमिली और लोकप्रियता के हिसाब से ग्रुप किया गया है.

      अगर आपको सूची में Local Services API नहीं दिख रहा है, तो उसे ढूंढने के लिए खोज बॉक्स का इस्तेमाल करें.

   2. Local Services API को चुनें. इसके बाद, चालू करें पर क्लिक करें.

3. ऐप्लिकेशन का टाइप चुनें. Local Services API, Google Ads API की तरह ही ऐप्लिकेशन टाइप का इस्तेमाल करता है. किस तरह का ऐप्लिकेशन इस्तेमाल करना है, इस बारे में ज़्यादा जानकारी के लिए ऐप्लिकेशन का टाइप चुनना लेख पढ़ें.

4. क्लाइंट आईडी और क्लाइंट सीक्रेट बनाएं. Local Services API के लिए, Google Ads API के लिए इस्तेमाल किए गए तरीके का पालन करके, क्लाइंट आईडी और क्लाइंट सीक्रेट बनाएं. दोनों इस्तेमाल के उदाहरणों के लिए, एक ही तरीका अपनाया जाता है.

OAuth 2.0 टोकन पाने के लिए, क्लाइंट लाइब्रेरी का इस्तेमाल करना

OAuth 2.0 ऑथराइज़ेशन के अनुरोध करने के लिए, इस्तेमाल की जा सकने वाली क्लाइंट लाइब्रेरी की सूची देखने के लिए, क्लाइंट लाइब्रेरी पर जाएं. किसी नई लाइब्रेरी के लिए ऐक्सेस टोकन पाने के लिए, रिफ़्रेश टोकन इस्तेमाल करने का तरीका जानने के लिए, लाइब्रेरी से जुड़े निर्देशों का पालन करें.

OAuth 2.0 रीफ़्रेश टोकन पाने का तरीका

हमारा सुझाव है कि उपयोगकर्ताओं की पुष्टि करने के लिए, प्रोडक्शन में क्लाइंट लाइब्रेरी का इस्तेमाल करें. अगर आपको टेस्टिंग के लिए एचटीटीपी क्लाइंट का इस्तेमाल करना है, तो OAuth 2.0 रीफ़्रेश टोकन और ऐक्सेस टोकन पाने के लिए, यहां दिए गए निर्देशों का पालन करें. पहले तीन चरण, एक बार सेट अप करने के निर्देश हैं. इन्हें आपको मैन्युअल तरीके से पूरा करना होगा. इसके बाद, चौथे और पांचवें चरण को अपने-आप पूरा होने के लिए सेट किया जा सकता है. इससे ये चरण, बिना किसी मानवीय हस्तक्षेप के पूरे हो जाएंगे. जैसे, क्रॉन जॉब.

1. एचटीटीपी वेब अनुरोध करने के लिए, curl कमांड-लाइन टूल डाउनलोड और इंस्टॉल करें.

2. OAuth 2.0 रीफ़्रेश टोकन पाने के लिए, OAuth Playground पेज पर दिए गए निर्देशों का पालन करें. Local Services API के लिए, इस स्कोप का इस्तेमाल करें:

   https://www.googleapis.com/auth/adwords
   

   यह वही OAuth 2.0 स्कोप है जिसका इस्तेमाल Google Ads API करता है.

   इस चरण के आखिर में, आपको दो टोकन मिलते हैं: रीफ़्रेश टोकन और ऐक्सेस टोकन. दोनों को सेव करें.

3. पिछले चरण के पूरा होने की पुष्टि करने के लिए, कमांड प्रॉम्प्ट पर यह कमांड चलाएं:

   curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>
   

   अगर कमांड के आउटपुट में इस तरह का मैसेज दिखता है, तो इसका मतलब है कि कमांड काम कर गई:

   {
     "azp": "************-********************************.apps.googleusercontent.com",
     "aud": "************-********************************.apps.googleusercontent.com",
     "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
     "exp": "1611183382",
     "expires_in": "3482",
     "access_type": "offline"
   }
   

   अगर कोई गड़बड़ी है या स्कोप सही नहीं है, तो टोकन फिर से जनरेट करने की कोशिश करें.

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

   नया ऐक्सेस टोकन पाने के लिए, यह कमांड चलाएं:

   curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”
   

5. यह एपीआई कॉल चलाएं:

   curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>
   

   अगर यह कॉल हो जाता है, तो इसका मतलब है कि सेटअप पूरा हो गया है.