집계된 제품 통계 및 문제를 가져오는 방식이 변경되었습니다. 이전에 Shopping용 Content API의 accountstatuses 리소스에서 사용할 수 있었던 기능이 이제 Merchant API의 전용 리소스로 분할되었습니다. 이 가이드에서는 새 aggregateProductStatuses 리소스를 사용하도록 통합을 이전하는 방법을 설명합니다.
참고: Merchant API에서는 계정 수준 문제와 집계 제품 상태가 분리됩니다. accountstatuses에서 계정 문제로 이전하는 가이드도 검토하세요.
주요 차이점
Content API for Shopping과 Merchant API의 제품 상태 기능 간 주요 차이점은 다음과 같습니다.
- 전용 리소스: 이제 쇼핑용 Content API의
accountstatuses리소스가 분할됩니다. Merchant API에서 계정 수준 문제는accountissues리소스를 통해 확인할 수 있으며, 집계된 제품 통계와 상품 수준 문제는 새로운aggregateProductStatuses리소스를 통해 확인할 수 있습니다. - 새 리소스 구조:
AggregateProductStatus는 보고 컨텍스트와 국가의 특정 조합에 대한 통계와 문제를 나타내는 새 리소스입니다. - 필터링 메커니즘:
destinations와 같은 쿼리 매개변수를 사용하여 데이터를 선택하는 대신 Merchant API는filter문자열이 있는list메서드를 사용하여 특정 보고 컨텍스트와 국가를 쿼리합니다. - 채널 필드 삭제:
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로 변경되었습니다. |