دعم GRPC

استخدمت مكتبة Google Ads API.NET مكتبة Grpc.Core لوظائف gRPC، حتى الإصدار 13.0 .2. بدايةً من الإصدار 14.0.0 من مكتبة البرامج، سنستخدم Grpc.Net.Client كمكتبة تلقائية لوظائف gRPC، وسيكون Grpc.Core كالاحتياطي. يتناول هذا الدليل التفاصيل الفنية المتعلقة بهذا التغيير.

سبب التبديل

من المقرّر أن يتم إيقاف تطبيق "Grpc.Core" نهائيًا، ويمثّل Grpc.Net.Client التنفيذ الرسمي لـ C# لـ gRPC من الآن فصاعدًا. قراءة الإشعار

تغييرات في مكتبة .NET ضمن واجهة Google Ads API

في إطار عملية التبديل، أجرينا التغييرات التالية على مكتبة العملاء.

1. تم تقديم إعداد جديد في GoogleAdsConfig باسم "UseGrpcCore".

   • يتم ضبط هذا الإعداد تلقائيًا على false.

   • عند ضبط هذه الإعدادات على false، تحاول المكتبة استخدام Grpc.Net.Client كطبقة النقل الأساسية متى أمكن.

     لا يتوافق Grpc.Net.Client مع بعض الإصدارات القديمة لوقت تشغيل .NET (راجِع المتطلبات). على هذه المنصات، ستعود مكتبة Google Ads API .NET إلى استخدام مكتبة Grpc.Core كطبقة النقل الأساسية.

   • يمكنك أن تفرض على مكتبة .NET في Google Ads API استخدام مكتبة Grpc.Core طوال الوقت من خلال ضبط UseGrpcCore على true.

2. تعتمد مكتبة Google Ads API .NET على حزمة Google.Api.Gax.Grpc (جزء من Google Cloud SDK). بسبب تغيير في مكتبة gRPC، قامت هذه الحزمة بتحديث الإصدار الرئيسي من .NET iFrame إلى 4.0.0 ومتطلبات وقت التشغيل الخاصة بها إلى .NET Standard 2.1.

   ونتيجةً لذلك، تم تعديل متطلبات وقت تشغيل مكتبة .NET ضمن Google Ads API إلى .NET Standard 2.1. تواصل مكتبة Google Ads API إتاحة الإصدارات 4.7.2+ و.NET 5.0+.