Google Advertising and Measurement Community के Discord सर्वर और YouTube पर, 26 मार्च को सुबह 11:00 बजे ईएसटी पर हमसे लाइव जुड़ें! हम Google Ads API के v23.2 वर्शन में जोड़ी गई नई सुविधाओं के बारे में चर्चा करेंगे.

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

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 कार्रवाइयां करने की अनुमति मिलती है. ज़्यादातर डेवलपर के लिए यह काफ़ी है.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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