Library klien .NET

Library klien .NET dihosting di GitHub dan didistribusikan sebagai paket NuGet. Library ini menawarkan beberapa fitur untuk membantu Anda menggunakan API, termasuk pengelolaan kredensial yang lebih mudah dan pembuatan klien layanan Google Ads API.

Library ini mendukung framework .NET berikut:

  • .NET Framework 4.7.2 dan yang lebih baru (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1 kompatibel dengan beberapa versi dan implementasi .NET lainnya, sehingga library ini mungkin berfungsi dengan baik di banyak platform lain. Namun, kami belum menguji kompatibilitasnya secara resmi, sehingga tidak mendukung platform ini secara resmi. Lihat dokumentasi.NET Standard 2.1 untuk mempelajari lebih lanjut.

Library .NET Google Ads API menggunakan Grpc.Net.Client sebagai lapisan transpor default, dengan penggantian ke Grpc.Core pada platform yang tidak didukung. Meskipun Anda dapat memaksa penggunaan Grpc.Core dengan menetapkan UseGrpcCore ke true, perhatikan bahwa Grpc.Core tidak digunakan lagi dan hanya ditujukan untuk pemeliharaan lama. Lihat panduan penggunaan dasar untuk mempelajari lebih lanjut.

Penginstalan

Instal paket NuGet Google.Ads.GoogleAds di project Anda menggunakan alat command line dotnet:

dotnet add package Google.Ads.GoogleAds

Untuk memuat setelan konfigurasi dari appsettings.json, App.config, atau variabel lingkungan, instal juga paket Google.Ads.GoogleAds.Extensions:

dotnet add package Google.Ads.GoogleAds.Extensions

Melakukan panggilan API pertama Anda

Untuk menggunakan Google Ads API, Anda harus melakukan beberapa langkah untuk mendapatkan akses ke API dan mengonfigurasi akun Google Ads Anda. Ikuti panduan memulai cepat, yang akan memandu Anda melalui semua langkah penting, termasuk menyiapkan akun Google Ads.

Penggunaan dasar

Lakukan inisialisasi GoogleAdsConfig dan GoogleAdsClient dengan setelan konfigurasi Anda, ambil GoogleAdsServiceClient, dan streaming baris kampanye dengan SearchStream:

using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
    OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
    OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
    "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";

try
{
    googleAdsService.SearchStream(
        customerId,
        query,
        delegate (SearchGoogleAdsStreamResponse response)
        {
            foreach (GoogleAdsRow row in response.Results)
            {
                Console.WriteLine(
                    $"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
            }
        });
}
catch (GoogleAdsException ex)
{
    Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}

Lihat panduan penggunaan dasar untuk mempelajari lebih lanjut cara menggunakan library klien .NET.

Otorisasi dan autentikasi

Library klien .NET mendukung beberapa pendekatan untuk autentikasi dan otorisasi, termasuk kredensial pengguna OAuth 2.0 (untuk aplikasi desktop dan web), akun layanan, Kredensial Default Aplikasi (v24.1.0 dan yang lebih baru), dan injeksi kredensial manual (v27.0.0 dan yang lebih baru). Lihat panduan otorisasi dan autentikasi untuk mempelajari lebih lanjut.

Konfigurasi dan logging

Library klien .NET mendukung beberapa opsi konfigurasi dan logging menggunakan objek runtime, appsettings.json atau file JSON kustom, variabel lingkungan, atau file App.config. Jika Anda perlu mengubah perilaku logging library klien, lihat panduan pencegat gRPC kustom.

Utilitas

Library klien .NET menyertakan class utilitas untuk meningkatkan kegunaan API, termasuk helper upload media dan video (UploadVideo di v27.2.0 dan yang lebih baru). Lihat panduan berikut untuk mempelajari lebih lanjut:

Menyesuaikan performa aplikasi Anda

Lihat panduan penyesuaian performa untuk mendapatkan rekomendasi tentang cara menyesuaikan performa aplikasi Anda.