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 플레이그라운드를 사용하여 앱 코드를 작성하기 전에 애플리케이션 사용자 인증 정보와 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를 지정할 때는 하이픈(—)을 삭제해야 합니다(예: 1234567890, 123-456-7890 아님).
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