Search Ads 360 Reporting API를 호출할 때는 OAuth 2.0 애플리케이션 사용자 인증 정보가 필요합니다. Search Ads 360 관리자 계정으로 API를 호출하는 경우 각 요청에 login-customer-id 헤더도 지정해야 합니다. 이 페이지에서는 이러한 값을 설정하고 REST 인터페이스를 사용할 때 주고받는 몇 가지 추가 API별 HTTP 헤더를 설정하는 방법을 설명합니다.
OAuth 2.0 사용자 인증 정보
Search Ads 360 Reporting API는 애플리케이션 사용자 인증 정보를 사용하여 API 요청을 식별하고 승인합니다. OAuth 2.0 클라이언트를 구성할 수 있습니다. 모든 Search Ads 360 Reporting API 호출은 OAuth2를 통해 승인되어야 합니다. OAuth2를 사용하면 Search Ads 360 Reporting API 클라이언트 앱에서 사용자의 로그인 정보를 처리하거나 저장하지 않고도 사용자의 Search Ads 360 계정에 액세스할 수 있습니다.
Google API를 처음 사용하는 경우 앱 코드를 작성하기 전에 oauth2l 또는 OAuth 2.0 Playground를 사용하여 애플리케이션 사용자 인증 정보 및 Search Ads 360 Reporting API를 실험할 수 있습니다. 제공된 사용자 인증 정보 생성 스크립트를 실행하여 OAuth 갱신 토큰을 생성할 수도 있습니다.
새 액세스 토큰 생성
클라이언트 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
그런 다음 Search Ads 360 Reporting API에 대한 모든 API 호출의 Authorization HTTP 헤더에 있는 curl 요청에서 반환된 액세스 토큰을 사용합니다.
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
요청 헤더
고객 ID 로그인
관리자가 클라이언트 계정에 수행한 Search Ads 360 Reporting API 호출의 경우 (즉, 관리자로 로그인하여 클라이언트 계정 중 하나에 API 호출을 실행하는 경우)에도 login-customer-id HTTP 헤더를 제공해야 합니다. 이 값은 API를 호출하는 관리자의 Search Ads 360 고객 ID를 나타냅니다.
이 헤더를 포함하는 것은 로그인하거나 페이지 오른쪽 상단의 프로필 이미지를 클릭한 후 Search Ads 360 UI에서 계정을 선택하는 것과 같습니다. 고객 ID를 지정할 때 하이픈(—)을 삭제해야 합니다(예: 123-456-7890이 아닌 1234567890).
GET /v0/customers:listAccessibleCustomers HTTP/1.1
Host: searchads360.googleapis.com
Authorization: Bearer ACCESS_TOKEN
login-customer-id: MANAGER_CUSTOMER_ID
응답 헤더
다음 헤더는 API의 HTTP 응답으로 반환됩니다.
요청 ID
request-id는 API 요청을 고유하게 식별하는 문자열입니다. 특정 API 호출과 관련된 문제를 디버깅하거나 해결할 때 request-id는 Google 개발자 지원팀에 문의할 때 유용하게 사용할 수 있는 중요한 식별자입니다.
request-id: 2a5Cj89VV7CNhya1DZjjrC