Python

Google은 Ad Manager API와 상호작용하기 위한 Python 클라이언트 라이브러리를 제공합니다. PyPI와 함께 클라이언트 라이브러리를 사용하는 것이 좋습니다.

시작하려면 원하는 IDE에서 새 프로젝트를 만들거나 기존 프로젝트에 종속되지 않습니다. Google은 클라이언트 라이브러리 아티팩트를 PyPI에 google-ads-admanager로 게시합니다.

pip install google-ads-admanager

사용자 인증 정보 구성

Python 클라이언트 라이브러리는 OAuth2 및 애플리케이션 기본 사용자 인증 정보를 사용합니다. (ADC)를 통해 인증합니다.

ADC는 다음 위치에서 순서대로 사용자 인증 정보를 검색합니다.

  1. GOOGLE_APPLICATION_CREDENTIALS 환경 변수입니다.
  2. Google Cloud CLI(gcloud CLI)를 통해 설정된 사용자 인증 정보
  3. Google Cloud에서 실행할 때 Google Cloud 리소스에 연결된 서비스 계정입니다.

ADC 사용자 인증 정보를 만들고 구성하는 방법은 다음을 참조하세요. 인증.

첫 번째 요청하기

각 서비스에는 동기식 및 비동기식을 모두 사용하는 ServiceClient 객체가 있습니다. 각 REST 메서드마다 메서드를 정의합니다 다음 예는 Network를 읽습니다. 있습니다.

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)

다른 메서드 및 리소스의 예는 GitHub 저장소를 참조하세요. googleapis/google-cloud-python

오류 처리

모든 API 오류는 기본 클래스 GoogleAPIError를 확장합니다.

오류 이유 필드는 오류 유형을 고유하게 식별합니다. 사용 이 필드를 사용하여 오류 처리 방법을 결정합니다.

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

Ad Manager API 오류에는 고유한 requestId도 포함되며 지원팀에 제공하여 문제를 해결할 수 있습니다. 다음 예는 GoogleAPIErrorrequestId

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'])

프록시 설정 구성

Python 클라이언트 라이브러리는 환경 변수 설정을 따릅니다. http_proxyhttps_proxy.