ऐक्सेस लेवल और अनुमत इस्तेमाल

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

ऐक्सेस लेवल

टेबल में, एपीआई ऐक्सेस के चार अलग-अलग लेवल दिए गए हैं. अगर आपके पास Google Ads API का ऐक्सेस पहले से नहीं है, तो अपने Google Cloud प्रोजेक्ट के लिए टेस्ट ऐक्सेस लेवल पाने के लिए, एपीआई चालू करें. ऐप्लिकेशन में कुछ और चरण पूरे करके, ऐक्सेस लेवल बढ़ाया जा सकता है.

ऐक्सेस लेवल	ऐक्सेस कर सकते हैं...	रोज़ाना इस्तेमाल की सीमा ^1	आवेदन करने का तरीका	आम तौर पर, समीक्षा करने में कितना समय लगता है?
टेस्ट	टेस्ट खाते	15,000 कार्रवाइयां / दिन	टेस्ट ऐक्सेस के लिए आवेदन करना
एक्सप्लोरर बैज	टेस्ट और प्रोडक्शन खाते	प्रोडक्शन खातों के लिए, हर दिन 2,880 कार्रवाइयां टेस्ट खातों के लिए, हर दिन 15,000 कार्रवाइयां	Explorer के ऐक्सेस के लिए आवेदन करना
सामान्य	टेस्ट और प्रोडक्शन खाते	टेस्ट और प्रोडक्शन, दोनों तरह के खातों के लिए हर दिन 15,000 कार्रवाइयां	बुनियादी ऐक्सेस के लिए आवेदन करना
स्टैंडर्ड	टेस्ट और प्रोडक्शन खाते	टेस्ट और प्रोडक्शन, दोनों खातों के लिए हर दिन अनलिमिटेड ऑपरेशन	स्टैंडर्ड ऐक्सेस के लिए आवेदन करना	10 कामकाजी दिन

¹ "हर दिन" का मतलब, 24 घंटे की उस अवधि से है जिसमें आपके Google Cloud प्रोजेक्ट से एपीआई अनुरोध किए गए थे. अगर आपका ऐप्लिकेशन, पिछले 24 घंटों में आपके ऐक्सेस लेवल के लिए अनुरोध करने की सीमा से ज़्यादा अनुरोध करता है, तो आपको गड़बड़ी का मैसेज मिलेगा.

ऐक्सेस की जांच करना

Google Ads API चालू करने के बाद, आपके Google Cloud प्रोजेक्ट को टेस्ट ऐक्सेस दिया जाता है. इसका मतलब है कि प्रोजेक्ट सिर्फ़ टेस्ट खातों के लिए, Google Ads API के अनुरोध कर सकता है.

अहम जानकारी: टेस्ट खाता बनाने के तरीके के बारे में ज़्यादा जानने के लिए, टेस्ट खाते से जुड़ी गाइड पढ़ें.

टेस्टिंग के लिए ऐक्सेस पाने का आवेदन करना

अपने Google Cloud प्रोजेक्ट में Google Ads API चालू करें, ताकि आपको अपने प्रोजेक्ट के लिए टेस्ट ऐक्सेस अपने-आप मिल जाए.

एक्सप्लोरर के ऐक्सेस का लेवल

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

एक्सप्लोरर ऐक्सेस लेवल की मदद से, आपका Google Cloud प्रोजेक्ट, टेस्ट खातों और प्रोडक्शन खातों, दोनों के लिए Google Ads API अनुरोध कर सकता है. प्रोडक्शन खाते ऐसे खाते होते हैं जो असली और लाइव Google विज्ञापन दिखाते हैं. टेस्ट खाते विज्ञापन नहीं दिखाते.

एक्सप्लोरर ऐक्सेस लेवल की मदद से, आपका Google Cloud प्रोजेक्ट हर दिन प्रोडक्शन खातों के ख़िलाफ़ 2,880 कार्रवाइयां कर सकता है. यह सुविधा, ज़्यादातर डेवलपर के लिए एपीआई का इस्तेमाल शुरू करने और बुनियादी ऑटोमेशन बनाने के लिए काफ़ी है.

एक्सप्लोरर ऐक्सेस लेवल में, इन सुविधाओं का ऐक्सेस नहीं मिलता. अगर आपको इन सुविधाओं का इस्तेमाल करना है, तो आपको बुनियादी ऐक्सेस लेवल या स्टैंडर्ड ऐक्सेस लेवल के लिए आवेदन करना होगा.

सीमित सुविधाएं	पाबंदी वाली सेवाएं और तरीके
खाता बनाएं	CustomerService.CreateCustomerClient
यूज़र मैनेजमेंट	CustomerUserAccessInvitationService CustomerUserAccessService
प्लानिंग	KeywordPlanService KeywordPlanIdeaService KeywordPlanCampaignService KeywordPlanCampaignKeywordService KeywordPlanAdGroupService KeywordPlanAdGroupKeywordService AudienceInsightsService ReachPlanService
खाते की बिलिंग और पेमेंट	PaymentsAccountService BillingSetupService AccountBudgetProposalService InvoiceService

एक्सप्लोरर ऐक्सेस लेवल के लिए आवेदन करना

1. अपने Google Cloud प्रोजेक्ट में, Google Ads API की खास जानकारी वाले पेज पर जाएं.
2. पुष्टि करें कि पेज पर, आपका मौजूदा ऐक्सेस लेवल टेस्ट के तौर पर दिख रहा हो.
3. ऐक्सेस लेवल अपग्रेड करें सेक्शन को बड़ा करने के लिए क्लिक करें.
4. पुष्टि करें कि अगला ऐक्सेस लेवल, एक्सप्लोरर के तौर पर दिख रहा हो.
5. एक्सप्लोरर के ऐक्सेस लेवल के लिए आवेदन करने के लिए, ऐक्सेस के लिए आवेदन करें बटन पर क्लिक करें.

आवेदन सबमिट करने के बाद, Google आपके प्रोजेक्ट के एपीआई ऐक्सेस लेवल को अपने-आप एक्सप्लोरर पर अपग्रेड कर सकता है.

बुनियादी ऐक्सेस लेवल

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

बुनियादी ऐक्सेस लेवल की मदद से, आपका Google Cloud प्रोजेक्ट हर दिन ज़्यादा से ज़्यादा 15,000 कार्रवाइयां कर सकता है. यह ज़्यादातर डेवलपर के लिए काफ़ी है.

बुनियादी ऐक्सेस लेवल के लिए आवेदन करना

ध्यान दें: बेसिक ऐक्सेस लेवल के लिए आवेदन करने से पहले, अपने Google Cloud प्रोजेक्ट के लिए ब्रैंड की पुष्टि करना ज़रूरी है. ज़्यादा जानने के लिए, ब्रैंड की पुष्टि करने से जुड़ी गाइड देखें.

1. अपने Google Cloud प्रोजेक्ट में, Google Ads API की खास जानकारी वाले पेज पर जाएं.
2. पुष्टि करें कि पेज पर, आपका मौजूदा ऐक्सेस लेवल एक्सप्लोरर के तौर पर दिख रहा हो.
3. ऐक्सेस लेवल अपग्रेड करें सेक्शन को बड़ा करने के लिए क्लिक करें.
4. पुष्टि करें कि अगला ऐक्सेस लेवल, बेसिक के तौर पर दिख रहा हो.
5. पुष्टि करें कि आपको ऐसी कोई चेतावनी नहीं मिली है जिसमें यह बताया गया हो कि आपने अपने प्रोजेक्ट के लिए ब्रैंड की पुष्टि नहीं की है. अगर ऐसा होता है, तो जारी रखने से पहले, निर्देशों का पालन करें और ब्रैंड की पुष्टि की प्रक्रिया पूरी करें.
6. बुनियादी ऐक्सेस लेवल के लिए आवेदन करने के लिए, ऐक्सेस के लिए आवेदन करें बटन पर क्लिक करें.

आवेदन सबमिट करने के बाद, Google आपके प्रोजेक्ट के एपीआई ऐक्सेस लेवल को Basic पर अपने-आप अपग्रेड कर सकता है.

स्टैंडर्ड ऐक्सेस का लेवल

स्टैंडर्ड ऐक्सेस लेवल की मदद से, आपका Google Cloud प्रोजेक्ट सभी सेवाओं के लिए हर दिन अनलिमिटेड ऑपरेशन कर सकता है. अलग-अलग सेवाओं और सुविधाओं पर, अब भी दर से जुड़ी सीमाएं और पाबंदियां लागू हो सकती हैं. ये सीमाएं और पाबंदियां, उन सुविधाओं के लिए खास तौर पर तय की गई हैं. ये तब भी लागू रहेंगी, जब आपके प्रोजेक्ट का ऐक्सेस लेवल स्टैंडर्ड हो.

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

स्टैंडर्ड ऐक्सेस लेवल के लिए आवेदन करना

1. अपने Google Cloud प्रोजेक्ट में, Google Ads API की खास जानकारी वाले पेज पर जाएं.
2. पुष्टि करें कि पेज पर, आपका मौजूदा ऐक्सेस लेवल Basic के तौर पर दिख रहा हो.
3. ऐक्सेस लेवल अपग्रेड करें सेक्शन को बड़ा करने के लिए क्लिक करें.
4. पुष्टि करें कि अगला ऐक्सेस लेवल, स्टैंडर्ड के तौर पर दिख रहा हो.
5. स्टैंडर्ड ऐक्सेस लेवल के लिए आवेदन करने के लिए, आवेदन शुरू करें बटन पर क्लिक करें.

स्टैंडर्ड ऐक्सेस के लिए किए गए आवेदन की मैन्युअल तरीके से पूरी ऑडिट की जाती है. अपने टूल की सुविधाओं और उसके टारगेट ऑडियंस के बारे में सवालों के जवाब देने के लिए तैयार रहें. अगर आपके टूल का इस्तेमाल बाहरी उपयोगकर्ता करते हैं, तो अपने टूल में डेमो के लिए साइन इन ऐक्सेस देने के लिए तैयार रहें. ध्यान दें कि आपके टूल को ज़रूरी तौर पर मुहैया कराई जाने वाली सुविधाओं से जुड़ी नीति का पालन करना होगा.

समीक्षा की पूरी प्रोसेस के दौरान, Google की अनुपालन टीम आपके ईमेल पते का इस्तेमाल करके आपसे संपर्क करेगी. पक्का करें कि आप स्टैंडर्ड ऐक्सेस के लिए किए गए आवेदन पर, अनुपालन टीम की क्वेरी का तुरंत जवाब दें. समीक्षा पूरी होने पर, Google आपको ईमेल से इसकी सूचना भेजेगा.

एपीआई कोटा और सिस्टम की दर से जुड़ी सीमाएं

ऐक्सेस लेवल चाहे जो भी हो, एपीआई के सभी ऑपरेशन पर सिस्टम की दर से जुड़ी सीमाएं लागू होती हैं. इससे यह तय होता है कि किसी समयावधि में कितने ऑपरेशन किए जा सकते हैं. जैसे, एक घंटे में किए जाने वाले ऑपरेशन की संख्या. रेट लिमिट से जुड़ी गड़बड़ियों को ठीक करने के बारे में ज़्यादा जानने के लिए, गड़बड़ी के टाइप देखें.

अलग-अलग सेवाओं के लिए, अतिरिक्त सीमाएं और कोटा से जुड़ी पाबंदियां लागू की जा सकती हैं. ऐसा इन वजहों से हो सकता है: प्रॉडक्ट डिज़ाइन से जुड़ी सीमाएं, प्रॉडक्ट की नीति से जुड़ी पाबंदियां, एपीआई की परफ़ॉर्मेंस, और इंतज़ार के समय से जुड़ी बातें. इन पाबंदियों के बारे में ज़्यादा जानने के लिए, एपीआई कोटा के बारे में दस्तावेज़ देखें.

अनुमति के साथ इस्तेमाल करना

अनुमति के साथ इस्तेमाल करने की सुविधा, सिर्फ़ उन Google Cloud प्रोजेक्ट पर लागू होती है जिनके लिए स्टैंडर्ड ऐक्सेस लेवल उपलब्ध है. Google Ads API का इस्तेमाल किस मकसद से किया जा रहा है, इसके आधार पर अनुमत इस्तेमाल तय किया जाता है. इन अनुमतियों से यह तय होता है कि आपका टूल, एपीआई की किन सुविधाओं का इस्तेमाल कर सकता है. इस बारे में यहां दी गई टेबल में बताया गया है:

अनुमति के साथ इस्तेमाल करना	ब्यौरा
विज्ञापन बनाना / मैनेज करना	Google Ads कैंपेन, विज्ञापन ग्रुप, विज्ञापन, और कीवर्ड बनाने और मैनेज करने के लिए, एपीआई की सभी सेवाओं का ऐक्सेस दें.
रिपोर्टिंग	सिर्फ़ GoogleAdsService.Search या GoogleAdsService.SearchStream अनुरोध करें या सिर्फ़ पढ़ने के लिए कॉल करें. यह उन डेवलपर के लिए है जो सिर्फ़ आंकड़ों का अनुरोध करने के लिए एपीआई का इस्तेमाल करते हैं.
कीवर्ड और सुझावों पर रिसर्च करना	Google Cloud प्रोजेक्ट को RecommendationService, KeywordPlanIdeaService, और KeywordPlanService को ऐक्सेस करने की अनुमति दें. इसका इस्तेमाल सिर्फ़ उन टूल के लिए किया जाता है जिन्हें Google Ads कैंपेन बनाने और मैनेज करने में मदद करने के लिए सुझावों की ज़रूरत होती है.

अनुमति के मुताबिक इस्तेमाल करने का तरीका बदलना

अगर आपके Google Cloud प्रोजेक्ट को स्टैंडर्ड ऐक्सेस लेवल के लिए मंज़ूरी मिल गई है, तो अनुमति के साथ इस्तेमाल करने के लिए आवेदन भरें. अगर आपको अपने टूल के इस्तेमाल की अनुमति को अपडेट करना है या अपने क्लाइंट को टूल का ऐक्सेस देना है, तो आवेदन फ़ॉर्म भरें.