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 penggantian. Panduan ini membahas detail teknis yang terkait dengan perubahan ini.

Alasan pengalihan

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

Perubahan pada library .NET Google Ads API

Sebagai bagian dari peralihan, 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 disetel ke false, library akan mencoba menggunakan Grpc.Net.Client sebagai lapisan transportasi dasar jika memungkinkan.

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

   • 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 Frameworknya 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+.