इस सुविधा की मदद से, 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 संगठन बनाने का अनुरोध किया है, तो आपको ये अतिरिक्त चरण पूरे करने होंगे:
Google आपके लिए, Google के मालिकाना हक वाला Cloud संगठन संसाधन बनाएगा. आपके Google Ads API मैनेजर खाते के सभी एडमिन को, नए संगठन में
roles/resourcemanager.projectCreatorकी भूमिका दी जाएगी.Google, आपके एपीआई संपर्क ईमेल पते पर, नई बनाई गई संगठन की संसाधन जानकारी वाला ईमेल भेजेगा.
आपको अपने Google API Console खाते में साइन इन करना होगा. इसके बाद, नए संगठन के तहत Google API Console प्रोजेक्ट को ट्रांसफ़र करने के लिए दिए गए निर्देशों का पालन करना होगा.
Google को यह बताने के लिए ईमेल का जवाब दें कि आपके प्रोजेक्ट नए संगठन में ट्रांसफ़र कर दिए गए हैं.
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/v21/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 संगठन पाने के लिए, ये स्थितियां हो सकती हैं:
आप Google Workspace या Google Cloud Identity के मौजूदा ग्राहक हैं:
उन प्रॉडक्ट का सामान्य तरीके से इस्तेमाल करने पर, आपसे हमेशा की तरह शुल्क लिया जाएगा. इस पायलट प्रोग्राम में हिस्सा लेने के लिए, Google Cloud संगठन बनाने पर आपसे कोई शुल्क नहीं लिया जाएगा.
आपने Google Cloud Identity का मुफ़्त वर्शन वाला खाता बनाया है:
Google Cloud Identity के मुफ़्त वर्शन वाले खाते के लिए साइन अप करने या इस पायलट प्रोग्राम में हिस्सा लेने के लिए Google Cloud संगठन बनाने पर, आपसे कोई शुल्क नहीं लिया जाएगा.
Google ने आपके लिए Cloud संगठन का संसाधन बनाया है:
यह Google के मैनेज किए जाने वाले इंटरनल Cloud संगठन का संसाधन है. इसलिए, आपसे कोई शुल्क नहीं लिया जाएगा.
मेरे पास अलग-अलग टूल के लिए कई डेवलपर टोकन हैं. इस पायलट प्रोग्राम का मुझ पर क्या असर पड़ेगा?
इस इस्तेमाल के उदाहरण के लिए, यह सुविधा उपलब्ध नहीं है. इसलिए, आपको इस पायलट प्रोग्राम में शामिल होने का मौका नहीं मिलेगा.
क्या इससे, Google Ads API का इस्तेमाल करके मैनेज किए जा रहे खातों के लिए, एपीआई के मौजूदा अनुमति पर कोई असर पड़ता है?
नहीं, इस बदलाव का असर Google Ads API का इस्तेमाल करके मैनेज किए जाने वाले Google Ads खातों के लिए, एपीआई के मौजूदा किसी भी अनुमति पर नहीं पड़ता.
मैंने इस पायलट प्रोग्राम के लिए ऑप्ट-इन किया है और मुझे कोई समस्या आ रही है या मुझे कोई सुझाव/राय देनी है. मैं सहायता टीम से कैसे संपर्क करूं?
एपीआई की तकनीकी सहायता वाले पेज पर जाकर, Google Ads API टीम से संपर्क करें और अपनी समस्या के बारे में बताएं. अगर हो सके, तो अपने संगठन का आईडी और अनुरोध और जवाब के लॉग जैसी जानकारी शामिल करें.