Trang này được dịch bởi Cloud Translation API.

Trạng thái sản phẩm

Bạn có thể sử dụng tài nguyên productstatuses để xem trạng thái chi tiết của các sản phẩm trên Google Mua sắm.

Hãy xem vấn đề về sản phẩm để biết thông tin chi tiết về các vấn đề thường gặp.

Người bán có trách nhiệm tuân thủ các chính sách của quảng cáo Mua sắm và trang thông tin miễn phí. Google Mua sắm giữ quyền thực thi những chính sách này và phản hồi một cách thích hợp nếu phát hiện thấy nội dung hoặc hành vi vi phạm những chính sách này.

Yêu cầu

Bạn phải làm những việc sau để xem trạng thái của sản phẩm:

Đăng ký tài khoản của bạn ở một đích đến.
Hãy cung cấp mã quốc gia hợp lệ theo một trong những cách sau:
- Trường feedLabel.
- Trường shipping.
- Ở cấp nguồn cấp dữ liệu.
- Chế độ cài đặt thông tin vận chuyển của tài khoản.

Xem trạng thái của sản phẩm

Sử dụng productstatuses.get để xem trạng thái của sản phẩm.

Bạn có thể dùng tham số destinations trong các yêu cầu get và list để xem các vấn đề đối với một đích đến cụ thể. Nếu bạn không chỉ định một đích đến, các vấn đề từ mọi đích đến đủ điều kiện sẽ được trả về.

Dưới đây là yêu cầu get mẫu, với tham số truy vấn không bắt buộc:

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

Tất cả phản hồi của productstatuses.get bao gồm các trường sau:

kind: Giá trị luôn là content#productStatus.
creationDate: Ngày tạo sản phẩm.
lastUpdateDate: Lần cập nhật sản phẩm gần đây nhất.
googleExpirationDate: Ngày sản phẩm hết hạn.
productId: Mã nhận dạng REST của sản phẩm.
title: Tiêu đề của sản phẩm.
link: Đường liên kết URL của sản phẩm.
destinationStatuses: Trạng thái của sản phẩm ở mỗi vị trí xuất hiện và quốc gia.

Bạn sẽ chỉ thấy trường itemLevelIssues trong phản hồi nếu sản phẩm gặp vấn đề ở cấp mặt hàng tại thời điểm bạn yêu cầu.

Dưới đây là phản hồi JSON mẫu:

{
"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"
}

Liệt kê tất cả trạng thái sản phẩm

Sử dụng productstatuses.list để xem tất cả sản phẩm và trạng thái của các sản phẩm đó.

Bạn có thể sử dụng các tham số sau để tinh chỉnh truy vấn của mình:

destinations: Đích đến để xem trạng thái.
pageToken: Dùng để lấy các trang kết quả tiếp theo. Mỗi trang đều có một nextPageToken mà bạn có thể sử dụng để chuyển trang tiếp theo trong trình tự.
maxResults: Số lượng kết quả tối đa trên mỗi trang.

Dưới đây là yêu cầu list mẫu với tham số truy vấn không bắt buộc:

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

Dưới đây là phản hồi JSON mẫu:

{
"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"
 }
]
}

Lệnh gọi productstatuses.list có thể an toàn để kiểm thử trong môi trường thực tế vì nó không thực hiện bất kỳ thay đổi nào đối với dữ liệu của bạn.

Điểm đến

Sau đây là những vị trí xuất hiện mà bạn có thể sử dụng cho các sản phẩm trên Google Mua sắm:

shopping ads: Các sản phẩm trên quảng cáo Mua sắm.
ShoppingActions: Các sản phẩm của chương trình Mua trên Google.
surfaces across google: Sản phẩm trên trang thông tin miễn phí.
shopping: Sản phẩm trong Quảng cáo kho hàng tại địa phương.

Vấn đề ở cấp mặt hàng

Mỗi vấn đề ở cấp mặt hàng bao gồm các trường sau:

code: Mã lỗi dùng để xác định sự cố.
servability: Cho biết sản phẩm có xuất hiện dưới dạng:
- disapproved: Vấn đề khiến sản phẩm không xuất hiện được.
- unaffected: Sản phẩm vẫn xuất hiện.
resolution: Thông báo xem người bán có thể giải quyết được vấn đề hay không.
attributeName: Tên thuộc tính bị ảnh hưởng.
destination: Đích đến bị ảnh hưởng.
description: Nội dung mô tả của sản phẩm.
detail: Cung cấp thêm thông tin về vấn đề.
documentation: Cho biết nơi bạn có thể tìm tài liệu về vấn đề đó.
applicableCountries: Cho biết vấn đề này ảnh hưởng đến sản phẩm ở những quốc gia nào.