תמיכה ב-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 הוא ההטמעה הרשמית של C# של gRPC מעכשיו. לקריאת ההודעה

שינויים בספריית Google Ads API .NET

במסגרת המעבר, ביצענו את השינויים הבאים בספריית הלקוח שלנו.

  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 Framework לגרסה 4.0.0 ואת הדרישה בסביבת זמן הריצה ל-NET Standard 2.1.

    כתוצאה מכך, דרישת זמן הריצה של ספריית Google Ads API .NET עודכנה ל-NET Standard 2.1. ספריית Google Ads API ממשיכה לתמוך ב- .NET Framework 4.7.2 + וב- .NET 5.0+