Thư viện ứng dụng

Thư viện ứng dụng cung cấp chế độ xem cấp cao và các khối xây dựng cơ bản về chức năng của API Google Ads, giúp bạn phát triển ứng dụng nhanh chóng hơn. Bạn nên bắt đầu với một API nếu mới sử dụng API.

Thư viện ứng dụng Nguồn Phân phối Ví dụ về mã
Java google-ads-java Maven, tar.gz Xem trên GitHub
.NET google-ads-dotnet nuget, tar.gz, zip Xem trên GitHub
PHP google-ads-php tar.gz Xem trên GitHub
Python google-ads-python tar.gz, zip Xem trên GitHub
Ruby google-ads-ruby gem, tar.gz, zip Xem trên GitHub
Đặc quyền google-ads-perl tar.gz, zip Xem trên GitHub

Phiên bản API được hỗ trợ

Bảng bên dưới liệt kê các phiên bản thư viện cụ thể hỗ trợ từng phiên bản API có sẵn.

Java

API và các phiên bản Java/Tối thiểu được hỗ trợ
phiên bản 12 Min: 22.0.0
Max:
phiên bản 11 Min: 19.0.0
Max:
phiên bản 10 Min: 17.0.0
Max:

C#

API và các phiên bản Min/Max .NET được hỗ trợ
phiên bản 12 Min: 14.2.0
Max:
phiên bản 11 Min: 12.1.0
Max:
phiên bản 10 Min: 11.0.0
Max:

PHP

API và các phiên bản PHP/tối thiểu được hỗ trợ
phiên bản 12 Min: 17.1.0
Max:
phiên bản 11 Min: 15.1.0
Max:
phiên bản 10 Min: 14.0.0
Max:

Python

API và các phiên bản Python tối thiểu/tối đa được hỗ trợ
phiên bản 12 Min: 19.0.0
Max:
phiên bản 11 Min: 17.0.0
Max:
phiên bản 10 Min: 15.0.0
Max:

Ruby

API và các phiên bản Min/Max Ruby được hỗ trợ
phiên bản 12 Min: 20.0.0
Max:
phiên bản 11 Min: 18.0.0
Max:
phiên bản 10 Min: 16.0.0
Max:

Perl

API và các phiên bản Min/Max Perl được hỗ trợ
phiên bản 12 Min: 14.0.0
Max:
phiên bản 11 Min: 12.0.0
Max:
phiên bản 10 Min: 10.0.0
Max:

Cấu hình

Mỗi thư viện ứng dụng API cho quảng cáo cung cấp các chế độ cài đặt cấu hình và phương thức tải mà bạn có thể dùng để tuỳ chỉnh hành vi.

Dưới đây là các biến môi trường phổ biến với tất cả thư viện ứng dụng và có thể được tải để đặt cài đặt cấu hình:

  • Thư viện ứng dụng
    • GOOGLE_ADS_CONFIGURATION_FILE_PATH: Đường dẫn đến tệp cấu hình.
  • OAuth2
    • Chế độ ứng dụng
      • GOOGLE_ADS_CLIENT_ID : Đặt giá trị này thành ID ứng dụng khách OAuth2 của bạn.
      • GOOGLE_ADS_CLIENT_SECRET : Đặt giá trị này thành mật khẩu ứng dụng khách OAuth2 của bạn.
      • GOOGLE_ADS_REFRESH_TOKEN : Đặt giá trị này thành mã làm mới OAuth2 được tạo sẵn nếu bạn muốn sử dụng lại mã thông báo OAuth2. Chế độ cài đặt này không bắt buộc.
    • Chế độ tài khoản dịch vụ
      • GOOGLE_ADS_JSON_KEY_FILE_PATH: Đặt giá trị này thành đường dẫn tệp cấu hình OAuth2.
      • GOOGLE_ADS_IMPERSONATED_EMAIL : Đặt giá trị này thành địa chỉ email của tài khoản mà bạn đang mạo danh.
  • API Google Ads
    • GOOGLE_ADS_DEVELOPER_TOKEN : Đặt mã này thành mã của nhà phát triển.
    • GOOGLE_ADS_LOGIN_CUSTOMER_ID : Đây là mã khách hàng của khách hàng được ủy quyền sử dụng trong yêu cầu, không có dấu gạch nối (-).
    • GOOGLE_ADS_LINKED_CUSTOMER_ID : Tiêu đề này chỉ bắt buộc đối với các phương thức cập nhật tài nguyên của một thực thể khi được cấp quyền thông qua Tài khoản được liên kết trong giao diện người dùng Google Ads (tài nguyên AccountLink trong API Google Ads). Đặt giá trị này thành mã khách hàng của nhà cung cấp dữ liệu sẽ cập nhật tài nguyên của mã khách hàng được chỉ định. Bạn phải đặt thuộc tính này mà không có dấu gạch nối (-). Để tìm hiểu thêm về Tài khoản được liên kết, hãy truy cập vào Trung tâm trợ giúp.