สถานะผลิตภัณฑ์

คุณใช้แหล่งข้อมูล Product เพื่อดูสถานะโดยละเอียดของผลิตภัณฑ์ Shopping ได้

เมื่อใช้ Content API คุณจะเรียกข้อมูลสถานะผลิตภัณฑ์ได้โดยเรียกใช้เมธอด ProductStatuses.get เมื่อใช้ Merchant API คุณจะเรียกข้อมูลสถานะผลิตภัณฑ์ได้โดยการดึงข้อมูลแหล่งข้อมูล Accounts.Products

คุณมีหน้าที่รับผิดชอบในการปฏิบัติตามนโยบายโฆษณา Shopping และข้อมูลที่แสดงฟรี โฆษณา Shopping ขอสงวนสิทธิ์ในการบังคับใช้นโยบายเหล่านี้และตอบกลับตามความเหมาะสมหากเราพบเนื้อหาหรือพฤติกรรมที่ละเมิดนโยบายเหล่านี้

ข้อกำหนด

หากต้องการดูสถานะผลิตภัณฑ์ คุณต้องดำเนินการต่อไปนี้

• ลงทะเบียนบัญชีในปลายทาง
• ระบุรหัสประเทศที่ถูกต้องในรูปแบบใดรูปแบบหนึ่งต่อไปนี้
  • ช่อง feedLabel
  • ช่อง shipping
  • ที่ระดับฟีด
  • การตั้งค่าการจัดส่งในบัญชี

ดูสถานะของผลิตภัณฑ์

ดึงข้อมูลทรัพยากร Accounts.Products เพื่อดูสถานะของผลิตภัณฑ์

นี่คือตัวอย่างคำขอ GET

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

คำตอบทั้งหมดจาก products.get จะมีช่องต่อไปนี้

• creationDate: วันที่สร้างผลิตภัณฑ์
• lastUpdateDate: ครั้งล่าสุดที่มีการอัปเดตผลิตภัณฑ์
• googleExpirationDate: วันที่ที่ผลิตภัณฑ์หมดอายุ
• destinationStatuses: ปลายทางที่ต้องการสำหรับผลิตภัณฑ์
• itemLevelIssues: รายการปัญหาทั้งหมดที่เกี่ยวข้องกับผลิตภัณฑ์

คุณจะเห็นช่อง itemLevelIssues ในการตอบกลับในกรณีที่ผลิตภัณฑ์มีปัญหาระดับสินค้า ณ เวลาที่คุณส่งคำขอเท่านั้น

ต่อไปนี้คือตัวอย่างการตอบสนอง JSON

{
"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"
}

แสดงรายการสถานะผลิตภัณฑ์ทั้งหมด

ใช้ products.list เพื่อดูผลิตภัณฑ์ทั้งหมดและสถานะของผลิตภัณฑ์

คุณใช้พารามิเตอร์ต่อไปนี้เพื่อปรับแต่งคำค้นหาได้

• pageToken: ใช้เพื่อดูหน้าถัดไปของผลการค้นหา ทุกหน้าจะมี nextPageToken ที่คุณใช้เพื่อรับหน้าถัดไปในลำดับได้
• maxResults: จำนวนผลลัพธ์สูงสุดต่อหน้า

ต่อไปนี้คือตัวอย่างคำขอ list ที่มีพารามิเตอร์การค้นหาที่ไม่บังคับ

GET https://merchantapi.googleapis.com/products/v1beta/{parent}/products?maxResults=1&pageToken=5108b52782905aa9

ต่อไปนี้คือตัวอย่างการตอบสนอง JSON

{
"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"
  }
]
}

การเรียกใช้ productstatuses.list ปลอดภัยสำหรับการทดสอบในเวอร์ชันที่ใช้งานจริงเนื่องจากไม่ได้ทำการเปลี่ยนแปลงใดๆ กับข้อมูล

ปัญหาระดับสินค้า

ปัญหาระดับสินค้าแต่ละรายการจะมีช่องต่อไปนี้

• code: รหัสข้อผิดพลาดของปัญหา
• severity: ความรุนแรงของปัญหา
• resolution: แจ้งว่าผู้ขายจะแก้ไขปัญหาได้หรือไม่
• attribute: ชื่อแอตทริบิวต์ที่ได้รับผลกระทบ
• reportingContext: บริบทการรายงานที่มีปัญหา
• description: คำอธิบายปัญหา
• detail: ให้ข้อมูลเพิ่มเติมเกี่ยวกับปัญหา
• documentation: URL สำหรับเอกสารประกอบเกี่ยวกับปัญหา
• applicableCountries: ระบุประเทศที่ปัญหาส่งผลต่อผลิตภัณฑ์