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 Mua sắm.

Hãy 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ủ 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 có quyền thực thi các chính sách này và phản hồi một cách thích đáng nếu chúng tôi phát hiện thấy 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ững việc sau để xem trạng thái sản phẩm:

  • Đăng ký tài khoản của bạn tại một điểm đến.
  • Cung cấp mã quốc gia hợp lệ trong một trong những trường 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 một 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ể sử 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 điểm đến cụ thể. Nếu bạn không chỉ định một điểm đến, thì các vấn đề từ tất cả điểm đến đủ điều kiện sẽ được trả về.

Sau đâ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ả phản hồi từ productstatuses.get đều bao gồm các trường sau:

  • kind: Giá trị luôn là content#productStatus.
  • creationDate: Ngày sản phẩm được tạo.
  • lastUpdateDate: Lần gần đây nhất sản phẩm được cập 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 ở 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 gặp các vấn đề ở cấp mặt hàng tại thời điểm bạn gửi yêu cầu.

Sau đâ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 cụm từ tìm kiếm:

  • destinations: Điểm đế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ể dùng để nhận trang tiếp theo trong chuỗi.
  • maxResults: Số lượng kết quả tối đa trên mỗi trang.

Sau đâ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

Sau đâ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"
 }
]
}

Bạn có thể kiểm thử lệnh gọi productstatuses.list một cách an toàn trong môi trường thực tế vì lệnh gọi này không thay đổi dữ liệu của bạn.

Điểm đến

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

  • shopping ads: Sản phẩm trên Quảng cáo Mua sắm.
  • ShoppingActions: Sản phẩm trên 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 trên 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 vấn đề.
  • servability: Cho biết sản phẩm được hiển thị như sau:
    • disapproved: Vấn đề này khiến sản phẩm không được hiển thị.
    • unaffected: Sản phẩm vẫn được hiển thị.
  • resolution: Thông báo nếu người bán có thể giải quyết vấn đề.
  • attributeName: Tên thuộc tính bị ảnh hưởng.
  • destination: Điểm đến bị ảnh hưởng.
  • description: Nội dung mô tả 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ề vấn đề.
  • applicableCountries: Cho biết những quốc gia mà vấn đề ảnh hưởng đến sản phẩm.