دعم GRPC

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

سبب التبديل

من المقرر إيقاف Grpc.Core نهائيًا، وGrpc.Net.Client هو التنفيذ الرسمي لـ gRPC من الآن فصاعدًا. يُرجى قراءة الإشعار.

تغييرات في مكتبة Google Ads API .NET

كجزء من عملية النقل، أجرينا التغييرات التالية على مكتبة برامجنا.

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

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

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

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

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

    ونتيجةً لذلك، تم تعديل متطلبات وقت تشغيل مكتبة Google Ads API .NET إلى الإصدار NET Standard 2.1. تستمر مكتبة "إعلانات Google API" في دعم نظامَي .NET الترويجي 4.7.2 والإصدارات الأحدث و .NET 5.0 والإصدارات الأحدث.