دات نت

‫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-beta13" />

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta13

پیکربندی اعتبارنامه‌ها

کتابخانه کارخواه .NET از OAuth2 و اعتبارنامه‌های پیش‌فرض برنامه (ADC) برای اصالت‌سنجی استفاده می‌کند.

‫ADC به‌ترتیب در مکان‌های زیر به‌دنبال اطلاعات اعتباری می‌گردد:

1. متغیر محیط GOOGLE_APPLICATION_CREDENTIALS.
2. اطلاعات اعتباری کاربر ازطریق Google Cloud CLI (gcloud CLI) راه‌اندازی شده است.
3. وقتی در 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);
        }
    }
NetworkServiceClient.GetNetworkSnippet.g.cs

برای نمونه‌هایی از روش‌ها و منابع دیگر، به مخزن GitHub googleapis/google-cloud-dotnet مراجعه کنید.

مدیریت خطاها

همه خطاهای «میانای برنامه‌سازی کاربردی Ad Manager» از نوع 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);

پیکربندی تنظیمات پروکسی

کتابخانه مشتری .NET از دارایی HttpClient.DefaultProxy ازجمله تنظیم پراکسی‌ها از متغیرهای محیطی HTTP_PROXY و HTTPS_PROXY پیروی می‌کند. برای جزئیات بیشتر، HttpClient.DefaultProxy Property را ببینید.