क्या आपको Google Ads API के बारे में सुझाव, शिकायत या राय देनी है? उपयोगकर्ताओं पर की जाने वाली रिसर्च में हिस्सा लेने का न्योता पाने के लिए, साइन अप करें!

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

Google Ads डेवलपर स्टार्टर चेकलिस्ट

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

इस सूची में तीन तरह के आइटम शामिल होते हैं:

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

अगर चेकलिस्ट को प्रिंट किया जा रहा है, तो बाईं ओर मौजूद चेकबॉक्स का इस्तेमाल करके, यह मार्क किया जा सकता है कि कौनसे चरण पूरे हो चुके हैं. इस चेकलिस्ट में, Google Ads API के दस्तावेज़ों में मौजूद जानकारी को पढ़ने का सुझाया गया क्रम दिया गया है.

ऐक्सेस और सेटअप करना

	अपने टॉप-लेवल मैनेजर खाते के एपीआई सेंटर से, अपना डेवलपर टोकन पाएं. एपीआई ऐक्सेस फ़ॉर्म के सभी फ़ील्ड को भरना ज़रूरी है. साथ ही, नियम और शर्तें स्वीकार करनी होंगी. पक्का करें कि आपने एपीआई के लिए जो संपर्क ईमेल पता दिया है वह नियमित तौर पर निगरानी में रखे जाने वाले इनबॉक्स पर ले जाता हो. आपको टेस्ट खाते के ऐक्सेस लेवल वाला डेवलपर टोकन जारी किया जाएगा.
	टेस्ट खातों की मदद से, Google Ads API को आज़माने के लिए, आपको बस इतना करना होगा. कैंपेन और विज्ञापन बनाने के लिए, टेस्ट खातों का इस्तेमाल किया जा सकता है. हालांकि, आपका कोई भी विज्ञापन असल में नहीं दिखेगा (लागत नहीं होगी) और रिपोर्टिंग के सभी आंकड़े 0 होंगे. प्रोडक्शन खातों को ऐक्सेस करने के लिए, आपके डेवलपर टोकन को टोकन की समीक्षा करने वाली हमारी टीम से मंज़ूरी लेनी होगी.
	प्रोडक्शन ट्रैक के ऐक्सेस के लिए, अपने टोकन को मंज़ूरी पाने के लिए, आपको हमारा फ़ॉलो-अप ऐप्लिकेशन फ़ॉर्म भरना होगा. साथ ही, यह बताना होगा कि आपको एपीआई का इस्तेमाल कैसे करना है. आपको डिज़ाइन का दस्तावेज़ भी देना होगा. शुरू करने के लिए, हमारे टेंप्लेट का इस्तेमाल किया जा सकता है. ज़्यादा से ज़्यादा जानकारी दें. अगर टोकन की समीक्षा करने वाली हमारी टीम को ज़्यादा जानकारी चाहिए, तो वह आपसे संपर्क करेगी. हालांकि, अगर दो कामकाजी दिनों के अंदर कोई जवाब नहीं मिलता है, तो आपके पास हमारे संपर्क फ़ॉर्म के ज़रिए भी हमसे संपर्क करने का विकल्प है.
	डेवलपर टोकन को मंज़ूरी मिलने के बाद, इसका इस्तेमाल करके प्रोडक्शन खातों को एपीआई कॉल किए जा सकते हैं. शुरुआत में, आपको बुनियादी ऐक्सेस दिया जाएगा. इस ऐक्सेस की मदद से, हर दिन 15,000 ऑपरेशन किए जा सकते हैं. साथ ही, हर दिन 1,000 बार 'प्रॉपर्टी पाएं' ऑपरेशन किया जा सकता है.
	अगर आपका आवेदन अस्वीकार कर दिया जाता है, तो आपको ईमेल से इसकी वजहें बताई जाएंगी. अपने आवेदन में बदलाव किए जा सकते हैं. साथ ही, समस्या को हल करने के तरीके के बारे में ज़्यादा जानकारी दी जा सकती है और फिर से आवेदन किया जा सकता है.

क्लाइंट लाइब्रेरी सेट अप करना

एपीआई के लिए आपके अनुरोधों की पुष्टि करने के लिए, हम OAuth 2.0 का इस्तेमाल करते हैं. OAuth 2.0 के लिए क्रेडेंशियल सेट अप करने के लिए, OAuth 2.0 गाइड में दिए गए निर्देशों का पालन करें. समस्या हल करने के लिए, OAuth 2.0 प्लैटफ़ॉर्म का इस्तेमाल किया जा सकता है.

हम कुछ सामान्य प्रोग्रामिंग भाषाओं के लिए क्लाइंट लाइब्रेरी उपलब्ध कराते हैं. आपको जिस भाषा का इस्तेमाल करना है उसके लिए लाइब्रेरी डाउनलोड करें और पहले से हासिल किए गए क्रेडेंशियल की मदद से, उसकी कॉन्फ़िगरेशन फ़ाइल सेट अप करें.

डेवलपर टोकन - ऐक्सेस लेवल

ऐक्सेस लेवल के बारे में पढ़ें और तय करें कि आने वाले समय में, आपके टूल को हर दिन 15,000 से ज़्यादा ऑपरेशन की ज़रूरत होगी या नहीं. अगर ऐसा है, तो आपको स्टैंडर्ड ऐक्सेस के लिए आवेदन करना होगा. इससे आपको हर दिन अनलिमिटेड mutate ऑपरेशन, GoogleAdsService.Search, और GoogleAdsService.SearchStream अनुरोध करने की सुविधा मिलेगी. हालांकि, इसके लिए भी 1,000 बार डेटा पाने की रोज़ाना की सीमा लागू होती है.

किराया शीट देखकर जानें कि आपके ऐक्सेस लेवल के लिए, ऑपरेशन का हिसाब कैसे लगाया जाता है. ध्यान दें कि page_token फ़ील्ड सेट वाले GoogleAdsService.Search अनुरोधों को, ऑपरेशन की सीमा में नहीं गिना जाता.

आवश्यक न्यूनतम कार्यक्षमता (RMF)

	ज़रूरी तौर पर मुहैया कराई जाने वाली सुविधाओं (आरएमएफ़) के बारे में पढ़ें. यह टूल के टाइप के आधार पर, उन फ़ंक्शन का एक सेट होता है जिन्हें आपके टूल में लागू करना ज़रूरी होता है.
	ऐसे टूल जिन्हें बुनियादी ऐक्सेस के साथ इस्तेमाल किया जा सकता है, यानी हर दिन 15,000 से कम अनुरोध करने वाले टूल, आरएमएफ़ से छूट पाते हैं. विज्ञापन देने वाले लोगों या कंपनियों के पास जिन टूल का ऐक्सेस नहीं होता और जिन्हें सिर्फ़ इंटरनल इस्तेमाल के लिए बनाया गया है उन्हें आरएमएफ़ से छूट मिली है. अगर आपका टूल सिर्फ़ रिपोर्टिंग करता है, तो सिर्फ़ रिपोर्टिंग आरएमएफ़ लागू होगा. अगर आपका टूल बहुत सीमित और खास है, जैसे कि सिर्फ़ Shopping या ऐप्लिकेशन का प्रमोशन, तो आरएमएफ का सिर्फ़ वह हिस्सा लागू होगा जिसका इस्तेमाल आपके टूल में किया जाता है. अगर आपको यह पक्के तौर पर नहीं पता कि आपके टूल पर आरएमएफ़ नीति लागू होती है या नहीं, तो Google Ads API की कंप्लायन्स टीम से संपर्क करें.
	आरएमएफ़ को सही तरीके से लागू न करने पर क्या होता है, यह जानने के लिए नियमों का पालन न करने पर लगने वाले शुल्क के बारे में पढ़ें.
	अगर आपके टूल का इस्तेमाल आपके संगठन से बाहर किया जाना है (दूसरे शब्दों में, यह सिर्फ़ संगठन के लिए इस्तेमाल किया जाने वाला टूल नहीं है), तो स्टैंडर्ड ऐक्सेस के लिए आवेदन करने से पहले, उसमें लागू आरएमएफ़ लागू करने होंगे. ध्यान रखें कि एपीआई में बदलाव होने पर, आरएमएफ में भी बदलाव हो सकता है. अगर आपको स्टैंडर्ड ऐक्सेस के लिए आवेदन करना है, तो आपको अपने टूल को नए आरएमएफ़ के साथ अप-टू-डेट रखना होगा.
	पक्का करें कि आपका टूल, लागू होने वाले आरएमएफ़ लागू करता हो.
	स्टैंडर्ड ऐक्सेस के लिए आवेदन करें.

एपीआई का इस्तेमाल शुरू करना

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

कोड के उदाहरण

	एपीआई के साथ काम करने का तरीका जानने के लिए, हमारा सैंपल कोड देखें और उसे चलाएं. हमारा सुझाव है कि Google Ads के बुनियादी ऑब्जेक्ट को मैनेज करने का तरीका समझने के लिए, कम से कम ये उदाहरण चलाएं.
	बुनियादी कार्रवाइयां > कैंपेन पाना
	बुनियादी कार्रवाइयां > बड़े किए गए टेक्स्ट विज्ञापन पाना
	सामान्य कार्रवाइयां > कैंपेन जोड़ें
	बुनियादी कार्रवाइयां > कीवर्ड जोड़ना
	सामान्य कार्रवाइयां > कीवर्ड अपडेट करें
	कैंपेन मैनेजमेंट > अस्वीकार किए गए सभी विज्ञापन देखें
	कैंपेन मैनेजमेंट > कैंपेन बिड मॉडिफ़ायर जोड़ें
	खाता मैनेजमेंट > खाते की जानकारी पाएं
	खाता मैनेजमेंट > ग्राहक बनाएं
	खाता मैनेजमेंट > खाते में हुए बदलावों की जानकारी पाएं

रिपोर्टिंग

	रिपोर्टिंग के लिए, आपको ऐसे खाते का इस्तेमाल करना होगा जिससे परफ़ॉर्मेंस मेट्रिक जनरेट करने के लिए, विज्ञापन दिखाए जा रहे हों. हमारा सुझाव है कि यह अवधि कम से कम सात दिन होनी चाहिए.
	रिपोर्टिंग की खास जानकारी और उदाहरण देखें. इससे, आपको पिछले 30 दिनों में किसी खाते की परफ़ॉर्मेंस की खास जानकारी मिलेगी. इसके लिए, Google Ads रिपोर्टिंग में GoogleAdsService को सटीक जानकारी देने वाले सोर्स के तौर पर इस्तेमाल किया जाता है.
	क्वेरी के व्याकरण, क्वेरी के स्ट्रक्चर, और संसाधन, सेगमेंट, और मेट्रिक के कॉन्सेप्ट को समझने के लिए, Google Ads क्वेरी लैंग्वेज (GAQL) पढ़ें.
	`*_view` संसाधनों की मदद से, अलग-अलग शर्तों के लिए परफ़ॉर्मेंस डेटा को वापस लाने का तरीका जानने के लिए, शर्तों के हिसाब से मेट्रिक के बारे में पढ़ें. उदाहरण के लिए, KeywordView, TopicView, और GenderView.

इंटरैक्टिव Google Ads क्वेरी बिल्डर

किसी खास संसाधन के लिए, Google Ads क्वेरी लैंग्वेज स्टेटमेंट बनाने के लिए, इस टूल में एडिटर का इस्तेमाल करें. उदाहरण के लिए, AdGroup. जनरेट किए गए GAQL स्टेटमेंट को कॉपी करके, अपने ऐप्लिकेशन में चिपकाएं.

कीवर्ड रिसर्च

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

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

कोड के उदाहरण

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

बजट को ऑटोमेट करना

	Google Ads में उपलब्ध बिलिंग के विकल्पों को समझने के लिए, पेमेंट के तरीकों और सेटिंग के बारे में पढ़ें. जैसे, अपने-आप पैसे चुकाने की सुविधा, मैन्युअल पेमेंट, महीने का इनवॉइस (क्रेडिट लाइन).
	अगर महीने का इनवॉइस इस्तेमाल नहीं किया जा रहा है और आपको इस सुविधा के लिए रजिस्टर नहीं करना है, तो इस सेक्शन को छोड़ें.
	प्रोग्राम के हिसाब से पेमेंट्स प्रोफ़ाइल और पेमेंट्स खातों को मैनेज करने का तरीका जानने के लिए, बिलिंग सेटअप देखें.
	खाते के बजट के बारे में पढ़ें, ताकि यह समझा जा सके कि बजट, खातों को अपने-आप कैसे असाइन किए जा सकते हैं.
	AccountBudgetProposalService का इस्तेमाल करने के लिए, आपके Google Ads मैनेजर खाते को इस काम के लिए अनुमति वाली सूची में शामिल होना चाहिए. यह प्रोसेस पूरी होने तक, इस सेवा का इस्तेमाल नहीं किया जा सकेगा. आपको Google के साथ, महीने के इनवॉइस के लिए भी सेट अप करना होगा. इस प्रोसेस को पूरा करने के लिए, Google के अपने स्ट्रटीजिक पार्टनर मैनेजर (एसपीएम) से संपर्क करें. इसका ऐक्सेस सिर्फ़ Google Partners के पास है.
	हर महीने बिलिंग के लिए रजिस्टर करने का आवेदन करने के लिए, Google के अपने कारोबार के प्रतिनिधि से संपर्क करें.
	AccountBudgetProposalService का ऐक्सेस पाने के लिए, Google के अपने कारोबार के प्रतिनिधि से संपर्क करें.
	AccountBudgetProposal बनाएं और उसे किसी खाते को असाइन करें. बजट को कैंपेन बजट के साथ इस्तेमाल करें.

शॉपिंग विज्ञापन

	अगर आपको शॉपिंग विज्ञापनों का इस्तेमाल करना है, तो आपको प्रॉडक्ट डेटा मैनेज करने के लिए, Google Merchant Center और इसके Content API for Shopping का इस्तेमाल करना पड़ सकता है. इस सेक्शन में, उस एपीआई का इस्तेमाल शुरू करने के बुनियादी चरणों के बारे में बताया गया है.
	Merchant Center खाता सेट अप करें और MerchantID पाएं.
	अगर आपके ऐप्लिकेशन को सिर्फ़ अपने Merchant Center खाते का ऐक्सेस चाहिए, तो सेवा खाते की कुंजी पाएं. हालांकि, अगर आपने तीसरे पक्ष का ऐसा ऐप्लिकेशन लिखा है जिसे आपके क्लाइंट के Merchant Center खातों का ऐक्सेस चाहिए, तो OAuth 2.0 के साथ अनुरोधों को अनुमति देने की गाइड देखें.
	अपनी पसंद की भाषा के लिए, क्लाइंट लाइब्रेरी डाउनलोड करें.
	Java, .NET, PHP, Python वगैरह के लिए, Content API के कोड के उदाहरण देखें.
	Merchant Center और Google Ads खातों को मैन्युअल तरीके से लिंक करने का तरीका जानें.
	Content API का इस्तेमाल करके, प्रॉडक्ट की सूची सेट अप करने का तरीका जानें.
	Google Ads API का इस्तेमाल करके, शॉपिंग कैंपेन बनाने के बारे में गाइड देखें.

सुझाव और स्टेटस में बदलाव करना

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

RecommendationService

RecommendationService का इस्तेमाल करने का तरीका जानने के लिए हमारी गाइड पढ़ें. इससे, आपको अपने खाते में Google के सुझावों को वापस पाने और उन्हें लागू करने में मदद मिलेगी. इससे, विज्ञापनों की परफ़ॉर्मेंस बेहतर होगी.

इस कोड सैंपल को चलाकर, सुझाव की सुविधाओं के बारे में जानें: सुझाव के सैंपल -> टेक्स्ट विज्ञापन के सुझाव पाना.

ChangeStatusService

अपने खाते में हुए बदलावों, जैसे कि कैंपेन और विज्ञापनों को ट्रैक करने के लिए, बदलाव का इतिहास पाने के लिए, ChangeStatusService का इस्तेमाल करने का तरीका बताने वाली हमारी गाइड पढ़ें.

इस कोड सैंपल को चलाकर, बदलाव के इतिहास की सुविधाओं के बारे में जानें: ChangeStatus सैंपल -> खाते में हुए बदलाव पाएं..

अप-टू-डेट रहना

Google Ads API में होने वाले बदलावों के हिसाब से, अपने कोड को अप-टू-डेट रखें.

वर्शन

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

विज्ञापन से जुड़े Google प्रॉडक्ट

	Google Merchant Center	Google Merchant Center की मदद से, अपने स्टोर और प्रॉडक्ट डेटा को Google पर अपलोड किया जा सकता है. साथ ही, इसे शॉपिंग विज्ञापनों और Google की अन्य सेवाओं के लिए उपलब्ध कराया जा सकता है.
	Business Profile	Business Profile की मदद से, Google Search और Maps पर स्थानीय ग्राहकों तक पहुंचा जा सकता है और उनसे जुड़ा जा सकता है.
	Google Analytics	Google Analytics से आपको इस बात की पूरी जानकारी मिलती है कि लोग आपकी वेबसाइट का इस्तेमाल कैसे करते हैं. आप Google Analytics का इस्तेमाल करके यह पता लगा सकते हैं कि आपके विज्ञापनों पर क्लिक करने के बाद लोग क्या करते हैं.
	Google Tag Manager	Google Tag Manager एक टैग मैनेजमेंट सिस्टम (टीएमएस) है. इसकी मदद से, अपनी वेबसाइट या मोबाइल ऐप्लिकेशन पर ट्रैकिंग कोड और मिलते-जुलते कोड के हिस्सों को तेज़ी से अपडेट किया जा सकता है. इन हिस्सों को एक साथ टैग कहा जाता है.
	Google Optimize	Google Optimize, छोटे कारोबारों के लिए A/B टेस्टिंग, वेबसाइट टेस्टिंग, और मनमुताबिक बनाने के टूल उपलब्ध कराता है. इनकी मदद से, ग्राहकों को बेहतर अनुभव दिया जा सकता है.
	Google Data Studio	Data Studio, आपके डेटा को जानकारी देने वाले ऐसे डैशबोर्ड और रिपोर्ट में बदल देता है जिन्हें पढ़ना और शेयर करना आसान होता है. साथ ही, इन्हें अपनी ज़रूरत के हिसाब से इस्तेमाल किया जा सकता है.

सहायता पाना

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