Dukungan untuk gRPC

Hingga v13.0.2, library .NET Google Ads API menggunakan library Grpc.Core untuk fungsi gRPC. Mulai library klien versi 14.0.0, kami menggunakan Grpc.Net.Client sebagai library default untuk fungsi gRPC, dengan Grpc.Core sebagai penggantinya. Panduan ini membahas detail teknis yang terkait dengan perubahan ini.

Alasan peralihan

Grpc.Core dijadwalkan untuk dihentikan, dan Grpc.Net.Client adalah implementasi C# resmi gRPC ke depannya. Baca pengumumannya.

Perubahan pada library .NET Google Ads API

Sebagai bagian dari peralihan tersebut, kami telah melakukan perubahan berikut pada library klien.

1. Memperkenalkan setelan GoogleAdsConfig baru bernama UseGrpcCore.

   • Setelan ini ditetapkan secara default ke false.

   • Jika setelan ini ditetapkan ke false, library akan mencoba menggunakan Grpc.Net.Client sebagai lapisan transportasi yang mendasarinya jika memungkinkan.

     Grpc.Net.Client tidak mendukung beberapa versi runtime .NET yang lama (lihat persyaratan). Di platform ini, library .NET Google Ads API akan kembali menggunakan library Grpc.Core sebagai lapisan transportasi yang mendasarinya.

   • Anda dapat memaksa library .NET Google Ads API untuk menggunakan library Grpc.Core sepanjang waktu dengan menetapkan UseGrpcCore ke true.

2. Library .NET Google Ads API bergantung pada paket Google.Api.Gax.Grpc (bagian dari Google Cloud SDK). Karena perubahan library gRPC, paket ini telah mengupdate versi utama .NET Framework ke 4.0.0 dan persyaratan runtime-nya menjadi .NET Standard 2.1.

   Oleh karena itu, persyaratan runtime library .NET Google Ads API telah diperbarui menjadi .NET Standard 2.1. Library Google Ads API terus mendukung .NET Framework 4.7.2+ dan .NET 5.0+.