API Báo cáo Search Ads 360 mới hiện đã ra mắt. Tham gia nhóm Google searchads-api-announcements để luôn được cập nhật về những cải tiến và bản phát hành sắp tới.

Trang này được dịch bởi Cloud Translation API.

Cấu hình thư viện ứng dụng Python

Cài đặt thư viện ứng dụng Python

Để cài đặt thư viện ứng dụng Python trong môi trường cục bộ của bạn, hãy làm như sau:

Giải nén tarball của thư viện ứng dụng Python.
Chạy lệnh sau trong cùng thư mục:
```
python -m pip install .
```
Làm theo lời nhắc trong cửa sổ dòng lệnh để hoàn tất quá trình cài đặt.

Cấu hình bằng tệp YAML

Bạn có thể chỉ định tệp YAML để sử dụng khi khởi chạy ứng dụng có chứa thông tin xác thực cần thiết để đưa ra yêu cầu. Tệp này được truy cập khi khởi động một ứng dụng bằng phương thức load_from_file. Hãy làm theo ví dụ được cung cấp bên dưới khi tạo tệp YAML để chỉ định mã làm mới, mã ứng dụng khách và mật khẩu ứng dụng khách.

Để chỉ định vị trí đặt tệp search-ads-360.yaml, bạn có thể truyền đường dẫn dưới dạng chuỗi đến phương thức này khi gọi tệp đó:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")

Nếu bạn không cung cấp đường dẫn, thư viện sẽ tìm tệp đó trong thư mục $HOME:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()

Trường cấu hình

Cấu hình thư viện ứng dụng hỗ trợ các trường sau.

Các trường chung:

refresh_token: Mã làm mới OAuth của bạn.
client_id: Mã ứng dụng OAuth của bạn.
client_secret: Mật khẩu ứng dụng OAuth của bạn.
login_customer_id: Hãy xem tài liệu vềlogin-customer-id.

Các khoá được hỗ trợ cho luồng ứng dụng web và máy tính

Nếu bạn đang sử dụng quy trình của ứng dụng máy tính hoặc web, thì các khoá được hỗ trợ sẽ như sau:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE