.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 belgelerini inceleyin.

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 ayarını true olarak belirleyerek Grpc.Core kullanımını zorunlu kılabilirsiniz. Ancak Grpc.Core'nın desteğinin sonlandırıldığını ve yalnızca eski sistemlerin bakımı için kullanıldığını unutmayın. Daha fazla bilgi için temel kullanım kılavuzuna bakın.

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

Google Ads API'yi kullanmak için API'ye erişim sağlamak ve Google Ads hesaplarınızı yapılandırmak üzere çeşitli adımlar 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

GoogleAdsClient hizmetini yapılandırma ayarlarınızla başlatın ve API çağrıları yapmak için bir hizmet istemcisi alın:

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

.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 yerleştirme (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, App.config dosyaları, JSON yapılandırma dosyaları veya ortam değişkenleri kullanılarak birden fazla yapılandırma ve günlüğe kaydetme seçeneğini destekler. İstemci kitaplığının günlük kaydı davranışını değiştirmeniz gerekirse özel gRPC araya girme 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ını nasıl ince ayarlayacağınızla ilgili öneriler için performans ayarlama kılavuzuna bakın.