Google מספקת ספריית לקוח ל- .NET ליצירת אינטראקציה עם Ad Manager API. מומלץ להשתמש בספריית הלקוח עם NuGet.
כדי להתחיל, יוצרים פרויקט חדש בסביבת הפיתוח המשולבת (IDE) שבחרתם או מוסיפים את התלות לפרויקט קיים. Google מפרסמת את הארטיפקטים של ספריות הלקוח במאגר NuGet בתור Google.Ads.AdManager.V1
.
מסמך עזר בנושא חבילות
<!-- MyProject.csproj -->
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
.NET CLI
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
הגדרת פרטי הכניסה
ספריית הלקוח של .NET משתמשת ב-OAuth2 וב-Application Default Credentials (ADC) כדי לבצע אימות.
החיפוש של פרטי הכניסה ב-ADC מתבצע בסדר הבא במיקומים הבאים:
- משתנה הסביבה
GOOGLE_APPLICATION_CREDENTIALS
. - פרטי הכניסה של משתמשים שהוגדרו דרך Google Cloud CLI (CLI של gcloud).
- כשהאפליקציה פועלת ב-Google Cloud, חשבון השירות שמצורף למשאב ב-Google Cloud.
במאמר אימות מוסבר איך יוצרים ומגדירים את פרטי הכניסה ל-ADC.
שליחת הבקשה הראשונה
לכל שירות יש אובייקט ServiceClient
עם שיטות סינכרוניות ואסינכרוניות לכל שיטת REST. בדוגמה הבאה קוראים Network
באופן סינכרוני. כל הישויות מזוהות באמצעות שם משאב שמורכב מהסוג ומהמזהה המספרי של הישות.
using Google.Ads.AdManager.V1;
public sealed partial class GeneratedNetworkServiceClientSnippets
{
public void GetNetwork()
{
// Create client
NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
// Initialize request argument(s)
string name = "networks/[NETWORK_CODE]";
// Make the request
Network response = networkServiceClient.GetNetwork(name);
}
}
דוגמאות לשיטות ולמשאבים אחרים זמינות במאגר GitHub googleapis/google-cloud-dotnet
.
טיפול בשגיאות
כל השגיאות של Ad Manager API הן מהסוג Grpc.Core.RpcException בספריית הלקוח של .NET.
השגיאות כוללות מזהה request_id
ייחודי שאפשר לספק לתמיכה כדי לקבל עזרה בפתרון הבעיות. בדוגמה הבאה מתבצעת חילוץ של סטטוס ה-HTTP, הודעת השגיאה ו-request_id
.
using Google.Ads.AdManager.V1;
using Google.Api.Gax.Grpc;
using Google.Rpc;
using Grpc.Core;
try
{
NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
Network network = networkServiceClient.GetNetwork("networks/[NETWORK_CODE]");
}
catch(RpcException e)
{
// HTTP Status code
StatusCode statusCode = e.Status.StatusCode;
// Error message
string errorMessage = e.Status.Detail;
// Unique request identifier.
RequestInfo requestInfo = e.GetStatusDetail<RequestInfo>();
string requestId = requestInfo?.RequestId ?? "Unexpected null request identifier";
}
בניית שמות של משאבים
ספריית הלקוח מספקת כיתות עזר ליצירת שמות של משאבים ממזהים. אפשר להעביר אותם ישירות לשיטות השירות.
// Represents a resource name in the format:
// "networks/{networkCode}/orders/{orderId}"
OrderName name = OrderName.FromNetworkCodeOrder("123", "456");
Order response = orderServiceClient.GetOrder(name);