आपके Google Cloud प्रोजेक्ट को एक ऐक्सेस लेवल और "इस्तेमाल की अनुमति" असाइन की गई है. ऐक्सेस लेवल से यह तय होता है कि आपके पास प्रोडक्शन खातों को ऐक्सेस करने की अनुमति है या नहीं. साथ ही, इससे यह भी तय होता है कि हर दिन कितनी कार्रवाइयां और अनुरोध किए जा सकते हैं. इस्तेमाल करने की अनुमति से यह तय होता है कि प्रोजेक्ट के लिए, Google Ads API की किन सुविधाओं का इस्तेमाल किया जा सकता है.
Cloud Console में, Google Ads API की खास जानकारी पर जाएं
ऐक्सेस लेवल
टेबल में, एपीआई ऐक्सेस के चार अलग-अलग लेवल दिए गए हैं. अगर आपके पास पहले से Google Ads API का ऐक्सेस नहीं है, तो अपने Google Cloud प्रोजेक्ट के लिए टेस्ट ऐक्सेस लेवल पाने के लिए, एपीआई को चालू करें. इसके बाद, प्रोडक्शन खातों को ऐक्सेस करने के लिए, Google Ads API के होम पेज पर जाकर, एक्सप्लोरर ऐक्सेस के लिए आवेदन करें.
| ऐक्सेस लेवल | ऐक्सेस कर सकता/सकती है... | रोज़ाना इस्तेमाल की सीमा 1 | आवेदन करने का तरीका | आम तौर पर, समीक्षाओं में कितना समय लगता है? |
|---|---|---|---|---|
| टेस्ट | टेस्ट खाते | हर दिन 15,000 कार्रवाइयां | टेस्ट ऐक्सेस के लिए आवेदन करना | |
| एक्सप्लोरर बैज | टेस्ट और प्रोडक्शन खाते | प्रोडक्शन खातों के लिए, हर दिन 2,880 ऑपरेशन टेस्ट खातों के लिए, हर दिन 15,000 ऑपरेशन |
एक्सप्लोरर ऐक्सेस के लिए आवेदन करना | |
| सामान्य | टेस्ट और प्रोडक्शन खाते | टेस्ट और प्रोडक्शन, दोनों खातों के लिए हर दिन 15,000 ऑपरेशन | बेसिक ऐक्सेस के लिए आवेदन करना | |
| स्टैंडर्ड | टेस्ट और प्रोडक्शन खाते | टेस्ट और प्रोडक्शन, दोनों खातों के लिए हर दिन अनलिमिटेड ऑपरेशन | स्टैंडर्ड ऐक्सेस के लिए आवेदन करना | 10 कामकाजी दिन |
1 "हर दिन" का मतलब, 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.CreateCustomerClientCustomerClientLinkServiceCustomerManagerLinkService |
| यूज़र मैनेजमेंट | CustomerUserAccessInvitationServiceCustomerUserAccessService |
| प्लानिंग | KeywordPlanServiceKeywordPlanIdeaServiceKeywordPlanCampaignServiceKeywordPlanCampaignKeywordServiceKeywordPlanAdGroupServiceKeywordPlanAdGroupKeywordServiceAudienceInsightsServiceReachPlanService |
| खाते की बिलिंग और पेमेंट | PaymentsAccountServiceBillingSetupServiceAccountBudgetProposalServiceInvoiceService |
| कई पक्षों से अनुमति | MultiPartyAuthReviewService |
एक्सप्लोरर ऐक्सेस लेवल के लिए आवेदन करना
- अपने Google Cloud प्रोजेक्ट में, Google Ads API के होम पेज पर जाएं.
- पुष्टि करें कि पेज पर आपका मौजूदा ऐक्सेस लेवल, टेस्ट के तौर पर दिख रहा हो.
- ऐक्सेस लेवल अपग्रेड करें सेक्शन को बड़ा करने के लिए क्लिक करें.
- पुष्टि करें कि अगला ऐक्सेस लेवल, एक्सप्लोरर के तौर पर दिख रहा है.
- एक्सप्लोरर ऐक्सेस लेवल के लिए आवेदन करने के लिए, ऐक्सेस के लिए आवेदन करें बटन पर क्लिक करें.
आवेदन सबमिट करने के बाद, Google आपके प्रोजेक्ट के एपीआई ऐक्सेस लेवल को अपने-आप एक्सप्लोरर पर अपग्रेड कर सकता है.
बेसिक ऐक्सेस लेवल
बेसिक ऐक्सेस लेवल की मदद से, आपका Google Cloud प्रोजेक्ट, टेस्ट खातों और प्रोडक्शन खातों, दोनों के लिए Google Ads API के अनुरोध कर सकता है. प्रोडक्शन खाते ऐसे खाते होते हैं जो असल और लाइव Google विज्ञापन दिखाते हैं. टेस्ट खातों से विज्ञापन नहीं दिखाए जाते.
बेसिक ऐक्सेस लेवल की मदद से, आपके Google Cloud प्रोजेक्ट में हर दिन ज़्यादा से ज़्यादा 15,000 कार्रवाइयां की जा सकती हैं. ज़्यादातर डेवलपर के लिए यह तरीका काफ़ी है.
बेसिक ऐक्सेस लेवल के लिए आवेदन करना
- अपने Google Cloud प्रोजेक्ट में, Google Ads API के होम पेज पर जाएं.
- पुष्टि करें कि पेज पर आपका मौजूदा ऐक्सेस लेवल, एक्सप्लोरर के तौर पर दिख रहा हो.
- ऐक्सेस लेवल अपग्रेड करें सेक्शन को बड़ा करने के लिए क्लिक करें.
- पुष्टि करें कि अगला ऐक्सेस लेवल, बेसिक के तौर पर दिख रहा है.
- पुष्टि करें कि ऐसी कोई चेतावनी न हो जिससे यह पता चले कि आपने अपने प्रोजेक्ट के लिए ब्रैंड की पुष्टि नहीं की है. अगर ऐसा है, तो आगे बढ़ने से पहले, ब्रैंड की पुष्टि करने के लिए निर्देशों का पालन करें.
- बेसिक ऐक्सेस लेवल के लिए आवेदन करने के लिए, ऐक्सेस के लिए आवेदन करें बटन पर क्लिक करें.
आवेदन सबमिट करने के बाद, Google आपके प्रोजेक्ट के एपीआई ऐक्सेस लेवल को अपने-आप बेसिक लेवल पर अपग्रेड कर सकता है.
स्टैंडर्ड ऐक्सेस का लेवल
स्टैंडर्ड ऐक्सेस लेवल की मदद से, आपके Google Cloud प्रोजेक्ट को सभी सेवाओं के लिए, हर दिन अनलिमिटेड कार्रवाइयां करने की अनुमति मिलती है. अलग-अलग सेवाओं और सुविधाओं के लिए, अब भी अनुरोध संख्या सीमित करने की सुविधा और पाबंदियां लागू हो सकती हैं. ये पाबंदियां उन सुविधाओं के लिए खास तौर पर लागू होती हैं. भले ही, आपके प्रोजेक्ट का ऐक्सेस लेवल स्टैंडर्ड हो, फिर भी ये पाबंदियां लागू रहेंगी.
स्टैंडर्ड ऐक्सेस लेवल सिर्फ़ उन डेवलपर को दिया जाता है जिन्हें Google Ads API के अनलिमिटेड ऑपरेशन की ज़रूरत होती है. जैसे, बड़ी कंपनियां या ऐसे टूल जो कई उपयोगकर्ताओं को सेवा देते हैं.
स्टैंडर्ड ऐक्सेस लेवल के लिए आवेदन करना
- अपने Google Cloud प्रोजेक्ट में, Google Ads API के होम पेज पर जाएं.
- पुष्टि करें कि पेज पर आपका मौजूदा ऐक्सेस लेवल बेसिक के तौर पर दिख रहा है.
- ऐक्सेस लेवल अपग्रेड करें सेक्शन को बड़ा करने के लिए क्लिक करें.
- पुष्टि करें कि अगला ऐक्सेस लेवल, स्टैंडर्ड के तौर पर दिख रहा है.
- स्टैंडर्ड ऐक्सेस लेवल के लिए आवेदन करने के लिए, आवेदन शुरू करें बटन पर क्लिक करें.
स्टैंडर्ड ऐक्सेस के लिए किए गए आवेदन की मैन्युअल तरीके से बारीकी से समीक्षा की जाती है. अपने टूल की सुविधाओं और टारगेट ऑडियंस के बारे में पूछे जाने वाले सवालों के जवाब देने के लिए तैयार रहें. अगर आपके टूल का इस्तेमाल बाहरी उपयोगकर्ता करते हैं, तो अपने टूल के लिए डेमो साइन-इन ऐक्सेस देने के लिए तैयार रहें. ध्यान दें कि आपके टूल को ज़रूरी तौर पर मुहैया कराई जाने वाली सुविधाओं का पालन करना होगा.
समीक्षा की पूरी प्रोसेस के दौरान, Google की कंप्लायंस टीम आपके ईमेल पते का इस्तेमाल करके आपसे संपर्क करेगी. स्टैंडर्ड ऐक्सेस के लिए किए गए आवेदन को आगे बढ़ाने के लिए, पक्का करें कि आपने अनुपालन टीम के सवालों का जवाब तुरंत दिया हो. समीक्षा पूरी होने पर, Google आपको ईमेल से इसकी सूचना भेजेगा.
एपीआई कोटा और सिस्टम के अनुरोधों की संख्या की सीमाएं
ऐक्सेस लेवल चाहे जो भी हो, एपीआई के सभी ऑपरेशन पर सिस्टम रेट की सीमाएं लागू होती हैं. इनसे यह तय होता है कि किसी समयावधि में कितने ऑपरेशन किए जा सकते हैं. जैसे, हर घंटे किए जाने वाले ऑपरेशन की संख्या. अनुरोध संख्या सीमित करने से जुड़ी गड़बड़ियों को ठीक करने के तरीके के बारे में ज़्यादा जानने के लिए, गड़बड़ियों के टाइप देखें.
अलग-अलग सेवाओं के लिए, अतिरिक्त सीमाएं और कोटा से जुड़ी पाबंदियां लागू की जा सकती हैं. ऐसा प्रॉडक्ट डिज़ाइन की सीमाओं, प्रॉडक्ट की नीति से जुड़ी पाबंदियों, एपीआई की परफ़ॉर्मेंस, और इंतज़ार के समय जैसी वजहों से हो सकता है. इन पाबंदियों के बारे में ज़्यादा जानने के लिए, एपीआई कोटा के बारे में दस्तावेज़ देखें.
इस्तेमाल करने की अनुमति
अनुमति के साथ इस्तेमाल करने की सुविधा, सिर्फ़ स्टैंडर्ड ऐक्सेस लेवल वाले Google Cloud प्रोजेक्ट पर लागू होती है. Google Ads API के इस्तेमाल की अनुमति, इसके इस्तेमाल के मकसद के आधार पर दी जाती है. इन अनुमतियों से यह तय होता है कि आपका टूल, एपीआई की किन सुविधाओं का इस्तेमाल कर सकता है. इस बारे में यहां दी गई टेबल में बताया गया है:
| इस्तेमाल करने की अनुमति | ब्यौरा |
|---|---|
| विज्ञापन बनाना / मैनेज करना | Google Ads कैंपेन, विज्ञापन ग्रुप, विज्ञापन, और कीवर्ड बनाने और उन्हें मैनेज करने के लिए, एपीआई की सभी सेवाओं का ऐक्सेस दें. |
| रिपोर्टिंग | सिर्फ़ GoogleAdsService.Search या GoogleAdsService.SearchStream अनुरोध या सिर्फ़ पढ़ने के लिए कॉल करें. यह उन डेवलपर के लिए है जो सिर्फ़ आंकड़ों का अनुरोध करने के लिए एपीआई का इस्तेमाल करते हैं. |
| कीवर्ड और सुझावों के बारे में रिसर्च करना | Google Cloud प्रोजेक्ट को RecommendationService, KeywordPlanIdeaService, और KeywordPlanService को ऐक्सेस करने की अनुमति दें. इसका इस्तेमाल सिर्फ़ वे टूल करते हैं जिन्हें Google Ads कैंपेन बनाने और मैनेज करने में मदद करने के लिए सुझावों की ज़रूरत होती है. |
इस्तेमाल करने की अनुमति में बदलाव करना
अगर आपके Google Cloud प्रोजेक्ट को स्टैंडर्ड ऐक्सेस लेवल के लिए मंज़ूरी मिल गई है, तो इस्तेमाल की अनुमति को अपडेट करने के लिए आवेदन भरा जा सकता है. अगर आपको अनुमति वाले इस्तेमाल को अपडेट करना है या अपने क्लाइंट को टूल का ऐक्सेस देना है, तो आवेदन फ़ॉर्म भरें.