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 사용자 인증 정보를 만들고 구성하는 방법은 다음을 참조하세요. 인증.

첫 번째 요청하기

각 서비스에는 각 REST 메서드의 동기식 메서드와 비동기식 메서드가 모두 있는 ServiceClient 객체가 있습니다. 다음 예는 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="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

다른 메서드 및 리소스의 예는 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도 포함됩니다. 다음 예는 GoogleAPIError의 requestId

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_proxy 및 https_proxy를 따릅니다.