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

.NET CLI

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

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 akan dilampirkan 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 dengan 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 adalah jenis Grpc.Core.RpcException di library klien .NET.

Error menyertakan request_id unik yang dapat Anda berikan ke dukungan untuk mendapatkan bantuan dalam memecahkan 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. Parameter 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);