제품 상태

productstatuses 리소스를 사용하여 쇼핑 제품의 세부 상태를 확인할 수 있습니다.

일반적인 문제에 관한 자세한 내용은 제품 문제를 참고하세요.

판매자는 쇼핑 광고 및 무료 등록정보 정책을 준수해야 합니다. Google 쇼핑은 이러한 정책을 시행하고 정책을 위반하는 콘텐츠나 행동을 발견할 경우 적절하게 대응할 권리를 보유합니다.

요구사항

제품 상태를 확인하려면 다음 단계를 따라야 합니다.

  • 대상에 계정을 등록합니다.
  • 다음 중 하나에 유효한 국가 코드를 제공합니다.
    • feedLabel 필드
    • shipping 필드
    • 피드 수준
    • 계정의 배송 설정입니다.

제품 상태 가져오기

productstatuses.get을 사용하여 제품의 상태를 확인합니다.

get 및 list 요청에서 destinations 매개변수를 사용하여 특정 대상의 문제를 확인할 수 있습니다. 대상을 지정하지 않으면 자격 요건을 충족하는 모든 대상의 문제가 반환됩니다.

다음은 선택적 쿼리 매개변수가 포함된 샘플 get 요청입니다.

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

productstatuses.get의 모든 응답에는 다음 필드가 포함됩니다.

  • kind: 값은 항상 content#productStatus입니다.
  • creationDate: 제품이 생성된 날짜입니다.
  • lastUpdateDate: 제품이 마지막으로 업데이트된 시간입니다.
  • googleExpirationDate: 제품이 만료되는 날짜입니다.
  • productId: 제품의 REST ID입니다.
  • title: 제품의 제목입니다.
  • link: 제품의 URL 링크입니다.
  • destinationStatuses: 각 대상 및 국가의 제품 상태입니다.

요청 시점에 제품에 상품 수준 문제가 있는 경우에만 응답에 itemLevelIssues 필드가 표시됩니다.

샘플 JSON 응답은 다음과 같습니다.

{
"kind": "content#productStatus",
"productId": "online:en:US:63",
"title": "Third Product",
"link": "http://examplemenc.com/",
"destinationStatuses": [
 {
   "destination": "Shopping",
   "status": "disapproved",
   "disapprovedCountries": [
            "US", "UK"
   ]
 },
 {
   "destination": "ShoppingActions",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 },
 {
   "destination": "SurfacesAcrossGoogle",
   "status": "disapproved",
   "disapprovedCountries": [
            "US"
   ]
 }
],
"itemLevelIssues": [
 {
  "code": "strong_id_inaccurate",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "mpn",
  "destination": "Shopping",
  "description": "Incorrect product identifier [mpn]",
  "detail": "Use the manufacturer's product identifiers (GTIN, brand, MPN)",
  "documentation": "https://support.google.com/merchants/answer/160161",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "image_link_internal_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "image link",
  "destination": "Shopping",
  "description": "Processing failed [image link]",
  "detail": "Wait for the product image to be crawled again (up to 3 days)",
  "documentation": "https://support.google.com/merchants/answer/6240184",
  "applicableCountries": [
            "US, UK"
  ]
 },
 {
  "code": "landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "description": "Unavailable desktop landing page",
  "detail": "Update your website or landing page URL to enable access from desktop devices",
  "documentation": "https://support.google.com/merchants/answer/6098155",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "missing_condition_microdata",
  "servability": "unaffected",
  "resolution": "merchant_action",
  "destination": "Shopping",
  "description": "Missing or invalid data [condition]",
  "detail": "Add valid structured data markup to your landing page",
  "documentation": "https://support.google.com/merchants/answer/6183460",
  "applicableCountries": [
            "US", "UK"
  ]
 },
 {
  "code": "mobile_landing_page_error",
  "servability": "disapproved",
  "resolution": "merchant_action",
  "attributeName": "link",
  "destination": "Shopping",
  "description": "Unavailable mobile landing page",
  "detail": "Update your website or landing page URL to enable access from mobile devices",
  "documentation": "https://support.google.com/merchants/answer/6098296",
  "applicableCountries": [
            "US", "UK"
  ]
 }
],
"creationDate": "2019-02-15T20:30:15Z",
"lastUpdateDate": "2019-02-26T16:40:11Z",
"googleExpirationDate": "2019-03-28T16:40:11Z"
}

모든 제품 상태 나열

productstatuses.list을 사용하여 모든 제품과 제품의 상태를 확인합니다.

다음 매개변수를 사용하여 쿼리를 세부적으로 조정할 수 있습니다.

  • destinations: 상태를 확인할 대상입니다.
  • pageToken: 결과의 후속 페이지를 가져오는 데 사용됩니다. 모든 페이지에는 시퀀스의 다음 페이지를 가져오는 데 사용할 수 있는 nextPageToken이 있습니다.
  • maxResults: 페이지당 최대 결과 수입니다.

다음은 선택적 쿼리 매개변수가 포함된 샘플 list 요청입니다.

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

샘플 JSON 응답은 다음과 같습니다.

{
"kind": "content#productstatusesListResponse",
"nextPageToken": "632fd090c95712c6",
"resources": [
 {
   "kind": "content#productStatus",
   "productId": "online:en:US:online-en-US-GGL614",
   "title": "Green Headphones",
   "link": "https://example.com/green-headphones/",
   "destinationStatuses": [
     {
       "destination": "Shopping",
       "status": "disapproved",
       "disapprovedCountries": [
            "US", "UK"
       ]
     },
     {
       "destination": "ShoppingActions",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     },
     {
       "destination": "SurfacesAcrossGoogle",
       "status": "disapproved",
       "disapprovedCountries": [
            "US"
       ]
     }
   ],
   "itemLevelIssues": [
     {
       "code": "mobile_landing_page_crawling_not_allowed",
       "servability": "disapproved",
       "resolution": "merchant_action",
       "attributeName": "link",
       "destination": "Shopping",
       "description": "Mobile page not crawlable due to robots.txt",
       "detail": "Update your robots.txt file to allow user-agents \"Googlebot\" and \"Googlebot-Image\" to crawl your site",
       "documentation": "https://support.google.com/merchants/answer/6098296",
       "applicableCountries": [
            "US"
       ]
     },
     {
       "code": "pending_initial_policy_review",
       "servability": "disapproved",
       "resolution": "pending_processing",
       "destination": "Shopping",
       "description": "Pending initial review",
       "documentation": "https://support.google.com/merchants/answer/2948694",
       "applicableCountries": [
            "US, UK"
       ]
     },
     {
       "code": "ambiguous_gtin",
       "servability": "unaffected",
       "resolution": "merchant_action",
       "attributeName": "gtin",
       "destination": "Shopping",
       "description": "Ambiguous value [gtin]",
       "detail": "Use the full GTIN. Include leading zeroes, and use the full UPC, EAN, JAN, ISBN-13, or ITF-14.",
       "documentation": "https://support.google.com/merchants/answer/7000891",
       "applicableCountries": [
            "US", "UK"
       ]
     }
   ],
   "creationDate": "2020-01-09T15:36:39Z",
   "lastUpdateDate": "2020-01-14T19:17:02Z",
   "googleExpirationDate": "2020-02-13T19:17:02Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:43",
  "title": "Green shirt",
  "link": "https://example.com/shirt-green/",
  "destinationStatuses": [
   {
    "destination": "ShoppingActions",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   },
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 },
 {
  "kind": "content#productStatus",
  "productId": "online:en:US:40",
  "title": "Black hat",
  "link": "https://example.com/hat-black/",
  "destinationStatuses": [
   {
    "destination": "SurfacesAcrossGoogle",
    "status": "approved",
    "approvedCountries": [
            "US"
    ]
   }
  ],
  "creationDate": "2019-01-29T21:14:36Z",
  "lastUpdateDate": "2019-02-21T18:47:44Z",
  "googleExpirationDate": "2019-03-23T18:47:44Z"
 }
]
}

productstatuses.list 호출은 데이터에 변경사항을 적용하지 않으므로 프로덕션에서 테스트해도 안전합니다.

대상

쇼핑 제품에 사용할 수 있는 대상 위치는 다음과 같습니다.

  • shopping ads: 쇼핑 광고 제품입니다.
  • ShoppingActions: Buy on Google 제품입니다.
  • surfaces across google: 무료 등록정보 제품입니다.
  • shopping: 오프라인 판매점 인벤토리 광고 제품입니다.

상품 수준 문제

각 항목 수준 문제에는 다음 필드가 포함됩니다.

  • code: 문제를 확인하는 데 사용되는 오류 코드입니다.
  • servability: 제품이 다음과 같이 표시되는지 나타냅니다.
    • disapproved: 이 문제로 인해 제품이 표시되지 않습니다.
    • unaffected: 제품이 계속 표시됩니다.
  • resolution: 판매자가 문제를 해결할 수 있는지 여부를 알려줍니다.
  • attributeName: 영향을 받는 속성 이름입니다.
  • destination: 영향을 받는 대상입니다.
  • description: 제품에 대한 설명입니다.
  • detail: 문제에 관한 자세한 정보를 제공합니다.
  • documentation: 문제에 관한 문서를 찾을 수 있는 위치를 나타냅니다.
  • applicableCountries: 문제가 제품에 영향을 미치는 국가를 나타냅니다.