Google Ads API를 호출할 때 OAuth 2.0 애플리케이션 사용자 인증 정보와 개발자 토큰이 모두 필요합니다. Google Ads 관리자 계정으로 API를 호출하는 경우 각 요청에서 login-customer-id 헤더를 지정해야 합니다. 이 페이지에서는 이러한 값을 설정하는 방법을 설명하고 REST 인터페이스를 사용할 때 주고받는 몇 가지 추가 API별 HTTP 헤더를 설명합니다.
OAuth 2.0 사용자 인증 정보
Google Ads API는 애플리케이션 사용자 인증 정보를 사용하여 API 요청을 식별하고 승인합니다. OAuth 2.0 클라이언트와 서비스 계정을 모두 구성할 수 있습니다. 클라이언트 측 승인 구성에 관한 자세한 내용은 Google Ads API의 OAuth2를 참고하세요.
Google API를 처음 사용하는 경우 앱 코드를 작성하기 전에 oauth2l 또는 OAuth 2.0 Playground를 사용하여 애플리케이션 사용자 인증 정보와 Google Ads API를 실험해 볼 수 있습니다.
데스크톱 또는 웹 앱 흐름 사용
Google Ads API용 Google API 콘솔 프로젝트 구성 단계를 따릅니다. 클라이언트 ID와 클라이언트 보안 비밀번호를 기록한 다음 이 페이지로 돌아옵니다.
OAuth 클라이언트를 만든 후에는 데스크톱 앱 흐름 안내 또는 웹 앱 흐름 안내에 따라 갱신 토큰 및 액세스 토큰을 생성합니다.
서비스 계정 사용
서비스 계정 가이드에 나온 일반적인 안내에 따라 Google Ads API에 대한 서비스 계정 액세스를 설정하세요.
Google Ads 계정에 액세스할 수 있도록 서비스 계정을 설정한 후에는 서버 간 애플리케이션에서 OAuth 2.0 사용 가이드에 따라 HTTP/REST 탭을 선택합니다. Google Ads API 액세스에 사용할 scope는
https://www.googleapis.com/auth/adwords입니다.
새 액세스 토큰 생성
클라이언트 ID, 클라이언트 보안 비밀번호, 갱신 토큰이 있으면 curl 명령줄 도구를 사용하여 API 호출에 사용할 새 액세스 토큰을 생성할 수 있습니다.
curl \
--data "grant_type=refresh_token" \
--data "client_id=CLIENT_ID" \
--data "client_secret=CLIENT_SECRET" \
--data "refresh_token=REFRESH_TOKEN" \
https://www.googleapis.com/oauth2/v3/token
그런 다음 Google Ads API에 대한 모든 API 호출의 Authorization HTTP 헤더에서 curl 요청에서 반환된 액세스 토큰을 사용합니다.
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
요청 헤더
개발자 토큰
Google Ads API에서 API를 호출하려면 개발자 토큰도 필요합니다. Google Ads UI에서 직접 관리자 계정의 토큰을 신청할 수 있습니다. 개발자 토큰 설정을 자세히 알아보려면 개발자 토큰 받기를 참고하세요.
Google Ads API에 대한 모든 API 호출의 developer-token HTTP 헤더에 개발자 토큰 값을 포함해야 합니다.
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
로그인 고객 ID
관리자가 클라이언트 계정에 대해 Google Ads API를 호출하는 경우 (즉, 관리자로 로그인하여 클라이언트 계정 중 하나에 API 호출을 하는 경우) login-customer-id HTTP 헤더도 제공해야 합니다. 이 값은 API를 호출하는 관리자의 Google Ads 고객 ID를 나타냅니다.
이 헤더를 포함하는 것은 로그인하거나 페이지 오른쪽 상단의 프로필 이미지를 클릭한 후 Google Ads UI에서 계정을 선택하는 것과 같습니다. 고객 ID를 지정할 때는 하이픈(—)을 삭제해야 합니다(예: 123-456-7890이 아닌 1234567890).
GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
연결된 고객 ID
이 헤더는 서드 파티 앱 분석 서비스 제공업체가 연결된 Google Ads 계정에 전환을 업로드할 때만 사용합니다. 자세한 내용은 API 호출 구조 가이드를 참고하세요.
...
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
linked-customer-id: LINKED_CUSTOMER_ID
응답 헤더
다음 헤더는 API의 HTTP 응답으로 반환됩니다.
요청 ID
request-id는 API 요청을 고유하게 식별하는 문자열입니다. 특정 API 호출 관련 문제를 디버깅하거나 해결할 때 request-id는 Google 개발자 지원팀에 문의할 때 유용하게 사용할 수 있는 중요한 식별자입니다.
request-id: 2a5Cj89VV7CNhya1DZjjrC