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

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

ऐक्सेस लेवल

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

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

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

टेस्ट खाते का ऐक्सेस लेवल

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

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

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

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

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. अपने वेब ब्राउज़र में, https://ads.google.com/aw/apicenter पर जाएं. अगर आपसे कहा जाए, तो अपने Google Ads मैनेजर खाते में साइन इन करें.

    एपीआई केंद्र को ऐक्सेस करना

  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. अपने वेब ब्राउज़र में, https://ads.google.com/aw/apicenter पर जाएं. अगर आपसे कहा जाए, तो अपने Google Ads मैनेजर खाते में साइन इन करें.

    एपीआई केंद्र को ऐक्सेस करना

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

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

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

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

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

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

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

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

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

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

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

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