Python

Google cung cấp một thư viện ứng dụng Python để tương tác với API Ad Manager. Bạn nên sử 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 phần phụ thuộc vào một dự án hiện có. Google phát hành cấu phần phần mềm thư viện ứng dụng cho PyPI dưới dạng 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 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 xác thực 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 đính kèm vào 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.

Tạo 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 Network đồ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="networks/[NETWORK_CODE]",
    )

    # 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.

Ghi nhật ký các yêu cầu và phản hồi HTTP

Thư viện ứng dụng Python sử dụng thư viện logging chuẩn của Python để ghi lại các yêu cầu và phản hồi HTTP. Theo mặc định, tính năng ghi nhật ký sẽ bị tắt.

Để bật tính năng ghi nhật ký, hãy đặt biến môi trường GOOGLE_SDK_PYTHON_LOGGING_SCOPE. Biến môi trường này định cấu hình việc xử lý các sự kiện ghi nhật ký ở cấp logging.DEBUG trở lên.

# Log only Ad Manager API events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google.ads.admanager_v1

# Log all Google library events
export GOOGLE_SDK_PYTHON_LOGGING_SCOPE=google

Ngoài ra, bạn có thể sử dụng mô-đun logging của Python:

import logging

from google.ads import admanager_v1

logger = logging.getLogger("google.ads.admanager_v1")
logger.addHandler(logging.StreamHandler())
logger.setLevel(logging.DEBUG)

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 riêng từng 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 nhóm hỗ trợ để được trợ giúp 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 theo chế độ cài đặt biến môi trường http_proxy và https_proxy.