Google Ads API .NET: Как использовать API для автоматизации рекламы в Google Ads?

using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.V15.Services;
using Google.Api.Ads.Common.Lib;

public class GoogleAdsHelper
{
    private static GoogleAdsClient _client;

    public static GoogleAdsClient GetGoogleAdsClient()
    {
        if (_client == null)
        {
            _client = new GoogleAdsClientConfig()
            {
                OAuth2ClientId = "YOUR_CLIENT_ID",
                OAuth2ClientSecret = "YOUR_CLIENT_SECRET",
                OAuth2RefreshToken = "YOUR_REFRESH_TOKEN",
                DeveloperToken = "YOUR_DEVELOPER_TOKEN",
                LoginCustomerId = "YOUR_LOGIN_CUSTOMER_ID",
            }.Build();
        }
        return _client;
    }
}

using Google.Ads.GoogleAds.V15.Services;
using Google.Ads.GoogleAds.V15.Resources;
using static Google.Ads.GoogleAds.V15.Enums.CampaignStatusEnum.CampaignStatus;

public static class CampaignGetter
{
    public static void GetCampaigns(long customerId)
    {
        using (var googleAdsClient = GoogleAdsHelper.GetGoogleAdsClient())
        {
            var googleAdsService = googleAdsClient.GetService(Services.V15.GoogleAdsService);

            string query = @"SELECT
                        campaign.id,
                        campaign.name,
                        campaign.status
                    FROM campaign";

            var searchStream = googleAdsService.SearchStream(customerId.ToString(), query);

            foreach (var row in searchStream.IterateAll()){
                Campaign campaign = row.Campaign;
                Console.WriteLine($"Campaign with ID = '{campaign.Id}' and name = " +
                                  $"'{campaign.Name}' was found with '{campaign.Status}'.");
            }
        }
    }
}

using Google.Ads.GoogleAds.V15.Services;
using Google.Ads.GoogleAds.V15.Resources;
using Google.Ads.GoogleAds.V15.Common;
using static Google.Ads.GoogleAds.V15.Enums.CampaignStatusEnum.CampaignStatus;
using static Google.Ads.GoogleAds.V15.Enums.AdvertisingChannelTypeEnum.AdvertisingChannelType;
using static Google.Ads.GoogleAds.V15.Enums.AdvertisingChannelSubTypeEnum.AdvertisingChannelSubType;
using static Google.Ads.GoogleAds.V15.Enums.BiddingStrategyTypeEnum.BiddingStrategyType;

public static class CampaignCreator
{
    public static void CreateCampaign(long customerId, string campaignName, double dailyBudget)
    {
        using (var googleAdsClient = GoogleAdsHelper.GetGoogleAdsClient())
        {
            var campaignService = googleAdsClient.GetService(Services.V15.CampaignService);

            var campaign = new Campaign()
            {
                Name = campaignName,
                AdvertisingChannelType = AdvertisingChannelType.Search,
                AdvertisingChannelSubType = AdvertisingChannelSubType.SearchMobileApp,
                Status = CampaignStatus.Paused,
                CampaignBudget = ResourceNames.CampaignBudget(customerId.ToString(), CreateCampaignBudget(googleAdsClient, customerId, dailyBudget, campaignName)),
                BiddingStrategyType = BiddingStrategyType.MaximizeConversions,
                StartDate = DateTime.Now.ToString("yyyyMMdd"),
                EndDate = DateTime.Now.AddDays(30).ToString("yyyyMMdd")
            };

            var operation = new CampaignOperation() { Create = campaign };

            var response = campaignService.MutateCampaigns(customerId.ToString(), new[] { operation });

            Console.WriteLine("Created campaign with resource name: " + response.Results[0].ResourceName);
        }
    }

    private static string CreateCampaignBudget(GoogleAdsClient googleAdsClient, long customerId, double dailyBudget, string campaignName)
    {
        var campaignBudgetService = googleAdsClient.GetService(Services.V15.CampaignBudgetService);

        var campaignBudget = new CampaignBudget()
        {
            Name = $"{campaignName} Budget",
            AmountMicros = (long)(dailyBudget * 1000000),
            DeliveryMethod = Google.Ads.GoogleAds.V15.Enums.BudgetDeliveryMethodEnum.BudgetDeliveryMethod.Standard,
            ExplicitlyShared = false
        };

        var operation = new CampaignBudgetOperation() { Create = campaignBudget };

        var response = campaignBudgetService.MutateCampaignBudgets(customerId.ToString(), new[] { operation });

        return response.Results[0].ResourceName;
    }
}

using Google.Ads.GoogleAds.V15.Services;
using Google.Ads.GoogleAds.V15.Resources;
using Google.Ads.GoogleAds.V15.Common;

public static class KeywordManager
{
    public static void AddKeyword(long customerId, long adGroupId, string keywordText, double cpcBid)
    {
        using (var googleAdsClient = GoogleAdsHelper.GetGoogleAdsClient())
        {
            var adGroupCriterionService = googleAdsClient.GetService(Services.V15.AdGroupCriterionService);

            var adGroupCriterion = new AdGroupCriterion()
            {
                AdGroup = ResourceNames.AdGroup(customerId.ToString(), adGroupId.ToString()),
                Keyword = new KeywordInfo() { Text = keywordText, MatchType = Google.Ads.GoogleAds.V15.Enums.KeywordMatchTypeEnum.KeywordMatchType.Exact },
                CpcBidMicros = (long)(cpcBid * 1000000)
            };

            var operation = new AdGroupCriterionOperation() { Create = adGroupCriterion };

            var response = adGroupCriterionService.MutateAdGroupCriteria(customerId.ToString(), new[] { operation });

            Console.WriteLine("Created keyword with resource name: " + response.Results[0].ResourceName);
        }
    }
}

public static class BiddingAutomation
{
    public static void AdjustBids(long customerId, double targetRoas)
    {
        using (var googleAdsClient = GoogleAdsHelper.GetGoogleAdsClient())
        {
            var googleAdsService = googleAdsClient.GetService(Services.V15.GoogleAdsService);

            string query = @"SELECT
                        ad_group.id,
                        ad_group_criterion.criterion_id,
                        metrics.cost_micros,
                        metrics.conversions,
                        ad_group_criterion.cpc_bid_micros
                    FROM ad_group_criterion
                    WHERE segments.date DURING LAST_7_DAYS
                    AND ad_group_criterion.type = 'KEYWORD'
                    AND metrics.conversions > 0";

            var searchStream = googleAdsService.SearchStream(customerId.ToString(), query);

            foreach (var row in searchStream.IterateAll())
            {
                long adGroupId = row.AdGroup.Id;
                long criterionId = row.AdGroupCriterion.CriterionId;
                double cost = row.Metrics.CostMicros / 1000000.0;
                double conversions = row.Metrics.Conversions;
                long currentBid = row.AdGroupCriterion.CpcBidMicros.Value;

                double roas = (conversions > 0) ? (conversions / cost) : 0;

                long newBid = currentBid;
                if (roas  targetRoas)
                {
                    newBid = (long)(currentBid * 1.1); // Increase bid by 10%
                }

                if (newBid != currentBid)
                {
                    UpdateBid(googleAdsClient, customerId, adGroupId, criterionId, newBid);
                }
            }
        }
    }

    private static void UpdateBid(GoogleAdsClient googleAdsClient, long customerId, long adGroupId, long criterionId, long newBid)
    {
        var adGroupCriterionService = googleAdsClient.GetService(Services.V15.AdGroupCriterionService);

        var operation = new AdGroupCriterionOperation()
        {
            Update = new AdGroupCriterion()
            {
                ResourceName = ResourceNames.AdGroupCriterion(customerId.ToString(), adGroupId.ToString(), criterionId.ToString()),
                CpcBidMicros = newBid,
                Status = Google.Ads.GoogleAds.V15.Enums.AdGroupCriterionStatusEnum.AdGroupCriterionStatus.Enabled
            },
            UpdateMask = FieldMasks.AllSetMask(new string[] { "cpc_bid_micros" })
        };

        var response = adGroupCriterionService.MutateAdGroupCriteria(customerId.ToString(), new[] { operation });

        Console.WriteLine($"Updated bid for criterion {criterionId} to {newBid}");
    }
}

try
{
    // API call
}
catch (Google.GoogleApiException e)
{
    Console.WriteLine($"Failed to make API call, error: {e.Message}");
    foreach (var detail in e.Details)
    {
        Console.WriteLine($"Error detail: {detail}");
    }
}