پشتیبانی از gRPC

هشدار: با شروع نسخه 19.0.0 ، کتابخانه سرویس گیرنده Google Ads API برای دات نت دیگر از NET 5.0 پشتیبانی نخواهد کرد. برای اطمینان از عملکرد یکپارچه، اکیداً توصیه می کنیم نسخه نسخه دات نت خود را قبل از پایان سال 2024 ارتقا دهید.

تا نسخه 13.0.2، کتابخانه Google Ads API .NET از کتابخانه Grpc.Core برای عملکرد gRPC استفاده می کرد. از نسخه 14.0.0 کتابخانه مشتری، ما از Grpc.Net.Client به عنوان کتابخانه پیش‌فرض برای عملکرد gRPC استفاده می‌کنیم و Grpc.Core به عنوان نسخه بازگشتی. این راهنما جزئیات فنی مربوط به این تغییر را پوشش می دهد.

دلیل سوئیچ

Grpc.Core برای غروب خورشید برنامه ریزی شده است و Grpc.Net.Client پیاده سازی رسمی C# از gRPC در آینده است. اطلاعیه را بخوانید .

تغییرات در کتابخانه Google Ads API .NET

به عنوان بخشی از سوئیچ، ما تغییرات زیر را در کتابخانه مشتری خود ایجاد کرده ایم.

1. یک تنظیم GoogleAdsConfig جدید با نام UseGrpcCore معرفی کرد.

   • این تنظیم به طور پیش فرض روی false است.

   • وقتی این تنظیم روی false تنظیم شود، کتابخانه تلاش می کند تا در صورت امکان از Grpc.Net.Client به عنوان لایه زیرین انتقال استفاده کند.

     Grpc.Net.Client از برخی از نسخه های زمان اجرا دات نت قدیمی پشتیبانی نمی کند (به الزامات مراجعه کنید). در این پلتفرم‌ها، کتابخانه Google Ads API .NET به استفاده از کتابخانه Grpc.Core به‌عنوان لایه انتقال زیرین بازمی‌گردد.

   • می‌توانید با تنظیم UseGrpcCore روی true ، کتابخانه Google Ads API.NET را مجبور کنید همیشه از کتابخانه Grpc.Core استفاده کند.

2. کتابخانه Google Ads API .NET به بسته Google.Api.Gax.Grpc (بخشی از Google Cloud SDK) بستگی دارد. با توجه به تغییر کتابخانه gRPC، این بسته نسخه اصلی .NET Framework خود را به 4.0.0 و نیاز زمان اجرا خود را به NET Standard 2.1 به روز کرده است.

   در نتیجه، الزامات زمان اجرا کتابخانه دات نت API Google Ads به NET Standard 2.1 به روز شده است. کتابخانه Google Ads API همچنان از .NET Framework 4.7.2 و بالاتر و NET 5.0 و بالاتر پشتیبانی می کند.