.NET क्लाइंट लाइब्रेरी को GitHub पर होस्ट किया गया है और इसे NuGet पैकेज के तौर पर डिस्ट्रिब्यूट किया जाता है. यह एपीआई का इस्तेमाल करने में आपकी मदद करने के लिए कई सुविधाएं देता है. जैसे, क्रेडेंशियल को आसानी से मैनेज करना और Google Ads API सेवा के क्लाइंट बनाना.
यह लाइब्रेरी, इन .NET फ़्रेमवर्क के साथ काम करती है:
- .NET Framework 4.7.2 और इसके बाद के वर्शन (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
.NET Standard 2.1, .NET के कई अन्य वर्शन और इंप्लीमेंटेशन के साथ काम करता है. इसलिए, हो सकता है कि यह लाइब्रेरी कई अन्य प्लैटफ़ॉर्म पर ठीक से काम करे. हालांकि, हमने आधिकारिक तौर पर यह जांच नहीं की है कि ये प्लैटफ़ॉर्म, इस सुविधा के साथ काम करते हैं या नहीं. इसलिए, हम आधिकारिक तौर पर इन प्लैटफ़ॉर्म के लिए यह सुविधा उपलब्ध नहीं कराते. ज़्यादा जानने के लिए, .NET Standard 2.1 से जुड़ा दस्तावेज़ देखें.
Google Ads API .NET लाइब्रेरी, ट्रांसपोर्ट लेयर के तौर पर डिफ़ॉल्ट रूप से Grpc.Net.Client का इस्तेमाल करती है. हालांकि, जिन प्लैटफ़ॉर्म पर यह काम नहीं करता वहां Grpc.Core का इस्तेमाल किया जाता है. UseGrpcCore को true पर सेट करके, Grpc.Core का इस्तेमाल किया जा सकता है. हालांकि, ध्यान दें कि Grpc.Core अब काम नहीं करता है. इसका इस्तेमाल सिर्फ़ लेगसी सिस्टम को बनाए रखने के लिए किया जाता है. ज़्यादा जानने के लिए, इस्तेमाल से जुड़ी बुनियादी गाइड देखें.
पहला एपीआई कॉल करना
Google Ads API का इस्तेमाल करने के लिए, आपको कई चरणों को पूरा करना होगा. इससे आपको एपीआई का ऐक्सेस मिलेगा और Google Ads खातों को कॉन्फ़िगर करने में मदद मिलेगी. क्विक स्टार्ट गाइड में दिया गया तरीका अपनाएं. इसमें, Google Ads खाते सेट अप करने के साथ-साथ अन्य ज़रूरी चरणों के बारे में भी बताया गया है.
बुनियादी इस्तेमाल
अपनी कॉन्फ़िगरेशन सेटिंग के साथ GoogleAdsClient को शुरू करें और एपीआई कॉल करने के लिए, सेवा क्लाइंट को वापस पाएं:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
.NET क्लाइंट लाइब्रेरी इस्तेमाल करने के बारे में ज़्यादा जानने के लिए, इस्तेमाल करने से जुड़ी बुनियादी गाइड देखें.
अनुमति देना और पुष्टि करना
.NET क्लाइंट लाइब्रेरी, पुष्टि करने और अनुमति देने के कई तरीकों के साथ काम करती है. इनमें OAuth 2.0 के उपयोगकर्ता क्रेडेंशियल (डेस्कटॉप और वेब ऐप्लिकेशन के लिए), सेवा खाते, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (v24.1.0 और इसके बाद के वर्शन), और मैन्युअल क्रेडेंशियल इंजेक्शन (v27.0.0 और इसके बाद के वर्शन) शामिल हैं. ज़्यादा जानने के लिए, अनुमति और पुष्टि से जुड़ी गाइड देखें.
कॉन्फ़िगरेशन और लॉगिंग
.NET क्लाइंट लाइब्रेरी, रनटाइम ऑब्जेक्ट, App.config फ़ाइलों, JSON कॉन्फ़िगरेशन फ़ाइलों या एनवायरमेंट वैरिएबल का इस्तेमाल करके, कई कॉन्फ़िगरेशन और लॉगिंग के विकल्पों के साथ काम करती है. अगर आपको क्लाइंट लाइब्रेरी के लॉगिंग के तरीके में बदलाव करना है, तो कस्टम gRPC इंटरसेप्टर गाइड देखें.
उपयोगिताएं
.NET क्लाइंट लाइब्रेरी में, एपीआई के इस्तेमाल को बेहतर बनाने के लिए यूटिलिटी क्लास शामिल हैं. इनमें मीडिया और वीडियो अपलोड करने में मदद करने वाली क्लास (UploadVideo में v27.2.0 और उसके बाद के वर्शन में) शामिल हैं.
ज़्यादा जानने के लिए, यहां दी गई गाइड देखें:
अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाना
अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाने के बारे में सुझाव पाने के लिए, परफ़ॉर्मेंस ट्यूनिंग गाइड देखें.