ספריית הלקוח של .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.V26.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 ואילך).
במדריכים הבאים אפשר למצוא מידע נוסף:
שיפור הביצועים של האפליקציה
במדריך לכוונון הביצועים מפורטות המלצות לכוונון הביצועים של האפליקציה.