প্রাথমিক ব্যবহার

.NET ক্লায়েন্ট লাইব্রেরির প্রাথমিক ব্যবহার নিচে দেওয়া হল:

// Initialize a GoogleAdsConfig instance.
GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_CREDENTIALS_JSON",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

// Initialize a GoogleAdsClient instance.
GoogleAdsClient client = new GoogleAdsClient(config);

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

// Make calls to the service client.

ক্লায়েন্ট ও পরিষেবা শুরু করুন

Google Ads API-এর সাথে ইন্টার‍্যাক্ট করতে, প্রথমে একটি GoogleAdsClient কনফিগার ও ইনস্ট্যান্টিয়েট করুন এবং তারপরে আপনার প্রয়োজনীয় নির্দিষ্ট API পরিষেবা ক্লায়েন্ট তৈরি করতে এটি ব্যবহার করুন।

GoogleAdsClient ইনস্ট্যান্স তৈরি করা

Google Ads API .NET লাইব্রেরির সবচেয়ে গুরুত্বপূর্ণ ক্লাস হল GoogleAdsClient ক্লাস। এটি আপনাকে একটি প্রি-কনফিগার করা পরিষেবা ক্লায়েন্ট তৈরি করতে দেয় যা API কল করার জন্য ব্যবহার করা যেতে পারে। GoogleAdsClient অবজেক্ট কনফিগার করতে, একটি GoogleAdsConfig অবজেক্ট তৈরি করুন এবং প্রয়োজনীয় প্রপার্টি সেট করুন। আরও জানতে কনফিগারেশন গাইড দেখুন।

// Initialize a GoogleAdsConfig instance.
GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.SERVICE_ACCOUNT,
    OAuth2SecretsJsonPath = "PATH_TO_CREDENTIALS_JSON",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

// Initialize a GoogleAdsClient instance.
GoogleAdsClient client = new GoogleAdsClient(config);

// Modify the GoogleAdsClient configuration afterwards if needed.
client.Config.LoginCustomerId = "INSERT_UPDATED_LOGIN_CUSTOMER_ID_HERE";

পরিষেবা তৈরি করুন

GoogleAdsClient একটি GetService পদ্ধতি প্রদান করে যা API পরিষেবা ক্লায়েন্ট তৈরি করতে ব্যবহার করা যেতে পারে।

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

লাইব্রেরিটি একটি Services ক্লাস প্রদান করে যা সমস্ত সমর্থিত API সংস্করণগুলিকে গণনা করে (যেখানে v25.1-এর মতো ছোট রিলিজগুলি তাদের প্রধান সংস্করণ enum, Services.V25 ব্যবহার করে) এবং পরিষেবাগুলি। পরিষেবা তৈরি করার সময় GetService পদ্ধতি এই গণনা অবজেক্টগুলিকে একটি আর্গুমেন্ট হিসেবে গ্রহণ করে। যেমন, Google Ads API-এর V26 ভার্সনের জন্য CampaignServiceClient-এর ইনস্ট্যান্স তৈরি করতে, আর্গুমেন্ট হিসেবে Services.V26.CampaignService সহ GoogleAdsClient.GetService পদ্ধতি কল করুন, যেমনটি আগের উদাহরণে দেখানো হয়েছে।

সমস্যা ম্যানেজ করা

প্রতিটি API কল সফল হয় না। কোনও কারণে আপনার API কল ব্যর্থ হলে, সার্ভার সমস্যা দেখাতে পারে। API সংক্রান্ত সমস্যা ক্যাপচার করা এবং যথাযথভাবে তা ম্যানেজ করা গুরুত্বপূর্ণ।

API সংক্রান্ত সমস্যা হলে GoogleAdsException ইনস্ট্যান্স থ্রো করা হয়। এতে কী সমস্যা হয়েছে তা বুঝতে সাহায্য করার জন্য বিবরণ রয়েছে:

public void Run(GoogleAdsClient client, long customerId)
{
    // Get the GoogleAdsService.
    GoogleAdsServiceClient googleAdsService = client.GetService(
        Services.V26.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";

    try
    {
        // Issue a search request.
        googleAdsService.SearchStream(customerId.ToString(), query,
            delegate (SearchGoogleAdsStreamResponse resp)
            {
                foreach (GoogleAdsRow googleAdsRow in resp.Results)
                {
                    Console.WriteLine("Campaign with ID {0} and name '{1}' was found.",
                        googleAdsRow.Campaign.Id, googleAdsRow.Campaign.Name);
                }
            }
        );
    }
    catch (GoogleAdsException e)
    {
        Console.WriteLine("Failure:");
        Console.WriteLine($"Message: {e.Message}");
        Console.WriteLine($"Failure: {e.Failure}");
        Console.WriteLine($"Request ID: {e.RequestId}");
        throw;
    }
}
GetCampaigns.cs
      

থ্রেড সুরক্ষা

একাধিক থ্রেড জুড়ে শেয়ার করা GoogleAdsClient ইনস্ট্যান্সের কনফিগারেশন স্টেট পরিবর্তন করা থ্রেড-নিরাপদ নয়, কারণ একটি থ্রেডে ইনস্ট্যান্সে আপনার করা কনফিগারেশন পরিবর্তন অন্যান্য থ্রেডে আপনার তৈরি করা পরিষেবাকে প্রভাবিত করতে পারে। তবে, অপরিবর্তিত GoogleAdsClient ইনস্ট্যান্স থেকে নতুন পরিষেবা ইনস্ট্যান্স পাওয়া এবং সমান্তরালভাবে একাধিক পরিষেবায় কল করার মতো শুধুমাত্র-পঠন অপারেশন থ্রেড-সেফ।

প্রতিটি থ্রেড অনুযায়ী কনফিগারেশন পরিবর্তনকে আলাদা করতে, প্রতিটি কর্মী টাস্ক বা থ্রেডের জন্য GoogleAdsClient আলাদা ইনস্ট্যান্স তৈরি করুন:

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

Task task1 = Task.Run(() => AddAdGroups(client1));
Task task2 = Task.Run(() => AddAdGroups(client2));

await Task.WhenAll(task1, task2);

public void AddAdGroups(GoogleAdsClient client)
{
    // Perform operations with client.
}

আপনার অ্যাপ্লিকেশনকে রেসপন্সিভ রাখা

Google Ads API মেথড কল সম্পূর্ণ হতে কিছুটা সময় লাগতে পারে, এটি নির্ভর করে অনুরোধ কতটা বড় তার উপর। আপনার অ্যাপ্লিকেশনকে রেসপন্সিভ রাখতে, এইসব ধাপ অনুসরণ করুন:

পুরনো UI ফ্রেমওয়ার্কের জন্য Grpc.Core লাইব্রেরি ব্যবহার করুন

আপনি যদি এমন কোনও অ্যাপ্লিকেশন ডেভেলপ করেন যা .NET ফ্রেমওয়ার্ককে টার্গেট করে এবং ASP.NET ওয়েব ফর্ম বা WinForms-এর মতো লিগ্যাসি UI প্রযুক্তি ব্যবহার করে, তাহলে আপনি নিম্নলিখিত উপায়ে লিগ্যাসি Grpc.Core ট্রান্সপোর্ট লাইব্রেরি চালু করতে পারেন:

GoogleAdsConfig config = new GoogleAdsConfig();
config.UseGrpcCore = true;
GoogleAdsClient client = new GoogleAdsClient(config);

অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করুন

আপনার অ্যাপ্লিকেশন রেসপন্সিভ রাখতে আপনি অ্যাসিঙ্ক্রোনাস পদ্ধতি ব্যবহার করতে পারেন। এখানে দুটি উদাহরণ দেওয়া হল।

ক্যাম্পেনের তালিকা ফিরিয়ে আনুন এবং ListView পপুলেট করুন

private async void OnRetrieveCampaignsButtonClick(object sender, EventArgs e)
{
    try
    {
        // Get the GoogleAdsService.
        GoogleAdsServiceClient googleAdsService = client.GetService(
            Services.V26.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<ListViewItem> items = new List<ListViewItem>();
        await googleAdsService.SearchStreamAsync(
            customerId.ToString(),
            query,
            (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);
                }
            }
        );
        listView1.Items.AddRange(items.ToArray());
    }
    catch (GoogleAdsException ex)
    {
        MessageBox.Show($"API Error: {ex.Message}");
    }
}

ক্যাম্পেন বাজেট আপডেট করা এবং মেসেজ বক্স অ্যালার্ট দেখানো

private async void OnUpdateBudgetButtonClick(object sender, EventArgs e)
{
    try
    {
        // Get the CampaignBudgetService.
        CampaignBudgetServiceClient budgetService = client.GetService(
            Services.V26.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 asynchronously.
        MutateCampaignBudgetsResponse response =
            await budgetService.MutateCampaignBudgetsAsync(
                customerId.ToString(),
                new CampaignBudgetOperation[] { budgetOperation });

        MessageBox.Show(response.Results[0].ResourceName);
    }
    catch (GoogleAdsException ex)
    {
        MessageBox.Show($"API Error: {ex.Message}");
    }
}