การค้นหาสินค้าในแค็ตตาล็อกสำหรับผู้ใช้ Instagram

หมายถึงสินค้าและแบบสินค้าที่ตรงกับสตริงการค้นหาที่กำหนดในแค็ตตาล็อกสินค้าของร้านค้าบน Instagram ของผู้ใช้ Instagram โปรดดูรายละเอียดการใช้งานทั้งหมดในคู่มือการแท็กสินค้า

การสร้าง

ไม่รองรับการดำเนินการนี้

การอ่าน

GET /{ig-user-id}/catalog_product_search

ดึงข้อมูลคอลเลกชั่นสินค้าที่ตรงกับสตริงการค้นหาที่ระบุภายในแค็ตตาล็อกร้านค้าบน Instagram ของผู้ใช้ Instagram ที่กำหนดเป้าหมายไว้

ข้อจำกัด

ไม่รองรับบัญชีครีเอเตอร์ Instagram
ไม่รองรับสตอรี่, Instagram TV, Reels, Live และ Mentions
ระบบจะส่งคืนสินค้าที่มี review_status เป็น rejected แต่จะไม่สามารถแท็กสื่อบน Instagram ด้วยสินค้าที่ถูกปฏิเสธได้
แม้ว่า API จะไม่ส่งคืนข้อผิดพลาดเมื่อเผยแพร่โพสต์ที่มีการแท็กสินค้าที่ไม่ได้รับการอนุมัติ แต่แท็กจะไม่ปรากฏบนโพสต์ที่เผยแพร่จนกว่าสินค้านั้นจะได้รับการอนุมัติ ดังนั้น เราขอแนะนำให้คุณอนุญาตให้ผู้ใช้แอพของคุณเผยแพร่โพสต์ที่มีแท็กโดยที่สินค้าที่แท็กมี review_status เป็น approved โดยจะมีการส่งคืนช่องนี้สำหรับผลิตภัณฑ์แต่ละรายการตามค่าเริ่มต้นเมื่อคุณได้รับสินค้าที่มีสิทธิ์ของผู้ใช้แอพ

ข้อกำหนด

ประเภท	ข้อกำหนด
โทเค็นการเข้าถึง	ผู้ใช้
บทบาทในธุรกิจ	ผู้ใช้แอพต้องมีบทบาทผู้ดูแลในตัวจัดการธุรกิจซึ่งเป็นเจ้าของร้านค้าบน Instagram ของผู้ใช้ Instagram
ร้านค้าบน Instagram	ผู้ใช้ Instagram ต้องมีร้านค้าบน Instagram ที่ได้รับการอนุมัติ พร้อมแค็ตตาล็อกสินค้าที่มีสินค้าต่างๆ
สิทธิ์การอนุญาต	`catalog_management` `instagram_basic` `instagram_shopping_tag_products` `pages_show_list` หากผู้ใช้แอพได้รับบทบาทในเพจที่เชื่อมต่อกับผู้ใช้ Instagram เป้าหมายผ่านทางตัวจัดการธุรกิจ คุณจะต้องมีสิทธิ์การอนุญาตอย่างใดอย่างหนึ่งต่อไปนี้ด้วย `ads_management` `business_management`

รูปแบบคำสั่งของคำขอ

GET https://graph.facebook.com/{api-version}/{ig-user-id}/catalog_product_search
  ?catalog_id={catalog-id}
  &q={q}
  &access_token={access-token}

พารามิเตอร์พาธ

ตัวยึดตำแหน่ง	ค่า
`{api-version}`	เวอร์ชั่น API
`{ig-user-id}`	จำเป็นต้องระบุ ID ผู้ใช้ในแอพของผู้ใช้แอพ

พารามิเตอร์สตริงการสืบค้น

คีย์	ตัวยึดตำแหน่ง	ค่า
`access_token`	`{access-token}`	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ
`catalog_id`	`{catalog-id}`	จำเป็นต้องระบุ ID ของแค็ตตาล็อกที่จะค้นหา
`q`	`{q}`	สตริงสำหรับค้นหาชื่อหรือหมายเลข SKU ของสินค้าแต่ละรายการ (สามารถเพิ่มหมายเลข SKU ในคอลัมน์ ID เนื้อหาในอินเทอร์เฟซการจัดการแค็ตตาล็อกได้) หากไม่มีการระบุสตริง ระบบจะส่งคืนสินค้าที่มีสิทธิ์แท็กทั้งหมด

การตอบกลับ

อ็อบเจ็กต์ในรูปแบบ JSON ที่มีอาร์เรย์ของสินค้าที่มีสิทธิ์แท็กและเมตาดาต้าของสินค้าเหล่านั้น รองรับการแบ่งหน้าโดยอิงจากเคอร์เซอร์

{
  "data": [
    {
      "product_id": {product-id},
      "merchant_id": {merchant-id},
      "product_name": "{product-name}",
      "image_url": "{image-url}",
      "retailer_id": "{retailer-id}",
      "review_status": "{review-status}",
      "is_checkout_flow": {is-checkout-flow}
    }
  ]
}

เนื้อหาของการตอบกลับ

พร็อพเพอร์ตี้	ค่า
`product_id`	ID สินค้า
`merchant_id`	ID ผู้ขาย
`product_name`	ชื่อสินค้า
`image_url`	URL รูปภาพของสินค้า
`retailer_id`	ID ผู้ค้าปลีก
`review_status`	สถานะการตรวจสอบ ซึ่งอาจมีค่าเป็น `approved`, `outdated`, `pending` และ `rejected` สินค้าที่ได้รับการอนุมัติสามารถปรากฏในร้านค้าบน Instagram ของผู้ใช้แอพ แต่สถานะที่ได้รับการอนุมัติไม่ได้บ่งบอกถึงความพร้อมจำหน่ายของสินค้า (เช่น สินค้าอาจหมดสต็อก) มีเพียงแท็กที่เชื่อมโยงกับสินค้าที่มี `review_status` เป็น `approved` เท่านั้นที่สามารถปรากฏบนโพสต์ที่เผยแพร่
`is_checkout_flow`	หากเป็น `true` จะสามารถซื้อสินค้าได้โดยตรงในแอพ Instagram แต่หากเป็น `false` จะต้องซื้อผลิตภัณฑ์ในแอพหรือเว็บไซต์ของผู้ใช้แอพ
`product_variants`	ID สินค้า (`product_id`) และชื่อรุ่น (`variant_name`) ของรุ่นย่อยของสินค้า

ตัวอย่าง cURL

คำขอ

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/catalog_product_search?catalog_id=960179311066902&q=gummy&access_token=EAAOc"

การตอบกลับ

{
  "data": [
    {
      "product_id": 3231775643511089,
      "merchant_id": 90010177253934,
      "product_name": "Gummy Wombats",
      "image_url": "https://scont...",
      "retailer_id": "oh59p9vzei",
      "review_status": "approved",
      "is_checkout_flow": true,
      "product_variants": [
            {
              "product_id": 5209223099160494
            },
            {
              "product_id": 7478222675582505,
              "variant_name": "Green Gummy Wombats"
            }
          ]
    }
  ]
}

การอัพเดต

ไม่รองรับการดำเนินการนี้

การลบ

ไม่รองรับการดำเนินการนี้