제품 및 계정 상태에 영향을 미칠 수 있는 계정 수준 문제를 가져오는 방식이 변경되었습니다. Content API for Shopping의 accountstatuses 리소스와 비교할 때 Merchant API는 더 구조화되고 자세한 정보를 제공하는 전용 AccountIssue 리소스를 도입합니다.
새 기능을 사용하는 방법에 대한 자세한 내용은 계정 문제 보기 가이드를 참고하세요.
주요 차이점
다음은 Merchant API AccountIssue 리소스의 주요 개선사항과 차이점입니다.
- 전용 리소스: 계정 문제는 자체 리소스입니다. 쇼핑용 Content API에서 계정 수준 문제는 일반
AccountStatus리소스 내에 중첩된 필드였습니다. 판매자 API를 사용하면accounts.issues.list메서드를 사용하여 직접 나열할 수 있습니다. - 구조화된 영향 데이터:
AccountIssue리소스는 자세한impactedDestinations필드를 제공합니다. 이 필드에는 대상 유형 (예: 쇼핑 광고), 특정 지역, 해당 지역의 문제 심각도 등 문제의 영향이 명확하게 표시됩니다. - 열거형으로 된 심각도: 이제
severity필드가 열거형 (CRITICAL,ERROR,SUGGESTION등의 값 포함)이 되어 쇼핑 콘텐츠 API의 문자열 기반 값에 비해 프로그래매틱 방식으로 처리하기가 더 쉬워졌습니다. - 표준화된 식별자: 각 계정 문제에는
accounts/{ACCOUNT_ID}/issues/{ISSUE_ID}형식의 고유한 전체 리소스name이 있습니다. 이 표준화된 접근 방식은 Content API for Shopping의id문자열을 대체합니다. - 현지화 지원:
accounts.issues.list메서드를 사용하면 원하는 언어로 문제 세부정보(예: 제목 및 설명)를 수신할language_code를 지정할 수 있습니다. 쇼핑용 Content API에서는 불가능했습니다. - 고급 계정 동작: 고급 계정에서
accounts.issues.list를 호출하면 해당 고급 계정에 직접 적용되는 문제만 반환됩니다. 하위 계정의 문제는 반환하지 않습니다. Content API for Shopping에서accountstatuses.list메서드는 모든 하위 계정의 상태를 반환합니다. Merchant API의 모든 하위 계정에 대한 문제를 가져오려면accounts.listSubaccounts를 호출한 다음 각 하위 계정에 대해 개별적으로accounts.issues.list를 호출해야 합니다.
요청
Merchant API에서는 특정 판매자 센터 계정의 계정 문제를 나열할 수 있습니다.
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/ACCOUNT_ID/issues
요청 URL 비교
| 요청 설명 | Content API for Shopping | Merchant API |
|---|---|---|
| 단일 계정의 계정 수준 문제 나열 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses/{ACCOUNT_ID} |
GET https://merchantapi.googleapis.com/accounts/v1beta/accounts/{ACCOUNT_ID}/issues |
| 고급 계정의 모든 하위 계정에 대한 계정 수준 문제 나열 | GET https://shoppingcontent.googleapis.com/content/v2.1/{MERCHANT_ID}/accountstatuses |
사용할 수 없음. 하위 계정을 반복해야 합니다. |
식별자
판매자 API에서 계정 및 문제의 식별자가 변경되었습니다.
식별자 비교
| 식별자 설명 | Content API for Shopping | Merchant API |
|---|---|---|
| 계정 식별자 | {MERCHANT_ID} 및 {ACCOUNT_ID}을 경로 매개변수로 사용합니다. |
{ACCOUNT_ID}을 accounts/{ACCOUNT_ID} 형식의 경로 매개변수로 사용합니다. |
| 문제 식별자 | 응답 본문의 id 필드 (예: "products-that-enable-dishonest-behavior-hacking-policy") |
name 필드 (전체 리소스 이름, 예: accounts/12345/issues/example-issue-id) |
메서드
계정 문제를 가져오는 메서드가 Merchant API에서 통합되고 간소화되었습니다.
방법 비교
| Content API for Shopping | Merchant API | 사용 가능 여부 및 참고사항 |
|---|---|---|
accountstatuses.get |
accounts.issues.list |
사용 가능 단일 계정의 문제를 가져오려면 accounts.issues.list를 사용하고 계정 ID를 지정합니다. 판매자 API에는 단일 문제에 대한 get 메서드가 없습니다. |
accountstatuses.list |
이에 직접 상응하는 항목이 없습니다. | 사용할 수 없음 판매자 API의 accounts.issues.list 메서드는 지정된 계정의 문제만 반환하며 하위 계정의 문제는 반환하지 않습니다. 모든 하위 계정의 문제를 가져오려면 먼저 accounts.listSubaccounts를 호출한 다음 각 하위 계정에 대해 accounts.issues.list를 호출해야 합니다. |
accountstatuses.custombatch |
이에 직접 상응하는 항목이 없습니다. | 사용할 수 없음 판매자 API에서는 계정 문제의 일괄 처리가 지원되지 않습니다. 각 계정에 대해 개별적으로 list 호출을 해야 합니다. |
세부 필드 변경사항
구조와 명확성을 높이기 위해 계정 문제 리소스 내 필드가 업데이트되었습니다.
필드 비교
| Content API for Shopping | Merchant API | 설명 |
|---|---|---|
accountLevelIssues (AccountStatus의 배열) |
accountIssues (ListAccountIssuesResponse의 배열) |
이제 문제는 중첩된 필드가 아닌 전용 최상위 리소스입니다. |
id(문자열) |
name(문자열) |
이제 문제 식별자는 전체 리소스 이름(예: accounts/{ACCOUNT_ID}/issues/{ISSUE_ID})입니다. |
title(문자열) |
title(문자열) |
변경사항 없음. |
detail(문자열) |
detail(문자열) |
변경사항 없음. |
documentation(문자열) |
documentationUri(문자열) |
URL임을 나타내기 위해 명확성을 위해 필드 이름이 변경되었습니다. |
severity(문자열) |
severity(열거형) |
이제 심각도가 문자열이 아닌 구조화된 열거형 (CRITICAL, ERROR, SUGGESTION)입니다. |
country (문자열), destination (문자열) |
impactedDestinations (반복 메시지) |
이제 영향을 받는 각 영역의 대상, 지역, 심각도가 그룹화된 목록으로 영향이 표시됩니다. country 필드는 Impact 메시지 내에서 regionCode로 대체됩니다. |
| (해당 사항 없음) | language_code, time_zone (요청 매개변수) |
list 요청의 새로운 매개변수를 사용하면 title, detail와 같은 사람이 읽을 수 있는 필드를 현지화할 수 있습니다. |