Search Ads 360 Reporting API 호출은 일반적으로 클라이언트 라이브러리를 통해 이루어집니다. 자세한 내용은 클라이언트 라이브러리 설명을 참조하세요. 하지만 기본 요청 세부정보의 구조에 관한 정보는 테스트 및 디버깅 시 유용할 수 있습니다.
Search Ads 360 Reporting API는 REST 바인딩이 포함된 gRPC API입니다. 즉, 다음 두 가지 다른 방법으로 API를 호출할 수 있습니다.
- 선호하는 방법
- 클라이언트 라이브러리 사용:
- 대체 방법(선택사항)
- REST 사용:
- 요청 본문을 JSON 객체로 만듭니다.
- HTTP 1.1을 사용하여 서버에 요청을 전송합니다.
- 응답을 JSON 객체로 역직렬화합니다.
- 결과를 해석합니다.
자세한 내용은 Google Cloud API를 참조하세요.
다음 섹션은 gRPC 및 REST 프로토콜에 모두 적용됩니다.
리소스 이름
API의 객체 대부분은 리소스 이름 문자열로 식별됩니다. 이러한 문자열은 REST 인터페이스를 사용할 때 URL 역할도 합니다.
지원되는 리소스 및 경로 표현에 대한 자세한 내용은 참조 > REST를 참조하세요. 다른 서비스에도 동일한 형식이 사용됩니다.
복합 ID
객체의 ID가 전역적으로 고유하지 않으면 상위 ID와 물결표 (~)를 앞에 붙여 해당 객체의 복합 ID를 구성합니다.
예를 들어 광고그룹 광고 ID는 전역적으로 고유하지 않으므로 상위 객체(광고그룹) ID가 앞에 추가되어 고유한 복합 ID가 생성됩니다.
예: 123의 AdGroupId + ~ + 45678의 AdGroupAdId = 123~45678의 복합 광고그룹 광고 ID
요청 헤더
다음 섹션의 HTTP 헤더 (또는 gRPC 메타데이터)가 요청 본문에 포함되어야 합니다.
승인
양식에 OAuth2 액세스 토큰을 포함해야 합니다.
Authorization: Bearer [OAUTH_2.0_ACCESS_TOKEN]
토큰은 클라이언트를 대신하는 관리자 계정 또는 자체 하위 관리자 또는 클라이언트 계정을 직접 관리하는 광고주를 식별해야 합니다. 자세한 내용은 Search Ads 360 관리자 계정에 대한 정보 및 인증을 참고하세요.
로그인 고객 ID 헤더
login-customer-id 헤더는 관리자 계정을 사용하여 하위 관리자 계정 또는
고객 계정에 액세스할 때 필요합니다. 하위 관리자 계정 또는 클라이언트 계정에 직접 액세스할 때는
필요하지 않습니다. 반드시 필요하지는 않지만 둘 이상의 계정에 액세스할 수 있는 인증된 사용자에게 항상 login-customer-id를 지정하는 것이 좋습니다. 이렇게 하면 모호함을 피할 수 있고 의도치 않게 컨텍스트를 잘못된 계정으로 설정하는 것을 방지할 수 있습니다.
요청에는 하이픈 (-) 없이 승인된 사용자의 고객 ID를 포함해야 합니다. 예를 들면 다음과 같습니다.
https://searchads360.googleapis.com/VERSION_NUMBER/customers/CUSTOMER_ID/campaignBudgets
login-customer-id를 설정하는 것은 로그인하거나 오른쪽 상단의 프로필 이미지를 클릭한 후 Search Ads 360 UI에서 계정을 선택하는 것과 같습니다.
응답 헤더
다음 헤더 (또는 gRPC 후행 메타데이터)가 응답 본문과 함께 반환됩니다. 디버깅 목적으로 이러한 값을 로깅하는 것이 좋습니다.
요청 ID
request-id 헤더는 요청을 고유하게 식별하는 문자열입니다.