.NET

Google menyediakan library klien .NET untuk berinteraksi dengan Ad Manager API. Sebaiknya gunakan library klien dengan NuGet.

Untuk memulai, buat project baru di IDE pilihan Anda atau tambahkan dependensi ke project yang ada. Google memublikasikan artefak library klien ke repositori NuGet sebagai Google.Ads.AdManager.V1.

Referensi Paket 

<!-- MyProject.csproj -->
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta11" />

CLI .NET 

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

Mengonfigurasi kredensial

Library klien .NET menggunakan OAuth2 dan Kredensial Default Aplikasi (ADC) untuk mengautentikasi.

ADC menelusuri kredensial secara berurutan di lokasi berikut:

  1. Variabel lingkungan GOOGLE_APPLICATION_CREDENTIALS.
  2. Kredensial pengguna yang disiapkan melalui Google Cloud CLI (gcloud CLI).
  3. Saat berjalan di Google Cloud, akun layanan yang terlampir ke resource Google Cloud.

Untuk membuat dan mengonfigurasi kredensial ADC, lihat Autentikasi.

Membuat permintaan pertama Anda

Setiap layanan memiliki objek ServiceClient dengan metode sinkron dan asinkron untuk setiap metode REST. Contoh berikut membaca Network secara sinkron. Semua entity diidentifikasi berdasarkan nama resource yang terdiri dari jenis dan ID numerik entity.

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

Untuk contoh metode dan resource lainnya, lihat repositori GitHub googleapis/google-cloud-dotnet.

Menangani error

Semua error Ad Manager API bertipe Grpc.Core.RpcException di library klien .NET.

Error mencakup request_id unik yang dapat Anda berikan kepada dukungan untuk mendapatkan bantuan terkait pemecahan masalah. Contoh berikut mengekstrak status HTTP, pesan error, dan 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";
}

Membuat nama resource

Library klien menyediakan class helper untuk membuat nama resource dari ID. Objek ini dapat diteruskan langsung ke metode layanan.

//  Represents a resource name in the format:
//  "networks/{networkCode}/orders/{orderId}"
OrderName name = OrderName.FromNetworkCodeOrder("123", "456");
Order response = orderServiceClient.GetOrder(name);

Mengonfigurasi setelan proxy

Library klien .NET mematuhi properti HttpClient.DefaultProxy, termasuk menetapkan proxy dari variabel lingkungan HTTP_PROXY dan HTTPS_PROXY. Untuk mengetahui detail selengkapnya, lihat Properti HttpClient.DefaultProxy.