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

शुरू करें

इस गाइड में, Google Ads API का इस्तेमाल शुरू करने के बारे में खास जानकारी दी गई है .NET लाइब्रेरी पर टैप करें.

इंस्टॉल करना

क्लाइंट लाइब्रेरी बाइनरी, NuGet का इस्तेमाल करके डिस्ट्रिब्यूट की जाती हैं. क्लाइंट लाइब्रेरी का इस्तेमाल करने के लिए, अपने प्रोजेक्ट में Google.Ads.GoogleAds पैकेज में NuGet रेफ़रंस जोड़ें.

अनुमति सेट अप करना

एपीआई कॉल की अनुमति देने के लिए, आपको अपना Client ID, क्लाइंट सीक्रेट, रीफ़्रेश टोकन और डेवलपर टोकन को लाइब्रेरी में जोड़ा जाता है.

अगर आपको क्रेडेंशियल जनरेट करने हैं, तो

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

अगर आपके पास पहले से क्रेडेंशियल हैं

GoogleAdsApi नोड और GoogleAdsApi सेक्शन को कॉपी करें App.config फ़ाइल से इसमें configSections नोड GitHub आपकी App.config / Web.config फ़ाइल में. अगर आपने पैकेज इंस्टॉल करने के लिए NuGet का इस्तेमाल किया है, तो ये नोड आपकी App.config / Web.config फ़ाइल में अपने-आप जुड़ जाएंगे.
अपने ऐप्लिकेशन के App.config / Web.config में डेवलपर टोकन, क्लाइंट आईडी, क्लाइंट सीक्रेट, और रीफ़्रेश टोकन शामिल करें.

GitHub में शामिल App.config फ़ाइल के बारे में अच्छी तरह से जानकारी दी गई है. हालांकि, ज़्यादा जानने के लिए, कॉन्फ़िगरेशन गाइड को भी पढ़ा जा सकता है. साथ ही, क्लाइंट लाइब्रेरी को कॉन्फ़िगर करने के लिए, एनवायरमेंट वैरिएबल जैसे अन्य तरीकों का इस्तेमाल भी किया जा सकता है.

एपीआई कॉल करें

क्लाइंट लाइब्रेरी का बुनियादी इस्तेमाल यहां दिया गया है:

// Create a Google Ads client.
GoogleAdsClient client = new GoogleAdsClient();

// Create the required service.
CampaignServiceClient campaignService =
    client.GetService(Services.V18.CampaignService);

// Make more calls to service class.

GoogleAdsClient इंस्टेंस बनाना

Google Ads API .NET लाइब्रेरी में सबसे अहम क्लास ये हैं GoogleAdsClient क्लास. इसकी मदद से, पहले से कॉन्फ़िगर की गई सेवा क्लास बनाई जा सकती है. इसका इस्तेमाल, एपीआई कॉल करने के लिए किया जा सकता है. GoogleAdsClient एक डिफ़ॉल्ट कंस्ट्रक्टर उपलब्ध कराता है, जो आपके ऐप्लिकेशन के App.config / Web.config में बताई गई सेटिंग का इस्तेमाल करके उपयोगकर्ता ऑब्जेक्ट बनाता है. कॉन्फ़िगरेशन देखें कॉन्फ़िगरेशन के लिए गाइड के विकल्प.

// Create a new GoogleAdsClient with the App.config settings.
GoogleAdsClient user = new GoogleAdsClient();

सेवा बनाना

GoogleAdsClient, GetService तरीका उपलब्ध कराता है. इसका इस्तेमाल, Ads की सेवा बनाने के लिए किया जा सकता है.

CampaignServiceClient campaignService = client.GetService(Services.V18.CampaignService);
// Now make calls to CampaignService.

हम एक Services क्लास देते हैं, जिसमें इस्तेमाल किए जा सकने वाले सभी एपीआई वर्शन की गणना की जाती है और सेवाओं. GetService तरीका, सेवा बनाते समय इन एन्यूमरेशन ऑब्जेक्ट को आर्ग्युमेंट के तौर पर स्वीकार करता है. उदाहरण के लिए, Google Ads API के वर्शन V18 के लिए CampaignServiceClient, आपको GoogleAdsClient.GetService तरीके को इसके साथ कॉल करना होगा Services.V18.CampaignService तर्क के रूप में, जैसा दिखाया गया है पर क्लिक करें.

थ्रेड की सुरक्षा

एक से ज़्यादा थ्रेड के बीच GoogleAdsClient इंस्टेंस शेयर करना सुरक्षित नहीं है, क्योंकि एक थ्रेड में किसी इंस्टेंस के कॉन्फ़िगरेशन में किए गए बदलावों से, दूसरी थ्रेड में बनाई गई सेवाओं पर असर पड़ सकता है. GoogleAdsClient इंस्टेंस से नई सेवा के इंस्टेंस पाना और एक साथ कई सेवाओं को कॉल करना जैसे ऑपरेशन, थ्रेड-सेफ़ होते हैं.

मल्टीथ्रेड ऐप्लिकेशन कुछ ऐसा दिखेगा:

GoogleAdsClient client1 = new GoogleAdsClient();
GoogleAdsClient client2 = new GoogleAdsClient();

Thread userThread1 = new Thread(addAdGroups);
Thread userThread2 = new Thread(addAdGroups);

userThread1.start(client1);
userThread2.start(client2);

userThread1.join();
userThread2.join();

public void addAdGroups(object data) {
  GoogleAdsClient client = (GoogleAdsClient) data;
  // Do more operations here.
  ...
}

.NET Framework ऐप्लिकेशन के फ़्रीज़ होने से बचना

सिंक्रोनस तरीकों से आपके कुछ .NET Framework ऐप्लिकेशन, फ़्रीज़ करो. एक सामान्य उदाहरण, WinForm ऐप्लिकेशन के इवेंट हैंडलर तरीके से एपीआई कॉल करना है.

इस समस्या को हल करने के दो तरीके हैं:

लेगसी Grpc लाइब्रेरी का इस्तेमाल करें.

डिफ़ॉल्ट Grpc.Net.Client लाइब्रेरी के बजाय, लेगसी Grpc.Core लाइब्रेरी का इस्तेमाल करने के लिए, GoogleAdsConfig की UseGrpcCore प्रॉपर्टी सेट की जा सकती है. इस तरीके की ज़्यादा जांच .NET Framework ऐप्लिकेशन पर नहीं की गई है. इसलिए, हो सकता है कि इससे समस्या हल न हो. यहां एक सैंपल स्निपेट दिया गया है:
```
GoogleAdsConfig config = new GoogleAdsConfig();
config.UseGrpcCore = true;
GoogleAdsClient client = new GoogleAdsClient(config);
```
gRPC सहायता पेज पर, लेगसी Grpc.Core लाइब्रेरी और डिफ़ॉल्ट Grpc.Net.Client लाइब्रेरी के बीच के अंतर के बारे में ज़्यादा जानकारी दी गई है.

एसिंक्रोनस तरीकों का इस्तेमाल करें.

फ़्रीज़ होने से बचने के लिए, एसिंक्रोनस तरीकों का इस्तेमाल किया जा सकता है. यहां कुछ उदाहरण दिए गए हैं:

SearchStream

SearchStream() को कॉल किया जाता है और नतीजे, सूची के व्यू में अपने-आप भर जाते हैं.

private async void button1_Click(object sender, EventArgs e)
{
// Get the GoogleAdsService.
GoogleAdsServiceClient googleAdsService = client.GetService(
    Services.V18.GoogleAdsService);
 
// Create a query that will retrieve all campaigns.
string query = @"SELECT
                campaign.id,
                campaign.name,
                campaign.network_settings.target_content_network
            FROM campaign
            ORDER BY campaign.id";
 
List items = new List();
Task t =  googleAdsService.SearchStreamAsync(customerId.ToString(), query,
    delegate (SearchGoogleAdsStreamResponse resp)
    {
        foreach (GoogleAdsRow googleAdsRow in resp.Results)
        {
            ListViewItem item = new ListViewItem();
            item.Text = googleAdsRow.Campaign.Id.ToString();
            item.SubItems.Add(googleAdsRow.Campaign.Name);
            items.Add(item);
        }
    }
);
await t;
listView1.Items.AddRange(items.ToArray());
}

कैंपेन का बजट

CampaignBudget कॉल बनाया जाता है और नए बजट के रिसॉर्स का नाम, MessageBox सूचना का इस्तेमाल करके दिखाया जाता है.

private async void button2_Click(object sender, EventArgs e)
{
// Get the BudgetService.
CampaignBudgetServiceClient budgetService = client.GetService(
    Services.V18.CampaignBudgetService);
 
// Create the campaign budget.
CampaignBudget budget = new CampaignBudget()
{
    Name = "Interplanetary Cruise Budget #" + ExampleUtilities.GetRandomString(),
    DeliveryMethod = BudgetDeliveryMethod.Standard,
    AmountMicros = 500000
};
 
// Create the operation.
CampaignBudgetOperation budgetOperation = new CampaignBudgetOperation()
{
    Create = budget
};
 
// Create the campaign budget.
Task t = budgetService.MutateCampaignBudgetsAsync(
    customerId.ToString(), new CampaignBudgetOperation[] { budgetOperation });
 
await t;
MutateCampaignBudgetsResponse response = t.Result;
MessageBox.Show(response.Results[0].ResourceName);
}

गड़बड़ी ठीक करना

हर एपीआई कॉल पूरा नहीं होगा. अगर आपका एपीआई कॉल करता है, तो सर्वर गड़बड़ी की जानकारी दे सकता है किसी वजह से यह कामयाब नहीं हुआ. एपीआई की गड़बड़ियों को कैप्चर करना और उन्हें सही तरीके से मैनेज करना ज़रूरी है.

एपीआई से जुड़ी कोई गड़बड़ी होने पर, GoogleAdsException इंस्टेंस ट्रिगर होता है. इसमें ऐसी जानकारी होती है जिससे आपको यह पता चलता है कि क्या गलत हुआ:

// Get the CampaignService.
CampaignServiceClient campaignService = client.GetService(Services.V18.CampaignService);

// Create a campaign for update.
Campaign campaignToUpdate = new Campaign()
{
    ResourceName = ResourceNames.Campaign(customerId, campaignId),
    // More fields to update.
    // ...
};

// Create the operation.
CampaignOperation operation = new CampaignOperation()
{
    Update = campaignToUpdate,
    UpdateMask = FieldMasks.AllSetFieldsOf(campaignToUpdate)
};

try
{
    // Update the campaign.
    MutateCampaignsResponse response = campaignService.MutateCampaigns(
        customerId.ToString(), new CampaignOperation[] { operation });

    // Display the results.
    // ...
}
catch (GoogleAdsException e)
{
    Console.WriteLine("Failure:");
    Console.WriteLine($"Message: {e.Message}");

    // Can examine to get more error details.
    Console.WriteLine($"Failure: {e.Failure}");

    // Can be shared with Google for further troubleshooting.
    Console.WriteLine($"Request ID: {e.RequestId}");
}