.NET क्लाइंट लाइब्रेरी

.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 के कई अन्य वर्शन और लागू करने के तरीकों के साथ काम करता है. इसलिए, हो सकता है कि लाइब्रेरी कई अन्य प्लैटफ़ॉर्म पर ठीक से काम करे. हालांकि, हमने आधिकारिक तौर पर यह जांच नहीं की है कि ये प्लैटफ़ॉर्म, Google Play Games के साथ काम करते हैं या नहीं. इसलिए, हम आधिकारिक तौर पर इन प्लैटफ़ॉर्म के लिए सहायता नहीं देते. ज़्यादा जानने के लिए, .NET Standard 2.1 दस्तावेज़ देखें.

Google Ads API .NET लाइब्रेरी, डिफ़ॉल्ट ट्रांसपोर्ट लेयर के तौर पर Grpc.Net.Client का इस्तेमाल करती है. साथ ही, जिन प्लैटफ़ॉर्म पर यह काम नहीं करती है उन पर फ़ॉलबैक के तौर पर Grpc.Core का इस्तेमाल करती है. UseGrpcCore को true पर सेट करके, Grpc.Core का इस्तेमाल करने के लिए मजबूर किया जा सकता है. हालांकि, ध्यान दें कि Grpc.Core अब काम नहीं करता और इसका इस्तेमाल सिर्फ़ लेगसी सिस्टम के रखरखाव के लिए किया जाता है. ज़्यादा जानने के लिए, इस्तेमाल करने की बुनियादी गाइड देखें.

इंस्टॉल करना

dotnet कमांड-लाइन टूल का इस्तेमाल करके, अपने प्रोजेक्ट में Google.Ads.GoogleAds NuGet पैकेज इंस्टॉल करें:

dotnet add package Google.Ads.GoogleAds

appsettings.json, App.config या एनवायरमेंट वैरिएबल से कॉन्फ़िगरेशन सेटिंग लोड करने के लिए, Google.Ads.GoogleAds.Extensions पैकेज भी इंस्टॉल करें:

dotnet add package Google.Ads.GoogleAds.Extensions

अपना पहला एपीआई कॉल करना

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

बुनियादी इस्तेमाल

अपनी कॉन्फ़िगरेशन सेटिंग के साथ GoogleAdsConfig और GoogleAdsClient को शुरू करें. इसके बाद, GoogleAdsServiceClient को वापस पाएं और SearchStream के साथ कैंपेन की पंक्तियों को स्ट्रीम करें:

using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
    OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
    OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
    "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";

try
{
    googleAdsService.SearchStream(
        customerId,
        query,
        delegate (SearchGoogleAdsStreamResponse response)
        {
            foreach (GoogleAdsRow row in response.Results)
            {
                Console.WriteLine(
                    $"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
            }
        });
}
catch (GoogleAdsException ex)
{
    Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}

.NET क्लाइंट लाइब्रेरी को इस्तेमाल करने के तरीके के बारे में ज़्यादा जानने के लिए, इस्तेमाल करने से जुड़ी बुनियादी गाइड देखें.

अनुमति और पुष्टि करना

.NET क्लाइंट लाइब्रेरी, पुष्टि करने और अनुमति देने के कई तरीकों के साथ काम करती है. इनमें OAuth 2.0 उपयोगकर्ता क्रेडेंशियल (डेस्कटॉप और वेब ऐप्लिकेशन के लिए), सेवा खाते, ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (v24.1.0 और उसके बाद के वर्शन), और मैन्युअल क्रेडेंशियल इंजेक्शन (v27.0.0 और उसके बाद के वर्शन) शामिल हैं. ज़्यादा जानने के लिए, अनुमति और पुष्टि करने की गाइड देखें.

कॉन्फ़िगरेशन और लॉगिंग

.NET क्लाइंट लाइब्रेरी, रनटाइम ऑब्जेक्ट, appsettings.json या कस्टम JSON फ़ाइलों, एनवायरमेंट वैरिएबल या App.config फ़ाइलों का इस्तेमाल करके, कई कॉन्फ़िगरेशन और लॉगिंग विकल्पों के साथ काम करती है. अगर आपको क्लाइंट लाइब्रेरी के लॉगिंग व्यवहार में बदलाव करना है, तो कस्टम gRPC इंटरसेप्टर गाइड देखें.

उपयोगिताएं

.NET क्लाइंट लाइब्रेरी में, एपीआई के इस्तेमाल को बेहतर बनाने के लिए यूटिलिटी क्लास शामिल हैं. इनमें मीडिया और वीडियो अपलोड करने वाले हेल्पर शामिल हैं. ये हेल्पर, v27.2.0 और उसके बाद के वर्शन में UploadVideo में शामिल हैं. ज़्यादा जानने के लिए, यहां दी गई गाइड देखें:

अपने ऐप्लिकेशन की परफ़ॉर्मेंस को बेहतर बनाना

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