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 trailing-metadata)는 응답 본문과 함께 반환됩니다. 디버깅을 위해 이러한 값을 로깅하는 것이 좋습니다.
요청 ID
request-id 헤더는 요청을 고유하게 식별하는 문자열입니다.