집계된 제품 통계 및 문제를 가져오는 방식이 변경되었습니다. 이전에 Content API for Shopping의 accountstatuses 리소스에서 제공되던 기능이 이제 Merchant API의 전용 리소스로 분할되었습니다. 이 가이드에서는 통합을 이전하여 새
aggregateProductStatuses
리소스를 사용하는 방법을 설명합니다.
참고: Merchant API에서는 계정 수준 문제와 집계된 제품 상태가
분할됩니다. accountstatuses에서
계정 문제로 이전하는 방법에 관한 가이드도 검토하세요.
주요 차이점
Content API for Shopping과 Merchant API의 제품 상태 기능 간 주요 차이점은 다음과 같습니다.
- 전용 리소스: Content API
for Shopping의
accountstatuses리소스가 이제 분할됩니다. Merchant API에서는 계정 수준 문제를accountissues리소스를 통해 확인할 수 있으며, 집계된 제품 통계와 상품 수준 문제는 새로운aggregateProductStatuses리소스를 통해 확인할 수 있습니다. - 새로운 리소스 구조:
AggregateProductStatus는 보고 컨텍스트와 국가의 특정 조합에 관한 통계 및 문제를 나타내는 새로운 리소스입니다. - 필터링 메커니즘: Merchant API는 데이터를 선택하기 위해
destinations와 같은 쿼리 매개변수를 사용하는 대신list문자열이 포함된filter메서드를 사용하여 특정 보고 컨텍스트와 국가를 쿼리합니다. - 채널 필드 삭제:
channel필드는 더 이상 사용되지 않습니다. 이 정보는 이제reportingContext에 암시적으로 포함됩니다.
요청
Merchant API는 filter 매개변수가 포함된 GET 요청을 사용하여 집계된 제품 상태를 가져옵니다.
GET
https://merchantapi.googleapis.com/issueresolution/v1/{parent=accounts/*}/aggregateProductStatuses
요청 URL 형식
| 요청 설명 | Content API for Shopping | Merchant API |
|---|---|---|
| 제품 통계 및 문제 가져오기 | GET /content/v2.1/{merchantId}/accountstatuses/{accountId} |
GET /issueresolution/v1/accounts/{accountId}/aggregateProductStatuses |
식별자
새로운 구조를 지원하도록 리소스 식별 방식이 변경되었습니다.
식별자 형식
| 식별자 설명 | Content API for Shopping | Merchant API |
|---|---|---|
| 리소스 식별자 | 리소스는 accountId로 식별되었습니다. 쿼리 매개변수를 사용하여 특정 데이터 슬라이스가 선택되었습니다. |
리소스 이름은 특정 보고 컨텍스트 및 국가의 데이터를 고유하게 식별합니다. accounts/{account}/aggregateProductStatuses/{reportingContext}~{country} |
메서드
제품 상태를 가져오는 메서드가 필터링을 지원하는 list 메서드로 업데이트되었습니다.
| Content API for Shopping 메서드 | Merchant API 메서드 | 사용 가능 여부 및 참고사항 |
|---|---|---|
accountstatuses.get |
aggregateProductStatuses.list |
accountstatuses.get 메서드는 모든 제품 통계가 포함된 단일 리소스를 반환했습니다. 새로운 aggregateProductStatuses.list 메서드는 보고 컨텍스트 및 국가 조합마다 하나씩 리소스 목록을 반환합니다. filter 매개변수를 사용하여 특정 데이터를 가져옵니다. 계정 수준 문제의 경우 accountissues.list를 사용합니다. |
세부 필드 변경사항
제품 통계 및 문제의 필드가 새로운 AggregateProductStatus 리소스에서 업데이트되고 재구성되었습니다.
| Content API for Shopping | Merchant API | 설명 |
|---|---|---|
products |
aggregate_product_statuses |
products 배열이 목록 응답의 aggregate_product_statuses 반복 필드로 대체됩니다. |
destination |
reporting_context |
destination 필드가 통계의 프로그램 컨텍스트를 지정하는 reporting_context로 대체됩니다. |
channel |
(상응하는 필드가 없음) | channel 필드가 삭제됩니다. 이 정보는 이제 reporting_context에 포함됩니다. |
statistics |
stats |
statistics 객체의 이름이 stats로 변경됩니다. 내의 필드 이름이 snake_case로 변환됩니다. 예를 들어 activeCount는 이제 active_count입니다. |
itemLevelIssues.servability |
item_level_issues.severity |
servability enum이 문제의 영향을 설명하는 severity enum으로 대체됩니다. |
itemLevelIssues.attributeName |
item_level_issues.attribute |
attributeName 필드의 이름이 attribute로 변경됩니다. |
itemLevelIssues.documentation |
item_level_issues.documentation_uri |
documentation 필드의 이름이 documentation_uri로 변경됩니다. |
itemLevelIssues.numItems |
item_level_issues.product_count |
numItems 필드의 이름이 product_count로 변경됩니다. |