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 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 xuất bản các cấu phần phần mềm thư viện ứng dụng lên PyPI dưới dạng google-ads-admanager.

requirements.txt 

google-ads-admanager==0.10.4

Dòng lệnh 

pip install google-ads-admanager

Định cấu hình thông tin đăng nhập

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 đăng nhập 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ụ sẽ được đính kèm vào tài nguyên Google Cloud.

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

Tạo yêu cầu đầu tiên

Mỗi dịch vụ đều có một đối tượng ServiceClient với cả phương thức đồng bộ và không đồng bộ cho từng phương thức REST. Ví dụ sau đây đọc 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="networks/[NETWORK_CODE]",
    )

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

    # Handle the response
    print(response)

Để 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 Python tiêu chuẩn để ghi nhật ký 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ả các lỗi API đều mở rộng lớp cơ sở GoogleAPIError.

Trường lý do gây ra lỗi xác định riêng biệ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 Ad Manager API 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 các chế độ cài đặt biến môi trường http_proxy và https_proxy.