क्लाउड से मैनेज किए जाने वाले ऐक्सेस लेवल

ध्यान दें: Google, इस प्रोग्राम के लिए आवेदन स्वीकार कर रहा है. साइन अप करें.

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

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

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

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

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

• ऐसा डेवलपर टोकन जिसे मंज़ूरी मिली हो

  इस विकल्प का इस्तेमाल करने के लिए, आपके पास पहले से ही मंज़ूरी वाला डेवलपर टोकन होना चाहिए. आपको अपने 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 Console प्रोजेक्ट को इस तरह तैयार करना होगा:

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

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

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

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

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

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

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

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

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

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/v18/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 के मैनेज किए जाने वाले, संगठन के अंदरूनी Cloud रिसॉर्स में से एक है. इसलिए, आपसे कोई शुल्क नहीं लिया जाएगा.

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

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

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

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

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

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