دات نت

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

.NET CLI 

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);
        }
    }

برای نمونه‌های روش‌ها و منابع دیگر، به مخزن 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);

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

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