Python 클라이언트 라이브러리 구성

Python 클라이언트 라이브러리 설치

로컬 환경에 Python 클라이언트 라이브러리를 설치하려면 다음 안내를 따르세요.

  1. Python 클라이언트 라이브러리 tarball을 추출합니다.

  2. 동일한 디렉터리에서 다음 명령어를 실행합니다.

    python -m pip install .

  3. 터미널에 표시되는 메시지에 따라 설치를 완료합니다.

YAML 파일을 사용한 구성

요청을 실행하는 데 필요한 인증 정보가 포함된 클라이언트를 초기화할 때 사용할 YAML 파일을 지정할 수 있습니다. 클라이언트가 load_from_file 메서드를 사용하여 초기화될 때 이 파일에 액세스합니다. YAML 파일을 만들 때 아래에 제공된 예시를 따라 갱신 토큰, 클라이언트 ID, 클라이언트 보안 비밀번호를 지정합니다.

search-ads-360.yaml 파일이 있는 위치를 지정하려면 메서드를 호출할 때 경로를 메서드에 문자열로 전달하면 됩니다.

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")

경로를 제공하지 않으면 라이브러리는 $HOME 디렉터리에서 파일을 찾습니다.

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()

구성 필드

클라이언트 라이브러리 구성은 다음 필드를 지원합니다.

일반 필드:

  • refresh_token: OAuth 갱신 토큰입니다.
  • client_id: OAuth 클라이언트 ID입니다.
  • client_secret: OAuth 클라이언트 보안 비밀번호입니다.
  • login_customer_id: login-customer-id 문서를 참조하세요.

데스크톱 및 웹 애플리케이션 흐름에서 지원되는 키

데스크톱 또는 웹 애플리케이션 흐름을 사용하는 경우 지원되는 키는 다음과 같습니다.

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE