ספריית הלקוח של ‎ .NET

ספריית הלקוח של ‎ .NET מתארחת ב-GitHub ומופצת כחבילת NuGet. היא כוללת כמה תכונות שעוזרות להשתמש ב-API, כולל ניהול קל יותר של פרטי הכניסה ויצירת לקוחות של שירות Google Ads API.

הספרייה תומכת בסביבות העבודה הבאות של ‎ .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 בפלטפורמות שלא נתמכות. אפשר לאלץ את השימוש ב-Grpc.Core על ידי הגדרת UseGrpcCore ל-true, אבל חשוב לזכור ש-Grpc.Core הוצא משימוש ומיועד רק לתחזוקה של גרסאות קודמות. מידע נוסף זמין במדריך השימוש הבסיסי.

התקנה

מתקינים את חבילת ה-NuGet של Google.Ads.GoogleAds בפרויקט באמצעות כלי שורת הפקודה dotnet:

dotnet add package Google.Ads.GoogleAds

כדי לטעון את הגדרות התצורה מ-appsettings.json, מ-App.config או ממשתני סביבה, צריך להתקין גם את החבילה Google.Ads.GoogleAds.Extensions:

dotnet add package Google.Ads.GoogleAds.Extensions

הערה: כל גרסה של Google.Ads.GoogleAds NuGet תומכת בגרסאות ספציפיות של Google Ads API. בטבלה גרסאות API נתמכות מפורטות הגרסאות התואמות.

שליחת הקריאה הראשונה ל-API

כדי להשתמש ב-Google Ads API, צריך לבצע כמה שלבים כדי לקבל גישה ל-API ולהגדיר את החשבונות ב-Google Ads. במדריך למתחילים מפורטים כל השלבים החשובים, כולל הגדרת חשבונות Google Ads.

שימוש בסיסי

מאתחלים את GoogleAdsConfig ואת GoogleAdsClient עם הגדרות התצורה, מאחזרים את GoogleAdsServiceClient ומעבירים שורות של קמפיינים בסטרימינג באמצעות SearchStream:

using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
    OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
    OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
    "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";

try
{
    googleAdsService.SearchStream(
        customerId,
        query,
        delegate (SearchGoogleAdsStreamResponse response)
        {
            foreach (GoogleAdsRow row in response.Results)
            {
                Console.WriteLine(
                    $"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
            }
        });
}
catch (GoogleAdsException ex)
{
    Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}

במדריך השימוש הבסיסי מוסבר איך משתמשים בספריית הלקוח ב-‎.NET.

הרשאה ואימות

ספריית הלקוח של ‎ .NET תומכת בכמה גישות לאימות ולהרשאה, כולל פרטי כניסה של משתמשים ב-OAuth 2.0 (לאפליקציות למחשב ולאינטרנט), חשבונות שירות, Application Default Credentials (גרסה v24.1.0 ואילך) והזרקה ידנית של פרטי כניסה (גרסה v27.0.0 ואילך). למידע נוסף, קראו את המדריך בנושא הרשאה ואימות.

הגדרות ורישום ביומן

ספריית הלקוח ב-‎ .NET תומכת בכמה אפשרויות הגדרה ורישום ביומן באמצעות אובייקטים של זמן ריצה, appsettings.json או קובצי JSON בהתאמה אישית, משתני סביבה או קובצי App.config. אם אתם צריכים לשנות את אופן הרישום ביומן של ספריית הלקוח, עיינו במדריך למיירט gRPC בהתאמה אישית.

כלי תחזוקה

ספריית הלקוח של ‎ .NET כוללת מחלקות של כלי שירות שמשפרות את נוחות השימוש ב-API, כולל רכיבי עזר להעלאת מדיה וסרטונים (UploadVideo ב-v27.2.0 ואילך). במדריכים הבאים אפשר למצוא מידע נוסף:

• FieldMasks
• ResourceNames
• סוגים של מאגרי אחסון לפרוטוקולים

שיפור ביצועי האפליקציה

במדריך לכוונון הביצועים מפורטות המלצות לכוונון הביצועים של האפליקציה.