ספריית הלקוח של .NET מתארחת ב-GitHub ומופצת כחבילת NuGet. הספרייה כוללת כמה תכונות שעוזרות להשתמש ב-API, כולל ניהול קל יותר של פרטי הכניסה ויצירה של לקוחות שירות של Google Ads API.
הספרייה תומכת ב-frameworks הבאים של .NET:
- .NET Framework 4.7.2 ואילך (
net472) - .NET Standard 2.1 (
netstandard2.1) - .NET 8.0 (
net8.0)
.NET Standard 2.1 תואם לכמה גרסאות ויישומים אחרים של .NET, כך שהספרייה עשויה לפעול בצורה תקינה בהרבה פלטפורמות אחרות. עם זאת, לא בדקנו באופן רשמי את התאימות ולכן אנחנו לא תומכים בפלטפורמות האלה באופן רשמי. מידע נוסף זמין במאמרי העזרה בנושא .NET Standard 2.1.
ספריית .NET של Google Ads API משתמשת ב-Grpc.Net.Client כשכבת התעבורה שמוגדרת כברירת מחדל, עם חזרה ל-Grpc.Core בפלטפורמות שלא נתמכות. אפשר להגדיר את UseGrpcCore ל-true כדי לאלץ את השימוש ב-Grpc.Core, אבל חשוב לזכור ש-Grpc.Core הוצא משימוש והוא מיועד רק לתחזוקה של מערכות מדור קודם. מידע נוסף מופיע במדריך לשימוש בסיסי.
ביצוע הקריאה הראשונה ל-API
כדי להשתמש ב-Google Ads API, צריך לבצע כמה שלבים כדי לקבל גישה ל-API ולהגדיר את חשבונות Google Ads. כדי להגדיר את החשבונות ב-Google Ads, צריך לפעול לפי מדריך ההתחלה המהירה, שכולל את כל השלבים החשובים.
שימוש בסיסי
מפעילים את GoogleAdsClient עם הגדרות התצורה ומאחזרים לקוח שירות כדי לבצע קריאות ל-API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
במדריך לשימוש בסיסי מוסבר איך להשתמש בספריית הלקוח של .NET.
הרשאה ואימות
ספריית הלקוח של .NET תומכת בכמה גישות לאימות ולהרשאה, כולל פרטי כניסה של משתמשים ב-OAuth 2.0 (לאפליקציות למחשב ולאפליקציות אינטרנט), חשבונות שירות, Application Default Credentials (ADC) (גרסה v24.1.0 ואילך) והזנת פרטי כניסה באופן ידני (גרסה v27.0.0 ואילך). מידע נוסף זמין במדריך בנושא הרשאה ואימות.
הגדרות ורישום ביומן
ספריית הלקוח של .NET תומכת בכמה אפשרויות של הגדרות
ורישום ביומן באמצעות אובייקטים של זמן ריצה, קובצי App.config,
JSON קובצי הגדרות או משתני סביבה. אם אתם צריכים לשנות את התנהגות הרישום ביומן של ספריית הלקוח, כדאי לעיין במדריך בנושא יירוט gRPC בהתאמה אישית.
כלי תחזוקה
ספריית הלקוח של .NET כוללת מחלקות כלי עזר לשיפור השימושיות של ה-API, כולל כלי עזר להעלאת מדיה ווידאו (UploadVideo בגרסה v27.2.0 ואילך).
במדריכים הבאים אפשר למצוא מידע נוסף:
שיפור הביצועים של האפליקציה
במדריך לכוונון הביצועים מפורטות המלצות לאופטימיזציה של ביצועי האפליקציה.