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

इस सुविधा की मदद से, आपके एपीआई ऐक्सेस लेवल को 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 कंसोल प्रोजेक्ट तैयार करना

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

    स्थिति चरण
    आपके पास पहले से ही 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/v25/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. आपने Cloud Identity Free Edition खाता बनाया है:

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

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

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

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

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

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

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

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

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