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

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

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

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

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

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

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

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

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

• एक 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 मैनेजर खाते के एपीआई केंद्र पेज पर, एपीआई से संपर्क करने की जानकारी दिखती है. साइन इन करें. इसके बाद, टूल और सेटिंग > सेटअप > एपीआई केंद्र पर जाएं.

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

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

अगर आपने 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/v24/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"

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

यहां Cloud-managed ऐक्सेस लेवल के बारे में, अक्सर पूछे जाने वाले कुछ सवाल दिए गए हैं.

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

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

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

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

क्या इस पायलट प्रोग्राम के लिए ऑप्ट-इन करने पर, कुछ समय के लिए एपीआई ऐक्सेस नहीं किया जा सकेगा?

नहीं. मंज़ूरी मिलने के बाद, 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 API का इस्तेमाल करके मैनेज किए जाने वाले Google Ads खातों के लिए, मौजूदा एपीआई ऑथराइज़ेशन पर कोई असर नहीं पड़ेगा.

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

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