.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.V26.GoogleAdsService);
.NET की क्लाइंट लाइब्रेरी का इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, बुनियादी इस्तेमाल के लिए गाइड देखें.
अनुमति और पुष्टि करना
.NET की क्लाइंट लाइब्रेरी, पुष्टि करने और अनुमति देने के कई तरीकों के साथ काम करती है. इनमें OAuth 2.0 के उपयोगकर्ता क्रेडेंशियल (डेस्कटॉप और वेब ऐप्लिकेशन के लिए), सेवा खाते, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (v24.1.0 और इसके बाद के वर्शन) और मैन्युअल क्रेडेंशियल इंजेक्शन (v27.0.0 और इसके बाद के वर्शन) शामिल हैं. ज़्यादा जानने के लिए,
अनुमति और पुष्टि करने के लिए गाइड देखें.
कॉन्फ़िगरेशन और लॉगिंग
.NET की क्लाइंट लाइब्रेरी, रनटाइम ऑब्जेक्ट, App.config फ़ाइलें,
JSON कॉन्फ़िगरेशन फ़ाइलें या एनवायरमेंट वैरिएबल का इस्तेमाल करके, कई कॉन्फ़िगरेशन
और लॉगिंग विकल्पों के साथ काम करती है. अगर आपको क्लाइंट लाइब्रेरी के लॉगिंग के तरीके में बदलाव करना है, तो
कस्टम gRPC इंटरसेप्टर के लिए गाइड देखें.
उपयोगिताएं
.NET की क्लाइंट लाइब्रेरी में, एपीआई की इस्तेमाल करने की सुविधा को बेहतर बनाने के लिए यूटिलिटी क्लास शामिल हैं. इनमें मीडिया और वीडियो अपलोड करने में मदद करने वाली क्लास (UploadVideo in v27.2.0 and later) शामिल हैं.
ज़्यादा जानने के लिए, ये गाइड देखें:
अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाना
अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाने के बारे में सुझाव पाने के लिए, परफ़ॉर्मेंस ट्यूनिंग के लिए गाइड देखें.