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 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 các chính sách này và có biện pháp xử lý thích hợp nếu 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 tại một vị trí đích.
  • 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.

Lấy 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ể sử dụng tham số destinations trong các yêu cầu get và list để xem các vấn đề của một đích đến cụ thể. Nếu bạn không chỉ định đích đến, vấn đề từ tất cả đích đến đủ điều kiện sẽ được trả về.

Sau đây là một 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á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 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 ở 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 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à một 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 biểu tượng productstatuses.list để xem tất cả sản phẩm và trạng thái của sản phẩm.

Bạn có thể sử dụng các tham số sau để tinh chỉnh cụm từ tìm kiếm:

  • 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ể dùng để lấy 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

Dưới đây là một 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ử productstatuses.list một cách an toàn trong quá trình sản xuấ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à những vị trí xuất hiện mà bạn có thể sử dụng cho sản phẩm Mua sắm:

  • shopping ads: Sản phẩm trong quảng cáo Mua sắm.
  • ShoppingActions: Sản phẩm Mua trên Google.
  • surfaces across google: Sản phẩm trong trang thông tin miễn phí.
  • shopping: Sản phẩm 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 đều có các trường sau:

  • code: Mã lỗi dùng để xác định vấn đề.
  • servability: Cho biết liệu sản phẩm có xuất hiện dưới dạng:
    • disapproved: Vấn đề này khiến sản phẩm không xuất hiện.
    • unaffected: Sản phẩm vẫn xuất hiện.
  • resolution: Cho biết liệu 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: Đ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 vấn đề ảnh hưởng đến sản phẩm ở những quốc gia nào.