승인 및 HTTP 헤더

동영상: 인증

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 액세스에 사용할 scopehttps://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 /v16/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

요청 헤더

개발자 토큰

또한 Google Ads API를 호출하려면 개발자 토큰이 필요합니다. Google Ads UI에서 직접 관리자 계정의 토큰을 신청할 수 있습니다. 개발자 토큰을 설정하는 방법에 대한 자세한 내용은 개발자 토큰 받기를 참고하세요.

Google Ads API에 대한 모든 API 호출의 developer-token HTTP 헤더에 개발자 토큰 값을 포함해야 합니다.

GET /v16/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 /v16/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