.NET istemci kitaplığı

.NET istemci kitaplığı GitHub'da barındırılır ve NuGet paketi olarak dağıtılır. Kimlik bilgilerinin daha kolay yönetilmesi ve Google Ads API hizmet istemcilerinin oluşturulması gibi API'yi kullanmanıza yardımcı olacak çeşitli özellikler sunar.

Kitaplık, aşağıdaki .NET çerçevelerini destekler:

  • .NET Framework 4.7.2 ve sonraki sürümler (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1, diğer birçok .NET sürümü ve uygulamasıyla uyumlu olduğundan kitaplık diğer birçok platformda sorunsuz çalışabilir. Ancak uyumluluğu resmi olarak test etmediğimiz için bu platformları resmi olarak desteklemiyoruz. Daha fazla bilgi edinmek için .NET Standard 2.1 belgelerine göz atın.

Google Ads API .NET kitaplığı, varsayılan aktarım katmanı olarak Grpc.Net.Client kullanır ve desteklenmeyen platformlarda Grpc.Core'e geri döner. UseGrpcCore politikasını true olarak ayarlayarak Grpc.Core kullanımını zorunlu kılabilirsiniz. Ancak Grpc.Core desteğinin sonlandırıldığını ve yalnızca eski bakım işlemleri için kullanıldığını unutmayın. Daha fazla bilgi için temel kullanım kılavuzuna bakın.

Kurulum

dotnet komut satırı aracını kullanarak projenize Google.Ads.GoogleAds NuGet paketini yükleyin:

dotnet add package Google.Ads.GoogleAds

Yapılandırma ayarlarını appsettings.json, App.config veya ortam değişkenlerinden yüklemek için Google.Ads.GoogleAds.Extensions paketini de yükleyin:

dotnet add package Google.Ads.GoogleAds.Extensions

İlk API çağrınızı yapma

Google Ads API'yi kullanmak için API'ye erişmek ve Google Ads hesaplarınızı yapılandırmak üzere birkaç adım uygulamanız gerekir. Google Ads hesaplarınızı oluşturma da dahil olmak üzere tüm önemli adımlarda size yol gösterecek hızlı başlangıç kılavuzunu inceleyin.

Temel kullanım

GoogleAdsConfig ve GoogleAdsClient öğelerini yapılandırma ayarlarınızla başlatın, GoogleAdsServiceClient öğesini alın ve kampanya satırlarını SearchStream ile akışa alın:

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 istemci kitaplığının nasıl kullanılacağı hakkında daha fazla bilgi edinmek için temel kullanım kılavuzuna bakın.

Yetkilendirme ve kimlik doğrulama

.NET istemci kitaplığı; OAuth 2.0 kullanıcı kimlik bilgileri (masaüstü ve web uygulamaları için), hizmet hesapları, Uygulama Varsayılan Kimlik Bilgileri (v24.1.0 ve sonraki sürümler) ve manuel kimlik bilgisi ekleme (v27.0.0 ve sonraki sürümler) dahil olmak üzere kimlik doğrulama ve yetkilendirme için birden fazla yaklaşımı destekler. Daha fazla bilgi için yetkilendirme ve kimlik doğrulama kılavuzuna bakın.

Yapılandırma ve günlük kaydı

.NET istemci kitaplığı, çalışma zamanı nesneleri, appsettings.json veya özel JSON dosyaları, ortam değişkenleri ya da App.config dosyaları kullanarak birden fazla yapılandırma ve günlük kaydı seçeneğini destekler. İstemci kitaplığının günlük kaydı davranışını değiştirmeniz gerekirse özel gRPC kesici kılavuzuna bakın.

Yardımcı Programlar

.NET istemci kitaplığı, medya ve video yükleme yardımcıları (v27.2.0 ve sonraki sürümlerde UploadVideo) dahil olmak üzere API kullanılabilirliğini iyileştiren yardımcı sınıflar içerir. Daha fazla bilgi edinmek için aşağıdaki rehberleri inceleyin:

Uygulama performansınızda ince ayar yapma

Uygulamanızın performansında ince ayar yapmayla ilgili öneriler için performans ayarlama kılavuzuna bakın.