Product
리소스를 사용하여 쇼핑 제품의 자세한 상태를 볼 수 있습니다.
Content API를 사용하면 ProductStatuses.get
메서드를 호출하여 제품 상태를 가져올 수 있습니다. 판매자 API를 사용하면 Accounts.Products
리소스를 검색하여 제품 상태를 가져올 수 있습니다.
개발자는 쇼핑 광고 및 무료 등록정보 정책을 준수해야 합니다. 쇼핑 광고는 이러한 정책을 시행하고 이러한 정책을 위반하는 콘텐츠나 행동을 발견하는 경우 적절하게 대응할 권리를 보유합니다.
요구사항
제품 상태를 확인하려면 다음 단계를 따르세요.
- 대상에 계정을 등록합니다.
- 다음 중 하나에 유효한 국가 코드를 입력합니다.
feedLabel
필드shipping
필드- 피드 수준
- 계정의 배송 설정입니다.
제품 상태 가져오기
Accounts.Products
리소스를 검색하여 제품 상태를 확인합니다.
다음은 GET
요청의 예입니다.
GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}
products.get
의 모든 응답에는 다음 필드가 포함됩니다.
creationDate
: 제품이 생성된 날짜입니다.lastUpdateDate
: 제품이 마지막으로 업데이트된 시간입니다.googleExpirationDate
: 제품이 만료되는 날짜입니다.destinationStatuses
: 제품의 대상 대상입니다.itemLevelIssues
: 제품과 관련된 모든 문제의 목록입니다.
요청 시점에 제품에 상품 수준 문제가 있는 경우에만 응답에 itemLevelIssues
필드가 표시됩니다.
다음은 샘플 JSON 응답입니다.
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "288000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
모든 제품 상태 나열
products.list
을(를) 사용하여 모든 제품과 제품 상태를 확인하세요.
다음 매개변수를 사용하여 쿼리를 미세 조정할 수 있습니다.
pageToken
: 결과의 후속 페이지를 가져오는 데 사용됩니다. 모든 페이지에는 시퀀스의 다음 페이지를 가져오는 데 사용할 수 있는nextPageToken
가 있습니다.maxResults
: 페이지당 최대 결과 수입니다.
다음은 선택적 쿼리 매개변수가 포함된 샘플 list
요청입니다.
GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9
다음은 샘플 JSON 응답입니다.
{
"nextPageToken": "632fd090c95712c6",
"products": [
{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/10355371287",
"attributes": {
"title": "Color Headphones",
"description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
"imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
"availability": "in stock",
"brand": "Google",
"condition": "new",
"googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
"gtin": "00050644632143",
"mpn": "90000007101",
"price": {
"amountMicros": "28800000",
"currencyCode": "USD"
}
},
"productStatus": {
"destinationStatuses": [
{
"reportingContext": "FREE_LISTINGS",
"disapprovedCountries": [
"US"
]
}
],
"itemLevelIssues": [
{
"code": "pending_phone_verification",
"severity": "NOT_IMPACTED",
"resolution": "merchant_action",
"reportingContext": "FREE_LISTINGS",
"description": "Unverified phone number",
"detail": "Go to the Business information page to verify your business phone number",
"documentation": "https://support.google.com/merchants/answer/10139041",
"applicableCountries": [
"US"
]
},
{
"code": "pending_initial_policy_review_free_listings",
"severity": "DISAPPROVED",
"resolution": "pending_processing",
"reportingContext": "FREE_LISTINGS",
"description": "Pending initial review",
"detail": "Please wait up to 3 business days for the review to be completed",
"documentation": "https://support.google.com/merchants/answer/2948694",
"applicableCountries": [
"US"
]
},
{
"code": "url_does_not_match_homepage",
"severity": "DISAPPROVED",
"resolution": "merchant_action",
"attribute": "link",
"reportingContext": "FREE_LISTINGS",
"description": "Mismatched domains [link]",
"detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
"documentation": "https://support.google.com/merchants/answer/160050",
"applicableCountries": [
"US"
]
}
],
"creationDate": "2024-05-27T16:15:31.791730Z",
"lastUpdateDate": "2024-05-27T16:15:31.791730Z",
"googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}
]
}
productstatuses.list
호출은 데이터를 변경하지 않으므로 프로덕션 환경에서 테스트하는 것이 안전합니다.
상품 수준 문제
각 상품 수준 문제에는 다음 필드가 포함됩니다.
code
: 문제의 오류 코드입니다.severity
: 문제의 심각도입니다.resolution
: 판매자가 문제를 해결할 수 있는지 알려줍니다.attribute
: 영향을 받는 속성 이름입니다.reportingContext
: 문제가 적용되는 보고 컨텍스트입니다.description
: 문제 설명입니다.detail
: 문제에 관한 추가 정보를 제공합니다.documentation
: 문제에 대한 문서의 URLapplicableCountries
: 문제가 제품에 영향을 미치는 국가를 나타냅니다.