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ách cài đặt thư viện ứng dụng Python trong môi trường cục bộ:

Giải nén tệp 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 dòng lệnh để hoàn tất quá trình cài đặt.

Định 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 một ứng dụng được khởi chạy bằng phương thức load_from_file. Làm theo ví dụ được cung cấp bên dưới khi tạo tệp YAML để chỉ định mã thông báo làm mới, mã ứng dụng khách và khoá ứng dụng khách.

Để chỉ định vị trí của 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 khi gọi phương thức đó:

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()

Các 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 khách OAuth của bạn.
client_secret: Khoá bí mật ứng dụng khách 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 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