승인 및 HTTP 헤더

동영상: 인증

OAuth 2.0 애플리케이션 사용자 인증 정보와 개발자가 모두 필요합니다. 토큰을 사용합니다. API를 호출하는 경우 Google Ads 관리자 계정을 사용하는 경우 login-customer-id도 지정해야 합니다. 헤더의 캡션을 생성합니다 이 페이지에서는 이러한 값을 설정하고 전송되는 여러 API별 HTTP 헤더를 문서화하고 REST 인터페이스 사용 시 수신됩니다.

OAuth 2.0 사용자 인증 정보

Google Ads API는 애플리케이션 사용자 인증 정보를 사용하여 API를 식별하고 승인합니다. 있습니다 OAuth 2.0 클라이언트 및 서비스 계정을 구성할 수 있습니다. 자세한 내용은 자세한 내용은 Google Ads API를 참고하세요.

Google API를 처음 사용하는 경우 oauth2l 또는 OAuth 2.0 실험할 수 있는 플레이그라운드 Google Ads API와 애플리케이션 사용자 인증 정보를 모두 확인한 다음 있습니다.

데스크톱 또는 웹 앱 흐름 사용

다음 단계를 위해 Google API 콘솔 프로젝트를 구성합니다. Google Ads API를 참고하세요. 클라이언트 ID를 기록합니다. 클라이언트 보안 비밀번호를 설정한 다음 이 페이지로 돌아옵니다.

OAuth 클라이언트를 만든 후 데스크톱 앱 흐름을 따릅니다. 안내 또는 웹 앱 흐름 안내를 사용하여 갱신 토큰액세스 토큰을 생성해야 합니다.

서비스 계정 사용

서비스 계정 Google Ads API에 대한 서비스 계정 액세스 설정 가이드입니다.

Google Ads 계정에 액세스할 수 있도록 서비스 계정을 설정한 후에는 서버 간 OAuth 2.0 사용하기 애플리케이션 HTTP/REST 탭을 선택하세요. Google Ads API에 사용할 scope 액세스 가능 상태는 https://www.googleapis.com/auth/adwords입니다.

새 액세스 토큰 생성

클라이언트 ID, 클라이언트 비밀번호, 갱신 토큰이 있으면 다음 작업을 할 수 있습니다. API 호출에 사용할 새 액세스 토큰을 curl 명령줄 도구:

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 헤더:

GET /v17/customers:listAccessibleCustomers HTTP/1.1
Host: googleads.googleapis.com
Authorization: Bearer ACCESS_TOKEN
developer-token: DEVELOPER_TOKEN

요청 헤더

개발자 토큰

Google Ads API에서는 다음을 호출하려면 개발자 토큰이 필요합니다. 생성합니다. 관리자 계정의 토큰을 신청하려면 Google Ads UI 개발자 토큰 설정에 대해 자세히 알아보려면 다음을 참조하세요. 개발자 토큰 받기

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

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 요청을 고유하게 식별하는 문자열입니다. 날짜 request-id는 특정 API 호출 관련 문제를 디버깅하거나 Google 개발자에게 문의할 때 유용하게 사용할 수 있는 중요한 식별자입니다. 도움이 될 수 있습니다

request-id: 2a5Cj89VV7CNhya1DZjjrC