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 dùng trên Mua sắm.

Xem bài viết 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ủ 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 các chính sách này và phản hồi thích hợp nếu phát hiện 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ư 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 nơi 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, thì 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, 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 ở từng điểm đế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 có 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 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 đề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 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 là an toàn để kiểm thử trong môi trường thực tế vì 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

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 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 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 đề ảnh hưởng đến sản phẩm ở những quốc gia nào.