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

שינויים בספריית .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. ספריית ה- .NET של Google Ads API תלויה בחבילה 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+