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 bạn mua trên Google Mua sắm.

Xem các 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ủ Chính sách mua sắm quảng cáo và miễn phí trang thông tin. Điều khoản 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 chúng tôi phát hiện nội dung hoặc hành vi vi phạm các chính sách này.

Yêu cầu

Bạn phải làm như sau để xem trạng thái sản phẩm:

  • Đăng ký tài khoản của bạn ở một đích đến.
  • Cung cấp mã quốc gia hợp lệ tại một trong các quốc gia 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 trong tài khoản của bạn.

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

Sử dụng productstatuses.get để xem trạng thái của một 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 đích đến, các vấn đề từ tất cả vị trí xuất hiện đủ điều kiện sẽ được trả lại.

Dưới đây là yêu cầu get mẫu, có các 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ả câu trả lờ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ã 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 điểm đến và quốc gia.

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

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 chúng.

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 để nhận các trang kết quả tiếp theo. Mỗi trang có một nextPageToken mà bạn có thể sử dụng để xem trang tiếp theo trong trình tự.
  • maxResults: Số lượng kết quả tối đa mỗi trang.

Dưới đây là yêu cầu list mẫu có các 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 an toàn để thử nghiệm trong môi trường thực tế vì nó không làm thay đổi dữ liệu của bạn.

Điểm đến

Dưới đây là các đích đến mà bạn có thể sử dụng cho các sản phẩm trên Mua sắm:

  • shopping ads: Các sản phẩm trong 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: Các 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 được 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: Sự cố này khiến sản phẩm không thể đang được hiển thị.
    • 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 vấn đề hay không.
  • attributeName: Tên thuộc tính bị ảnh hưởng.
  • destination: Vị trí xuất hiệ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 tìm tài liệu về sự cố.
  • applicableCountries: Cho biết vấn đề này ảnh hưởng đến những quốc gia nào của Google.