Google Ads API में सहमति को अनबंडल करना

गुरुवार, 20 फ़रवरी, 2025

क्या बदल रहा है?
हम 1 मई, 2025 से, OAuth उपयोगकर्ता की पुष्टि के लिए सहमति को अनबंडल करने की सुविधा को रोल आउट करेंगे. यह सुविधा, साल 2019 से पहले बनाए गए सभी Google Cloud प्रोजेक्ट के लिए उपलब्ध होगी. अगर आपके पास कोई ऐसा ऐप्लिकेशन है जो 2019 से पहले बनाए गए Google Cloud प्रोजेक्ट के ज़रिए, Google Ads से जुड़े एपीआई का इस्तेमाल करता है, तो आपको 1 मई, 2025 से पहले अपने ऐप्लिकेशन को अपडेट करना पड़ सकता है. इससे, उपयोगकर्ता की सहमति को अलग-अलग मैनेज किया जा सकेगा.

बैकग्राउंड
OAuth उपयोगकर्ता की पुष्टि करने के फ़्लो के लिए, सहमति को अनबंडल करने की सुविधा से, उपयोगकर्ताओं को यह तय करने की सुविधा मिलती है कि वे आपके ऐप्लिकेशन को OAuth के किन दायरों के लिए अनुमति देना चाहते हैं. इससे उन्हें सभी दायरों को अनुमति देने या किसी भी दायरे को अनुमति न देने के बजाय, अपनी पसंद के मुताबिक दायरे चुनने की सुविधा मिलती है. साल 2019 के बाद बनाए गए Google Cloud Console के सभी प्रोजेक्ट में यह सुविधा चालू होती है. वहीं, साल 2019 से पहले बनाए गए सभी प्रोजेक्ट में यह सुविधा बंद होती है.

इस बदलाव का असर किन पर पड़ेगा?
अगर ये सभी शर्तें पूरी होती हैं, तो इस बदलाव का असर आप पर पड़ेगा:

  1. आपका एपीआई ऐप्लिकेशन, Google Cloud Console के ऐसे प्रोजेक्ट का इस्तेमाल करता है जिसे 2019 से पहले बनाया गया था.
  2. आपका ऐप्लिकेशन, OAuth 2.0 के उपयोगकर्ता की सहमति वाले फ़्लो को लागू करता है. यह पुष्टि करने वाला एक वर्कफ़्लो है. इसमें उपयोगकर्ता अपने Google खाते से लॉग इन करता है और एक या उससे ज़्यादा अनुमतियां देता है जिनके लिए आपका ऐप्लिकेशन अनुरोध कर रहा है.
  3. आपका ऐप्लिकेशन, एक से ज़्यादा Google API का इस्तेमाल करता है. साथ ही, इनमें से एक एपीआई, Google Ads से जुड़ा है और नीचे दी गई सूची में शामिल है.

इस बदलाव का असर किस पर नहीं पड़ेगा?

  • मौजूदा रीफ़्रेश टोकन: इस बदलाव से, उपयोगकर्ता की पुष्टि करने की उन प्रोसेस पर कोई असर नहीं पड़ता जो पहले से मौजूद हैं. आपके मौजूदा रीफ़्रेश टोकन, बिना किसी बदलाव या फिर से पुष्टि किए काम करते रहेंगे.
  • एक स्कोप वाले ऐप्लिकेशन: अगर आपका ऐप्लिकेशन सिर्फ़ एक Google API स्कोप का इस्तेमाल करता है, तो इस बदलाव का आपके ऐप्लिकेशन पर कोई असर नहीं पड़ेगा. ऐसा इसलिए, क्योंकि अनबंडल करने के लिए एक से ज़्यादा OAuth स्कोप नहीं हैं.
  • एक उपयोगकर्ता वाले ऐप्लिकेशन / मैन्युअल तरीके से पुष्टि करने वाले ऐप्लिकेशन: आपके ऐप्लिकेशन में, OAuth उपयोगकर्ता की पुष्टि करने का कोई फ़्लो लागू नहीं किया गया है. इसके बजाय, उपयोगकर्ता की पुष्टि करने के लिए, मैन्युअल तरीके से पुष्टि करने वाली स्क्रिप्ट का इस्तेमाल किया जाता है. जैसे, GenerateUserCredentials, gcloud सीएलआई या OAuth Playground. इसके बाद, उन क्रेडेंशियल का इस्तेमाल लंबे समय तक किया जाता है. पुष्टि करते समय, आपके ऐप्लिकेशन के लिए ज़रूरी सभी स्कोप चुने जाते हैं. इसलिए, इस बदलाव का आपके ऐप्लिकेशन पर कोई असर नहीं पड़ता.
  • सेवा खाते: अगर आपका ऐप्लिकेशन, एपीआई कॉल की पुष्टि करने के लिए किसी सेवा खाते का इस्तेमाल करता है, तो इस बदलाव का आप पर कोई असर नहीं पड़ेगा

मुझे क्या करना होगा?
आपको यह पक्का करना होगा कि आपका ऐप्लिकेशन, उपयोगकर्ता की कुछ सहमति को मैनेज कर सके. इसके लिए,

  1. उन OAuth स्कोप की सूची का अनुरोध करें जिनके लिए उपयोगकर्ता ने सहमति दी है. इसके लिए, अपने OAuth फ़्लो में include_granted_scopes पैरामीटर शामिल करें.
  2. OAuth के जवाब में, OAuth के उन दायरों की असल सूची की जांच करें जिनके लिए उपयोगकर्ता ने सहमति दी है.
  3. अपने ऐप्लिकेशन में इंक्रीमेंटल ऑथराइज़ेशन लागू करें.

अलग से अनुमति लेने की ज़रूरी शर्तों और सबसे सही तरीकों के बारे में जानने के लिए, OAuth की अलग से अनुमति लेने की गाइड पढ़ें.

मैं इस सुविधा को कैसे आज़माऊं?
इस सुविधा को टेस्ट करने के दो तरीके हैं:

  1. नया Google Cloud प्रोजेक्ट बनाना: नए Google Cloud प्रोजेक्ट में, OAuth की सहमति को अनबंडल करने की सुविधा चालू होती है. इसलिए, आपके पास एक नया Google Cloud प्रोजेक्ट बनाने और उसका इस्तेमाल करके अपने ऐप्लिकेशन की जांच करने का विकल्प है.
  2. अपने मौजूदा प्रोजेक्ट में, सहमति को अनबंडल करने की सुविधा चालू करें: OAuth ऑथराइज़ेशन के अनुरोध में, enable_granular_consent पैरामीटर को 'सही है' पर सेट किया जा सकता है.

एपीआई के किन स्कोप पर असर पड़ा है?
इस बदलाव का असर, Google Ads से जुड़े इन एपीआई पर पड़ेगा.

एपीआई OAuth का दायरा
Google Ads API https://adwords.google.com/api/adwords
Google Ad Manager API (SOAP API, बीटा) https://www.googleapis.com/auth/dfp
https://www.googleapis.com/auth/admanager
Bid Manager API https://www.googleapis.com/auth/doubleclickbidmanager
Content API for Shopping https://www.googleapis.com/auth/content
Display and Video 360 API https://www.googleapis.com/auth/display-video-mediaplanning
https://www.googleapis.com/auth/display-video-user-management
AdMob API https://www.googleapis.com/auth/admob.report
https://www.googleapis.com/auth/admob.googlebidding.readwrite
https://www.googleapis.com/auth/admob.monetization
AdSense for Platforms API https://www.googleapis.com/auth/adsensehost
https://www.googleapis.com/auth/adsense
https://www.googleapis.com/auth/adsense.readonly
Google Analytics API https://www.googleapis.com/auth/analytics
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics.edit
https://www.googleapis.com/auth/analytics.manage.users
https://www.googleapis.com/auth/analytics.manage.users.readonly
https://www.googleapis.com/auth/analytics.provision
https://www.googleapis.com/auth/analytics.user.deletion
Campaign Manager 360 API https://www.googleapis.com/auth/ddmconversions
https://www.googleapis.com/auth/dfareporting
https://www.googleapis.com/auth/dfatrafficking
Search Ads 360 API https://www.googleapis.com/auth/doubleclicksearch
Google Tag Manager API https://www.googleapis.com/auth/tagmanager.delete.containers
https://www.googleapis.com/auth/tagmanager.edit.containers
https://www.googleapis.com/auth/tagmanager.edit.containerversions
https://www.googleapis.com/auth/tagmanager.manage.accounts
https://www.googleapis.com/auth/tagmanager.manage.users
https://www.googleapis.com/auth/tagmanager.publish
https://www.googleapis.com/auth/tagmanager.readonly
रीयल टाइम बिडिंग एपीआई https://www.googleapis.com/auth/realtime-bidding
Authorized Buyers Marketplace API https://www.googleapis.com/auth/authorized-buyers-marketplace
https://www.googleapis.com/auth/adexchange.buyer

मदद पाने का तरीका
अगर आपका कोई सवाल है या आपको मदद चाहिए, तो अपने एपीआई की सहायता टीम से संपर्क करें.

लेबल: authentication, oauth