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:
- Variabel lingkungan
GOOGLE_APPLICATION_CREDENTIALS
. - Kredensial pengguna yang disiapkan melalui Google Cloud CLI (gcloud CLI).
- 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);