हमारे प्रॉडक्ट के बारे में चर्चा करने और सुझाव देने के लिए, Google विज्ञापन और मेज़रमेंट कम्यूनिटी सर्वर में Google Ads के आधिकारिक Discord चैनल से जुड़ें.

इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

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

ऐक्सेस लेवल

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

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

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

जांच वाले खाते का ऐक्सेस लेवल

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

टेस्ट खाते के ऐक्सेस लेवल के लिए आवेदन करने का तरीका

टेस्ट खाते के ऐक्सेस का लेवल अपने-आप पाने के लिए, Google Ads के वेब इंटरफ़ेस पर Google Ads API के लिए साइन अप करें.

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

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

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

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

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

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

Google Ads के वेब इंटरफ़ेस पर, Google Ads API के लिए साइन-अप करें. कुछ मामलों में, साइन अप करने के बाद Google आपके डेवलपर टोकन को एक्सप्लोरर ऐक्सेस लेवल पर अपने-आप अपग्रेड कर सकता है.

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

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

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

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

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

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

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

स्टैंडर्ड ऐक्सेस लेवल की मदद से, डेवलपर टोकन को ज़्यादातर सेवाओं के लिए हर दिन असीमित संख्या में कार्रवाइयां करने की अनुमति मिलती है. इसमें GoogleAdsService Search और SearchStream शामिल हैं. हालांकि, इनके अलावा और भी चीज़ें शामिल हो सकती हैं. स्टैंडर्ड ऐक्सेस लेवल की सीमाओं और अपवादों के बारे में ज़्यादा जानकारी के लिए, एपीआई कोटा देखें.

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

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

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

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

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

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

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

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

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

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

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

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