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

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

ดูปัญหาเกี่ยวกับผลิตภัณฑ์ เพื่อดูรายละเอียดปัญหาที่พบได้ทั่วไป

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

ข้อกำหนด

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

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

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

ใช้ productstatuses.get เพื่อดู สถานะของผลิตภัณฑ์

คุณสามารถใช้พารามิเตอร์ destinations ในคำขอ get และ list เพื่อดูปัญหาสำหรับปลายทางที่เฉพาะเจาะจงได้ หากคุณไม่ได้ระบุ ปลายทาง ปัญหาจากปลายทางที่มีสิทธิ์ทั้งหมดจะแสดงผล

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

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses/{productId}?destinations=Shopping&fields=productId%2Ctitle

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

  • kind: มีค่าเป็น content#productStatus เสมอ
  • creationDate: วันที่สร้างผลิตภัณฑ์
  • lastUpdateDate: เวลาล่าสุดที่มีการอัปเดตผลิตภัณฑ์
  • googleExpirationDate: วันที่ที่ผลิตภัณฑ์หมดอายุ
  • productId: รหัส REST ของผลิตภัณฑ์
  • title: ชื่อผลิตภัณฑ์
  • link: ลิงก์ URL ของผลิตภัณฑ์
  • destinationStatuses: สถานะของผลิตภัณฑ์ในแต่ละปลายทางและประเทศ

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

ตัวอย่างการตอบสนอง JSON มีดังนี้

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

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

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

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

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

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

GET https://shoppingcontent.googleapis.com/content/v2.1/{merchantID}/productstatuses?destinations=Shopping&maxResults=3&pageToken=5108b52782905aa9

ตัวอย่างการตอบสนอง JSON มีดังนี้

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

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

จุดหมาย

ปลายทางที่คุณใช้สำหรับผลิตภัณฑ์ Shopping ได้มีดังนี้

  • shopping ads: ผลิตภัณฑ์โฆษณา Shopping
  • ShoppingActions: ผลิตภัณฑ์ "ซื้อใน Google"
  • surfaces across google: ผลิตภัณฑ์ข้อมูลที่แสดงฟรี
  • shopping: ผลิตภัณฑ์โฆษณาสินค้าคงคลังในร้าน

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

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

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