Product 리소스를 사용하여
쇼핑 제품
Content API를 사용하면
ProductStatuses.get 메서드를 사용하여 지도 가장자리에
패딩을 추가할 수 있습니다. Merchant API를 사용하면 제품을 검색할 수 있습니다.
Accounts.Products 리소스를 검색하여 상태를 확인할 수 있습니다.
판매자는 쇼핑 광고 및 무료 등록정보 정책을 준수해야 합니다. 쇼핑 광고 Google이 이러한 정책을 시행하고 Google이 판단하기에 적절한 조치를 취할 때 이러한 정책을 위반하는 콘텐츠나 행위를 발견
요구사항
제품 상태를 보려면 다음을 수행해야 합니다.
- 연결 대상에 계정을 등록합니다.
- 다음 중 하나에 유효한 국가 코드를 입력하세요.
<ph type="x-smartling-placeholder">
- </ph>
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: 문제에 관한 문서의 URL입니다.applicableCountries: 문제가 영향을 미치는 국가를 나타냅니다. 있습니다.