.NET istemci kitaplığı

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

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 uyumluluk resmi olarak test edilmediği için bu platformlar resmi olarak desteklenmemektedir. Daha fazla bilgi edinmek için .NET Standard 2.1 belgelerini inceleyin.

Google Ads API .NET kitaplığı, varsayılan taşıma katmanı olarak Grpc.Net.Client'yı kullanır. Desteklenmeyen platformlarda Grpc.Core'ye geri dönüş yapılır. 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 öğesini 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.V25.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 edinmek için yetkilendirme ve kimlik doğrulama kılavuzunu inceleyin.

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

.NET istemci kitaplığı, çalışma zamanı nesnelerini, App.config dosyalarını, JSON yapılandırma dosyalarını veya ortam değişkenlerini 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 araya girme kılavuzuna bakın.

Yardımcı Programlar

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

Uygulama performansınızı iyileştirme

Uygulamanızın performansını nasıl ince ayarlayacağınızla ilgili öneriler için performans ayarlama kılavuzuna bakın.