Thư viện ứng dụng .NET

Thư viện ứng dụng .NET được lưu trữ trên GitHub và được phân phối dưới dạng gói NuGet. Thư viện này cung cấp một số tính năng giúp bạn sử dụng API, bao gồm cả việc quản lý thông tin xác thực và tạo ứng dụng dịch vụ Google Ads API dễ dàng hơn.

Thư viện này hỗ trợ các khung .NET sau:

  • .NET Framework 4.7.2 trở lên (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1 tương thích với một số phiên bản và cách triển khai .NET khác, vì vậy, thư viện này có thể hoạt động tốt trên nhiều nền tảng khác. Tuy nhiên, chúng tôi chưa chính thức kiểm tra khả năng tương thích và do đó không chính thức hỗ trợ các nền tảng này. Hãy xem tài liệu về.NET Standard 2.1 để tìm hiểu thêm.

Thư viện .NET của Google Ads API sử dụng Grpc.Net.Client làm tầng truyền tải mặc định, với phương án dự phòng là Grpc.Core trên các nền tảng không được hỗ trợ. Mặc dù bạn có thể buộc sử dụng Grpc.Core bằng cách đặt UseGrpcCore thành true, nhưng xin lưu ý rằng Grpc.Core không còn được dùng nữa và chỉ dành cho việc bảo trì phiên bản cũ. Hãy xem hướng dẫn sử dụng cơ bản để tìm hiểu thêm.

Cài đặt

Cài đặt gói NuGet Google.Ads.GoogleAds trong dự án của bạn bằng công cụ dòng lệnh dotnet:

dotnet add package Google.Ads.GoogleAds

Để tải chế độ cài đặt cấu hình từ appsettings.json, App.config hoặc biến môi trường, hãy cài đặt cả gói Google.Ads.GoogleAds.Extensions:

dotnet add package Google.Ads.GoogleAds.Extensions

Thực hiện lệnh gọi API đầu tiên

Để sử dụng Google Ads API, bạn cần thực hiện một số bước để có quyền truy cập vào API này và định cấu hình tài khoản Google Ads. Hãy làm theo hướng dẫn bắt đầu nhanh, trong đó có tất cả các bước quan trọng, bao gồm cả việc thiết lập tài khoản Google Ads.

Cách sử dụng cơ bản

Khởi chạy GoogleAdsConfig và GoogleAdsClient bằng chế độ cài đặt cấu hình, truy xuất GoogleAdsServiceClient và truyền trực tuyến các hàng của chiến dịch bằng 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}");
}

Tham khảo hướng dẫn sử dụng cơ bản để tìm hiểu thêm về cách sử dụng thư viện ứng dụng .NET.

Uỷ quyền và xác thực

Thư viện ứng dụng .NET hỗ trợ nhiều phương pháp xác thực và uỷ quyền, bao gồm thông tin xác thực người dùng OAuth 2.0 (cho ứng dụng web và máy tính), tài khoản dịch vụ, Thông tin xác thực mặc định của ứng dụng (v24.1.0 trở lên) và chèn thông tin xác thực theo cách thủ công (v27.0.0 trở lên). Hãy tham khảo hướng dẫn về uỷ quyền và xác thực để tìm hiểu thêm.

Cấu hình và ghi nhật ký

Thư viện ứng dụng .NET hỗ trợ nhiều lựa chọn cấu hình và ghi nhật ký bằng cách sử dụng đối tượng thời gian chạy, appsettings.json hoặc tệp JSON tuỳ chỉnh, biến môi trường hoặc tệp App.config. Trong trường hợp bạn cần sửa đổi hành vi ghi nhật ký của thư viện ứng dụng, hãy tham khảo hướng dẫn về trình chặn gRPC tuỳ chỉnh.

Tiện ích

Thư viện ứng dụng .NET bao gồm các lớp tiện ích để cải thiện khả năng hữu dụng của API, bao gồm cả trình trợ giúp tải nội dung nghe nhìn và video lên (UploadVideo trong v27.2.0 trở lên). Hãy tham khảo các hướng dẫn sau để tìm hiểu thêm:

Tinh chỉnh hiệu suất ứng dụng

Tham khảo hướng dẫn điều chỉnh hiệu suất để biết các đề xuất về cách tinh chỉnh hiệu suất của ứng dụng.