Python

Google cung cấp thư viện ứng dụng Python để tương tác với API Ad Manager. Bạn nên dùng thư viện ứng dụng với PyPI.

Để bắt đầu, hãy tạo một dự án mới trong IDE mà bạn chọn hoặc thêm vào một dự án hiện có. Google xuất bản cấu phần phần mềm của thư viện ứng dụng để PyPI dưới tên google-ads-admanager.

pip install google-ads-admanager

Định cấu hình thông tin xác thực

Thư viện ứng dụng Python sử dụng OAuth2 và Thông tin xác thực mặc định của ứng dụng (ADC) để xác thực.

ADC tìm kiếm thông tin xác thực theo thứ tự ở các vị trí sau:

1. Biến môi trường GOOGLE_APPLICATION_CREDENTIALS.
2. Thông tin đăng nhập của người dùng được thiết lập thông qua Google Cloud CLI (gcloud CLI).
3. Khi chạy trên Google Cloud, tài khoản dịch vụ được liên kết với tài nguyên Google Cloud.

Để tạo và định cấu hình thông tin xác thực ADC, hãy xem phần Xác thực.

Đưa ra yêu cầu đầu tiên

Mỗi dịch vụ có một đối tượng ServiceClient với cả phương thức đồng bộ và không đồng bộ cho mỗi phương thức REST. Ví dụ sau đây đọc một Network một cách đồng bộ.

from google.ads import admanager_v1


def sample_get_network():
    # Create a client
    client = admanager_v1.NetworkServiceClient()

    # Initialize request argument(s)
    request = admanager_v1.GetNetworkRequest(
        name="name_value",
    )

    # Make the request
    response = client.get_network(request=request)

    # Handle the response
    print(response)
admanager_v1_generated_network_service_get_network_sync.py

Để biết ví dụ về các phương thức và tài nguyên khác, hãy xem kho lưu trữ GitHub googleapis/google-cloud-python.

Xử lý lỗi

Tất cả lỗi API đều mở rộng lớp cơ sở GoogleAPIError.

Trường lý do lỗi xác định duy nhất các loại lỗi. Sử dụng trường này để xác định cách xử lý lỗi.

try:
  network = client.get_network(request=request)
  print(network)
except GoogleAPIError as e:
  # Handle error
  print(e.reason)

Lỗi API Ad Manager cũng bao gồm một requestId duy nhất mà bạn có thể cung cấp cho support để yêu cầu trợ giúp về khắc phục sự cố. Ví dụ sau đây trích xuất requestId từ GoogleAPIError;

except GoogleAPIError as e:
  requestInfoType = "type.googleapis.com/google.rpc.RequestInfo"
  requestInfo = [detail for detail in e.details if detail['@type'] == requestInfoType][0]
  print(requestInfo['requestId'])

Định cấu hình cài đặt proxy

Thư viện ứng dụng Python tuân thủ các chế độ cài đặt biến môi trường http_proxy và https_proxy.