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 đăng nhập dễ dàng hơn và tạo các ứng dụng dịch vụ Google Ads API.
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 hỗ trợ chính thức 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 lớp truyền tải mặc định, với một 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 lưu ý rằng Grpc.Core không được dùng nữa và chỉ dành cho việc duy 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.
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 và định cấu hình tài khoản Google Ads. Làm theo hướng dẫn bắt đầu nhanh. Hướng dẫn này sẽ chỉ cho bạn tất cả các bước quan trọng, bao gồm cả cách thiết lập tài khoản Google Ads.
Cách sử dụng cơ bản
Khởi chạy GoogleAdsClient bằng chế độ cài đặt cấu hình và truy xuất một ứng dụng khách dịch vụ để thực hiện các lệnh gọi API:
GoogleAdsClient client = new GoogleAdsClient();
GoogleAdsServiceClient googleAdsService =
client.GetService(Services.V25.GoogleAdsService);
Hãy 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 cả thông tin xác thực người dùng OAuth 2.0 (cho ứng dụng dành cho máy tính và web), 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à quy trình 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 các đối tượng thời gian chạy, tệp App.config, tệp cấu hình JSON hoặc biến môi trường. 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 sử dụng API, bao gồm cả các trình trợ giúp tải video và nội dung nghe nhìn 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 điều chỉnh hiệu suất của ứng dụng.