ऐक्सेस लेवल, जिसे क्लाउड से मैनेज किया जाता है

इस सुविधा की मदद से, आपके एपीआई ऐक्सेस लेवल को Google Cloud संगठन मैनेज करता है. इससे आपको ये फ़ायदे मिलते हैं:

  • डेवलपर टोकन को सुरक्षित करने की अब कोई ज़रूरत नहीं: एपीआई ऐक्सेस को Google Cloud संगठन की मदद से मैनेज किया जाता है. इसलिए, अब आपको डेवलपर टोकन को सुरक्षित करने या उसे लीक करने की चिंता नहीं करनी होगी. आपके पास एपीआई कॉल में डेवलपर टोकन भेजने की प्रोसेस को छोड़ने का विकल्प है. हालांकि, आपको अब भी ऐक्सेस टोकन भेजना होगा.

  • अलग-अलग ऐप्लिकेशन के लिए अलग-अलग Google API कंसोल प्रोजेक्ट बनाए रखना: Google Cloud संगठन से लिंक किया गया कोई भी प्रोजेक्ट, संगठन के एपीआई ऐक्सेस लेवल को इनहेरिट करता है. इससे आपको इस संगठन में कई Google API कंसोल प्रोजेक्ट बनाने की सुविधा मिलती है. जैसे, अपनी टीम के सदस्यों के लिए, बेहतर प्रोजेक्ट मैनेजमेंट, अलग-अलग ऐप्लिकेशन के लिए अलग-अलग प्रोजेक्ट, और अपनी टीम के सदस्यों के लिए कई Google API कंसोल प्रोजेक्ट.

  • बेहतर कोटा की निगरानी और मैनेजमेंट: अलग-अलग प्रोजेक्ट या कैप एपीआई के इस्तेमाल के एपीआई के इस्तेमाल पर नज़र रखी जा सकती है.

ज़रूरी शर्तें

  • स्वीकार किया गया डेवलपर टोकन

    इस विकल्प का इस्तेमाल करने के लिए, आपके पास पहले से ही मंज़ूरी वाला डेवलपर टोकन होना चाहिए. अपने Google Ads मैनेजर खाते के एपीआई सेंटर पेज पर, पहले से मौजूद डेवलपर टोकन देखा जा सकता है. साइन इन करें. इसके बाद, टूल और सेटिंग > सेटअप > एपीआई सेंटर पर जाएं.

  • Google Cloud संगठन का होना

    Google Ads API, आपके डेवलपर टोकन को किसी Google Cloud संगठन से जोड़ता है. साथ ही, इसका इस्तेमाल आपके एपीआई ऐक्सेस लेवल को तय करने के लिए करता है. Google Cloud संगठन बनाने के कई तरीके हैं.

    स्थिति चरण
    आप Google Workspace या Google Cloud Identity के मौजूदा ग्राहक हों ऐसा हो सकता है कि आपके पास पहले से ही संगठन का कोई संसाधन हो. अगर ज़रूरी हो, तो जांच करें और एक बनाएं.
    Google Workspace या Google Cloud Identity का इस्तेमाल न किया जाए Google Cloud Identity के मुफ़्त वर्शन के लिए साइन अप करें. इसके बाद, अपने संगठन का संसाधन बनाएं.
    पहले वाला कोई भी विकल्प आपके लिए काम नहीं करता जब आप पायलट कार्यक्रम के लिए साइन अप करें और Google से आपके लिए, संगठन का संसाधन बनाने का अनुरोध करें, तो उसे अपनी स्थिति के बारे में बताएं. Google, इस संगठन के संसाधन का मालिक होगा और उसे मैनेज करेगा. इसके लिए, कोई शुल्क नहीं लिया जाएगा.

  • पायलट प्रोग्राम के लिए, अपने Google API Console के प्रोजेक्ट तैयार करना

    पायलट कार्यक्रम के लिए, आपको Google Ads API के साथ इस्तेमाल किए जाने वाले Google API कंसोल प्रोजेक्ट को इस तरह तैयार करना होगा:

    स्थिति चरण
    आपके पास पहले से ही Google Cloud संगठन का मालिकाना हक हो या आपने पिछले चरण में कोई संगठन बनाया हो पक्का करें कि वे सभी Google API कंसोल प्रोजेक्ट इस संगठन के तहत हों, जिनमें आपने Google Ads API को चालू किया है. अगर ऐसा नहीं है, तो इसे संगठन में माइग्रेट करें.

    अगर आप Google Workspace या Google Cloud Identity के मौजूदा ग्राहक हैं, तो हो सकता है कि Google API Console प्रोजेक्ट पहले से आपके संगठन के तहत हों. इसलिए, आप इस चरण को छोड़ सकते हैं.
    आपके पास Google Cloud संगठन का मालिकाना हक नहीं है और आप पिछले चरण में संगठन नहीं बना सकते पक्का करें कि आप अपने Google Ads API मैनेजर खाते और Google API कंसोल प्रोजेक्ट के एडमिन दोनों हों. पायलट आवेदन को मंज़ूरी मिलने के बाद, आपको कुछ और चरण पूरे करने के लिए इस अनुमति की ज़रूरत होगी.

  • अप-टू-डेट एपीआई संपर्क ईमेल

    पक्का करें कि Google Ads API से संपर्क करने के लिए दिया गया आपका ईमेल पता अप-टू-डेट है. आपके एपीआई की संपर्क जानकारी, आपके Google Ads API मैनेजर खाते के एपीआई सेंटर पेज पर मौजूद है. साइन इन करें. इसके बाद, टूल और सेटिंग > सेटअप > एपीआई सेंटर पर जाएं.

पायलट प्रोग्राम के लिए साइन अप करें

पायलट प्रोग्राम के लिए साइन अप करें. इसके बाद, Google की अनुपालन टीम आपके आवेदन की समीक्षा करेगी और मंज़ूरी की स्थिति और अन्य जानकारी के साथ आपके एपीआई संपर्क के ईमेल पते पर ईमेल करेगी.

अगर आपने Google से अपने लिए Google Cloud संगठन बनाने का अनुरोध किया है, तो आपको कुछ और चरण अपनाने होंगे:

  1. Google आपके लिए, Google के मालिकाना हक वाला Cloud संगठन का संसाधन बनाएगा. आपके Google Ads API मैनेजर खाते के सभी एडमिन को नए संगठन में roles/resourcemanager.projectCreator की भूमिका मिलेगी.

  2. Google, संगठन के नए संसाधन की जानकारी के साथ आपके एपीआई संपर्क के ईमेल पते को ईमेल करेगा.

  3. आपको अपने Google API कंसोल खाते में साइन इन करना होगा और नए संगठन में अपने Google API कंसोल प्रोजेक्ट को ले जाने के निर्देशों का पालन करना होगा.

  4. ईमेल का जवाब देकर Google को बताएं कि आपके प्रोजेक्ट नए संगठन में ले जाए गए हैं.

  5. Google की अनुपालन टीम आपके आवेदन की समीक्षा करेगी और अनुमति की स्थिति और अतिरिक्त जानकारी के साथ आपके एपीआई संपर्क के ईमेल पते पर ईमेल करेगी.

अपने एपीआई अनुरोधों में बदलाव करना

अपने ऐप्लिकेशन में बदलाव किया जा सकता है, ताकि एपीआई कॉल करते समय, developer-token हेडर भेजना बंद किया जा सके. यह एक वैकल्पिक लेकिन सुझाया गया चरण है. अगर आप पायलट प्रोग्राम में शामिल हैं, तो एपीआई अनुरोधों के हिस्से के तौर पर भेजे जाने पर, Google Ads API का सर्वर developer-token को अनदेखा कर देता है.

Java

यह सुविधा जल्द शुरू होने वाली है!

.NET

Google Ads API.NET लाइब्रेरी के 17.1 .0 या इसके बाद के वर्शन को डाउनलोड और इंस्टॉल करें.

इसके बाद, अपने कोड में इस तरह से बदलाव करें:

// Create a client.
GoogleAdsClient client = new GoogleAdsClient();

// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;

// Make the API calls.
...

PHP

यह सुविधा जल्द शुरू होने वाली है!

Python

यह सुविधा जल्द शुरू होने वाली है!

Ruby

यह सुविधा जल्द शुरू होने वाली है!

Perl

यह सुविधा जल्द शुरू होने वाली है!

एचटीटीपी क्लाइंट (REST)

अपने एचटीटीपी अनुरोधों में, developer-token हेडर को छोड़ दें:

curl -i -X POST https://googleads.googleapis.com/v16/customers/CUSTOMER_ID/googleAds:searchStream \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "login-customer-id: LOGIN_CUSTOMER_ID" \
  --data-binary "@query.json"

अक्सर पूछे जाने वाले सवाल

क्या इस बदलाव का मतलब है कि Google Ads API का इस्तेमाल करने के लिए, मेरा Google Workspace या Google Cloud ग्राहक होना ज़रूरी है?

नहीं. आपको Google Cloud संगठन की ज़रूरत होती है, जिसे कई तरीकों से हासिल किया जा सकता है. यह ज़रूरत वैसी ही है, जैसे अभी आपको Google Ads API का इस्तेमाल करने के लिए, Google API Console प्रोजेक्ट की ज़रूरत होती है.

मुझे अपने एपीआई ऐक्सेस लेवल में बदलाव करना है. मुझे इसके लिए क्या करना होगा?

एपीआई ऐक्सेस लेवल में किसी भी बदलाव का अनुरोध करने के लिए, आपको फ़िलहाल एपीआई सेंटर का इस्तेमाल करते रहना चाहिए.

क्या इस पायलट कार्यक्रम में ऑप्ट-इन करने के लिए, कोई डाउनटाइम शेड्यूल किया गया है?

नहीं, ऐसा कोई तरीका नहीं है. मंज़ूरी मिलने के बाद, Google Ads API, संगठन-लेवल के एपीआई ऐक्सेस लेवल का इस्तेमाल अपने-आप शुरू कर देगा.

इस पायलट प्रोग्राम में हिस्सा लेने के लिए कितनी मेहनत करनी पड़ती है?

कोड में बहुत कम बदलाव हो सकते हैं. ज़्यादातर डेवलपर अपने ऐप्लिकेशन में 30 मिनट के अंदर बदलाव कर सकते हैं.

इस पायलट कार्यक्रम में ऑप्ट-इन करने पर, क्या मुझसे शुल्क लिया जाएगा?

आम तौर पर, नहीं, इस पायलट कार्यक्रम में ऑप्ट-इन करने पर आपसे शुल्क नहीं लिया जाएगा. Google Ads API बिना किसी शुल्क के उपलब्ध है और Google, Google Ads API के प्राइसिंग मॉडल में कोई बदलाव नहीं कर रहा है.

Google Cloud संगठन हासिल करने की ये स्थितियां हो सकती हैं:

  1. आप Google Workspace या Google Cloud Identity के मौजूदा ग्राहक हैं:

    आपसे उन प्रॉडक्ट का इस्तेमाल नियमित तौर पर करने के लिए, हमेशा की तरह शुल्क लिया जाएगा. इस पायलट प्रोग्राम में हिस्सा लेने के लिए, आपसे Google Cloud संगठन बनाने के लिए कोई शुल्क नहीं लिया जाएगा.

  2. आपने Google Cloud Identity के मुफ़्त वर्शन का खाता बनाया है:

    इस पायलट कार्यक्रम में हिस्सा लेने के लिए, Google Cloud Identity के मुफ़्त वर्शन वाले खाते में साइन अप करते समय या Google Cloud संगठन बनाने पर, आपसे कोई शुल्क नहीं लिया जाएगा.

  3. Google ने आपके लिए Cloud संगठन का संसाधन बनाया है:

    यह Google-मैनेज किया जाने वाला इंटरनल क्लाउड संगठन का संसाधन है. इसलिए, आपसे कोई शुल्क नहीं लिया जाएगा.

मेरे पास अलग-अलग टूल के लिए कई डेवलपर टोकन हैं. इस पायलट प्रोग्राम का मुझ पर क्या असर पड़ेगा?

इस्तेमाल का यह उदाहरण इस पायलट प्रोग्राम में शामिल नहीं है. इसलिए, इस पायलट कार्यक्रम में हिस्सा नहीं लिया जा सकता.

क्या इससे उन खातों के किसी मौजूदा एपीआई की अनुमति पर असर पड़ेगा जिन्हें मैं Google Ads API का इस्तेमाल करके मैनेज करता/करती हूं?

नहीं, इस बदलाव से Google Ads API का इस्तेमाल करके मैनेज किए जाने वाले Google Ads खातों को, एपीआई से जुड़ी मौजूदा अनुमतियों पर कोई असर नहीं पड़ेगा.

मैंने इस पायलट कार्यक्रम के लिए ऑप्ट-इन किया है और मुझे कोई समस्या या सुझाव/राय देनी है या शिकायत करनी है. मैं सहायता टीम से कैसे संपर्क करूं?

एपीआई तकनीकी सहायता पेज का इस्तेमाल करके, Google Ads API टीम से संपर्क करें और बताएं कि आपको किस तरह की समस्या है. जब भी संभव हो, अपने संगठन का आईडी, अनुरोध और रिस्पॉन्स लॉग जैसी जानकारी शामिल करें.