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

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

ऐक्सेस लेवल

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

ऐक्सेस लेवल	ऐक्सेस कर सकते हैं...	रोज़ाना के लेन-देन की सीमा1	आवेदन करने का तरीका	आम तौर पर, समीक्षा करने में कितना समय लगता है?
जांच वाले खाते का ऐक्सेस लेवल	टेस्ट खाते	हर दिन 15,000 कार्रवाइयां	निर्देश
एक्सप्लोरर का ऐक्सेस लेवल	टेस्ट और प्रोडक्शन खाते	प्रोडक्शन खातों के लिए, हर दिन 2,880 कार्रवाइयां टेस्ट खातों के लिए, हर दिन 15,000 कार्रवाइयां	निर्देश
बुनियादी ऐक्सेस लेवल	टेस्ट और प्रोडक्शन खाते	टेस्ट और प्रोडक्शन, दोनों तरह के खातों के लिए हर दिन 15,000 कार्रवाइयां	निर्देश	पांच कामकाजी दिन
स्टैंडर्ड ऐक्सेस लेवल	टेस्ट और प्रोडक्शन खाते	टेस्ट और प्रोडक्शन, दोनों खातों के लिए हर दिन अनलिमिटेड ऑपरेशन	निर्देश	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 कार्रवाइयां करने की अनुमति मिलती है. यह ज़्यादातर डेवलपर के लिए काफ़ी है.

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

अगर आपके पास टेस्ट खाते के ऐक्सेस लेवल या एक्सप्लोरर ऐक्सेस वाला डेवलपर टोकन है, तो बुनियादी ऐक्सेस लेवल के लिए इस तरह आवेदन किया जा सकता है:

1. अपने वेब ब्राउज़र में, एपीआई सेंटर पर जाएं. अगर कहा जाए, तो अपने Google Ads मैनेजर खाते में साइन इन करें.

   API Center को ऐक्सेस करना

2. पुष्टि करें कि आपका ऐक्सेस लेवल, टेस्ट खाता या एक्सप्लोरर हो.

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

4. ऐक्सेस लेवल के बगल में मौजूद ड्रॉप-डाउन ऐरो पर क्लिक करें. इसके बाद, बुनियादी ऐक्सेस के लिए आवेदन करें लिंक पर क्लिक करें.

Google Cloud प्रोजेक्ट के ब्रैंड की पुष्टि करने की प्रोसेस पूरी करें

ब्रैंड की पुष्टि करने की प्रोसेस पूरी करने की ज़रूरत नहीं है.

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

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

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

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

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

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

1. अपने वेब ब्राउज़र में, एपीआई सेंटर पर जाएं. अगर कहा जाए, तो अपने Google Ads मैनेजर खाते में साइन इन करें.

   API Center को ऐक्सेस करना

2. पुष्टि करें कि आपका ऐक्सेस लेवल बुनियादी हो.

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

4. ऐक्सेस लेवल के बगल में मौजूद ड्रॉप-डाउन ऐरो पर क्लिक करें. इसके बाद, स्टैंडर्ड ऐक्सेस के लिए आवेदन करें लिंक पर क्लिक करें.

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

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

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

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

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

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

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

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

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