แค็ตตาล็อกที่ใช้งานได้ของผู้ใช้ Instagram

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

การสร้าง

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

การอ่าน

GET /{ig-user-id}/available_catalogs

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

ข้อจำกัด

ไม่รองรับบัญชีครีเอเตอร์ Instagram
ไม่รองรับสตอรี่, Instagram TV, Reels, Live และ Mentions
ส่งคืนข้อมูลในแค็ตตาล็อกเดียวเท่านั้น เนื่องจากมีการจำกัดร้านค้าบน Instagram ให้อยู่ในแค็ตตาล็อกเดียว
ไม่รองรับแค็ตตาล็อกร่วม (แค็ตตาล็อกของพาร์ทเนอร์การช้อปปิ้งหรือครีเอเตอร์แอฟฟิลิเอต)

ข้อกำหนด

ประเภท	ข้อกำหนด
โทเค็นการเข้าถึง	ผู้ใช้
บทบาททางธุรกิจ	ผู้ใช้แอพต้องมีบทบาทผู้ดูแลในตัวจัดการธุรกิจซึ่งเป็นเจ้าของร้านค้าบน 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}/available_catalogs
  ?fields={fields}
  &access_token={access-token}

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

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

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

คีย์	ตัวยึดตำแหน่ง	ค่า
`access_token`	`{access-token}`	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ
`fields`	`{fields}`	รายการช่องของแค็ตตาล็อกซึ่งคั่นด้วยเครื่องหมายจุลภาคที่คุณต้องการให้ส่งคืนสำหรับแค็ตตาล็อกแต่ละรายการในชุดผลลัพธ์

การตอบกลับ

อ็อบเจ็กต์รูปแบบ JSON ที่มีข้อมูลที่คุณส่งคำขอ

{
  "data": [
    {
      "catalog_id": "{catalog-id}",
      "catalog_name": "{catalog-name}",
      "shop_name": "{shop-name}",
      "product_count": {product-count}
    }
  ]
}

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

คุณสมบัติ	ค่า
`catalog_id`	ID แค็ตตาล็อก
`catalog_name`	ชื่อแค็ตตาล็อก
`shop_name`	ชื่อร้านค้า
`product_count`	จำนวนสินค้าในแค็ตตาล็อก รวมสินค้าทั้งหมดไม่ว่าจะอยู่ในสถานะการตรวจสอบใด

ตัวอย่าง cURL

คำขอ

curl -i -X GET \
 "https://graph.facebook.com/v19.0/90010177253934/available_catalogs?access_token=EAAOc..."

การตอบกลับ

{
  "data": [
    {
      "catalog_id": "960179311066902",
      "catalog_name": "Jay's Favorite Snacks",
      "shop_name": "Jay's Bespoke",
      "product_count": 11
    }
  ]
}

การอัพเดต

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

การลบ

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