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

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

Với Content API, bạn có thể truy xuất trạng thái sản phẩm bằng cách gọi hàm ProductStatuses.get. Thông qua API Merchant, bạn có thể truy xuất sản phẩm trạng thái bằng cách truy xuất tài nguyên Accounts.Products.

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. Quảng cáo Mua sắm giữ quyền thực thi những chính sách này và phản hồi thích hợp nếu chúng tôi tìm nội dung hoặc hành vi vi phạm các chính sách này.

Yêu cầu

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

  • Đă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

Truy xuất tài nguyên Accounts.Products để xem trạng thái của một sản phẩm.

Dưới đây là yêu cầu GET mẫu:

GET https://merchantapi.googleapis.com/products/v1beta/{name=accounts/*/products/*}

Tất cả câu trả lời của products.get bao gồm các trường sau:

  • 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.
  • destinationStatuses: Vị trí xuất hiện dự kiến của sản phẩm.
  • itemLevelIssues: Danh sách tất cả các vấn đề liên quan đến sản phẩm.

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

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

{
"name": "accounts/123/products/online~en~US~1",
"channel": "ONLINE",
"offerId": "1",
"contentLanguage": "en",
"feedLabel": "US",
"dataSource": "accounts/123/dataSources/456",
"attributes": {
  "title": "Color Headphones",
  "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
  "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
  "availability": "in stock",
  "brand": "Google",
  "condition": "new",
  "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
  "gtin": "00050644632143",
  "mpn": "90000007101",
  "price": {
    "amountMicros": "288000",
    "currencyCode": "USD"
  }
},
"productStatus": {
  "destinationStatuses": [
    {
      "reportingContext": "FREE_LISTINGS",
      "disapprovedCountries": [
        "US"
      ]
    }
  ],
  "itemLevelIssues": [
    {
      "code": "pending_phone_verification",
      "severity": "NOT_IMPACTED",
      "resolution": "merchant_action",
      "reportingContext": "FREE_LISTINGS",
      "description": "Unverified phone number",
      "detail": "Go to the Business information page to verify your business phone number",
      "documentation": "https://support.google.com/merchants/answer/10139041",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "pending_initial_policy_review_free_listings",
      "severity": "DISAPPROVED",
      "resolution": "pending_processing",
      "reportingContext": "FREE_LISTINGS",
      "description": "Pending initial review",
      "detail": "Please wait up to 3 business days for the review to be completed",
      "documentation": "https://support.google.com/merchants/answer/2948694",
      "applicableCountries": [
        "US"
      ]
    },
    {
      "code": "url_does_not_match_homepage",
      "severity": "DISAPPROVED",
      "resolution": "merchant_action",
      "attribute": "link",
      "reportingContext": "FREE_LISTINGS",
      "description": "Mismatched domains [link]",
      "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
      "documentation": "https://support.google.com/merchants/answer/160050",
      "applicableCountries": [
        "US"
      ]
    }
  ],
  "creationDate": "2024-05-27T16:15:31.791730Z",
  "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
  "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
}

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

Sử dụng products.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:

  • 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://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9

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

{
"nextPageToken": "632fd090c95712c6",
"products": [
 {
  "name": "accounts/123/products/online~en~US~1",
  "channel": "ONLINE",
  "offerId": "1",
  "contentLanguage": "en",
  "feedLabel": "US",
  "dataSource": "accounts/123/dataSources/10355371287",
  "attributes": {
    "title": "Color Headphones",
    "description": "A light and elegant design and super sound quality make these over-ear headphones a constant companion. Foldable to save space, and printed with the white Google logo on one earpiece.",
    "imageLink": "http://tmp53317.purecake.com/images/headphones.jpg",
    "availability": "in stock",
    "brand": "Google",
    "condition": "new",
    "googleProductCategory": "Electronics \u003e Audio \u003e Audio Components \u003e Headphones",
    "gtin": "00050644632143",
    "mpn": "90000007101",
    "price": {
      "amountMicros": "28800000",
      "currencyCode": "USD"
    }
  },
  "productStatus": {
    "destinationStatuses": [
      {
        "reportingContext": "FREE_LISTINGS",
        "disapprovedCountries": [
          "US"
        ]
      }
    ],
    "itemLevelIssues": [
      {
        "code": "pending_phone_verification",
        "severity": "NOT_IMPACTED",
        "resolution": "merchant_action",
        "reportingContext": "FREE_LISTINGS",
        "description": "Unverified phone number",
        "detail": "Go to the Business information page to verify your business phone number",
        "documentation": "https://support.google.com/merchants/answer/10139041",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "pending_initial_policy_review_free_listings",
        "severity": "DISAPPROVED",
        "resolution": "pending_processing",
        "reportingContext": "FREE_LISTINGS",
        "description": "Pending initial review",
        "detail": "Please wait up to 3 business days for the review to be completed",
        "documentation": "https://support.google.com/merchants/answer/2948694",
        "applicableCountries": [
          "US"
        ]
      },
      {
        "code": "url_does_not_match_homepage",
        "severity": "DISAPPROVED",
        "resolution": "merchant_action",
        "attribute": "link",
        "reportingContext": "FREE_LISTINGS",
        "description": "Mismatched domains [link]",
        "detail": "Use the same domain for product landing page URLs as in your Merchant Center website setting",
        "documentation": "https://support.google.com/merchants/answer/160050",
        "applicableCountries": [
          "US"
        ]
      }
    ],
    "creationDate": "2024-05-27T16:15:31.791730Z",
    "lastUpdateDate": "2024-05-27T16:15:31.791730Z",
    "googleExpirationDate": "2024-06-26T16:15:31.791730Z"
  }
]
}

Lệnh gọi productstatuses.list an toàn để thử nghiệm trong phiên bản chính thức 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.

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ủa vấn đề.
  • severity: Mức độ nghiêm trọng của vấn đề.
  • resolution: Thông báo xem người bán có thể giải quyết vấn đề hay không.
  • attribute: Tên thuộc tính bị ảnh hưởng.
  • reportingContext: Ngữ cảnh báo cáo liên quan đến vấn đề.
  • description: Nội dung mô tả về vấn đề.
  • detail: Cung cấp thêm thông tin về vấn đề.
  • documentation: URL cho tài liệu về vấn đề.
  • applicableCountries: Cho biết vấn đề này ảnh hưởng đến những quốc gia nào của Google.