แพลตฟอร์ม Instagram

การแท็กสินค้า

คุณสามารถใช้ API กราฟของ Instagram เพื่อสร้างและจัดการแท็กสินค้า Instagram Shopping ในสื่อบน Instagram ของบัญชีธุรกิจบน Instagram ได้

หมายเหตุ: ตั้งแต่วันที่ 10 สิงหาคม 2023 เป็นต้นไป ธุรกิจบางรายที่ไม่มีร้านค้าที่เปิดใช้งานการชำระเงินจะไม่สามารถแท็กสินค้าโดยใช้ API การเผยแพร่เนื้อหาได้อีกต่อไป ซึ่งจะส่งผลกระทบต่อทั้ง API และอินเทอร์เฟซแบบเนทีฟ และระบบจะลบแท็กออกจากสินค้าในโพสต์ก่อนหน้า ลูกค้าจะยังคงแท็กสินค้าจากร้านค้าที่เปิดใช้งานการชำระเงินบน Facebook และ Instagram ได้ ทั้งนี้ คุณยังคงสามารถดูช่อง shopping_product_tag_eligibility เพื่อตรวจสอบว่าบัญชี Instagram มีสิทธิ์แท็กสินค้าโดยใช้ API การเผยแพร่เนื้อหาอยู่หรือไม่

ขั้นตอนทั่วไปสำหรับการแท็กสินค้ามีดังนี้

  1. ตรวจสอบว่าธุรกิจบน Instagram มีสิทธิ์แท็กสินค้าหรือไม่
  2. หากธุรกิจบน Instagram มีสิทธิ์ ให้เรียกดูแค็ตตาล็อกสินค้าของธุรกิจนั้น
  3. ค้นหาแค็ตตาล็อกสินค้าแต่ละรายการที่มีสิทธิ์แท็ก
  4. สร้างคอนเทนเนอร์สื่อที่แท็ก
  5. เผยแพร่คอนเทนเนอร์สื่อที่แท็ก

ข้อจำกัด

  • ข้อจำกัดในการเผยแพร่เนื้อหาทั้งหมดจะมีผลกับการแท็กสินค้า
  • ระบบไม่รองรับการแท็กสินค้าในสตอรี่และ Live
  • ระบบไม่รองรับการแท็กสินค้าในบัญชีครีเอเตอร์บน Instagram
  • บัญชีสามารถมีโพสต์สื่อที่แท็กได้ไม่เกิน 25 รายการภายในระยะเวลา 24 ชั่วโมง อัลบั้มภาพสไลด์ต่างๆ จะนับรวมเป็นโพสต์เดียว

ข้อกำหนด

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

ตำแหน่งข้อมูล

  • GET /{ig-user-id} - ตรวจสอบสิทธิ์ในการแท็กของผู้ใช้แอพ
  • GET /{ig-user-id}/available_catalogs - เรียกดูรายการแค็ตตาล็อกสินค้าของผู้ใช้แอพ
  • GET /{ig-user-id}/catalog_product_search - เรียกดูรายการแท็กสินค้าที่มีสิทธิ์ในแค็ตตาล็อกของผู้ใช้แอพ
  • POST /{ig-user-id}/media - สร้างคอนเทนเนอร์สื่อที่แท็ก (ขั้นตอนที่ 1 ของกระบวนการเผยแพร่)
  • POST /{ig-user-id}/media_publish - เผยแพร่คอนเทนเนอร์สื่อที่แท็ก (ขั้นตอนที่ 2 ของกระบวนการเผยแพร่)
  • GET /{ig-media-id}/product_tags - เรียกดูแท็กในสื่อบน Instagram ที่เผยแพร่
  • DELETE /{ig-media-id}/product_tags - ลบแท็กในสื่อบน Instagram ที่เผยแพร่
  • POST /{ig-media-id}/product_tags - สร้างหรืออัพเดตแท็กในสื่อบน Instagram ที่เผยแพร่
  • GET /{ig-user-id}/product_appeal - เรียกดูข้อมูลการอุทธรณ์สินค้า
  • POST /{ig-user-id}/product_appeal - อุทธรณ์การปฏิเสธสินค้า
  • GET /{ig-media-id}/children - เรียกดูรายการสื่อย่อยบน Instagram ในสื่อบน Instagram ที่เป็นภาพสไลด์

เรียกดูสิทธิ์ของผู้ใช้

ส่งคำขอช่อง shopping_product_tag_eligibility บนตำแหน่งข้อมูลผู้ใช้ Instagram เพื่อตรวจสอบว่าบัญชีธุรกิจบน Instagram ได้ตั้งค่าร้านค้าบน Instagram หรือไม่ ซึ่งบัญชีที่ไม่ได้ตั้งค่าร้านค้าบน Instagram จะไม่มีสิทธิ์แท็กสินค้า

GET /{ig-user-id}?fields=shopping_product_tag_eligibility

ระบบจะส่งคืนค่าเป็น true หากบัญชีธุรกิจบน Instagram เชื่อมโยงกับร้านค้าบน Instagram ที่ได้รับการอนุมัติของตัวจัดการธุรกิจ มิฉะนั้น ระบบจะส่งคืนค่าเป็น false

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ

{
  "shopping_product_tag_eligibility": true,
  "id": "90010177253934"
}

เรียกดูแค็ตตาล็อก

ใช้ตำแหน่งข้อมูลแค็ตตาล็อกที่ใช้งานได้ของผู้ใช้ Instagram เพื่อเรียกดูแค็ตตาล็อกสินค้าของบัญชีธุรกิจบน Instagram

GET /{ig-user-id}/available_catalogs

ระบบส่งคืนอาร์เรย์ของแค็ตตาล็อกและเมตาดาต้าของแค็ตตาล็อกเหล่านั้น ซึ่งการตอบกลับอาจมีช่องข้อมูลแค็ตตาล็อกต่อไปนี้

  • catalog_id - ID แค็ตตาล็อก
  • catalog_name - ชื่อแค็ตตาล็อก
  • shop_name - ชื่อร้านค้า
  • product_count - จำนวนสินค้าทั้งหมดในแค็ตตาล็อก

ข้อจำกัด

ระบบไม่รองรับแค็ตตาล็อกร่วม เช่น แค็ตตาล็อกของพาร์ทเนอร์การช้อปปิ้งหรือแค็ตตาล็อกของครีเอเตอร์แอฟฟิลิเอต

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ

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

เรียกดูสินค้าที่มีสิทธิ์

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

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

GET /{ig-user-id}/catalog_product_search

พารามิเตอร์

  • catalog_id - (ต้องระบุ) ID แค็ตตาล็อก
  • q - สตริงเพื่อค้นหาชื่อสินค้าแต่ละรายการ หรือหมายเลข SKU ของสินค้า (คอลัมน์ ID เนื้อหาในอินเทอร์เฟซการจัดการแค็ตตาล็อก) หากไม่มีการระบุสตริง ระบบจะส่งคืนสินค้าที่มีสิทธิ์แท็กทั้งหมด

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

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

ตัวอย่างคำขอ

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

สร้างคอนเทนเนอร์ที่แท็กสำหรับรูปภาพหรือวิดีโอ

ใช้ตำแหน่งข้อมูลสื่อของผู้ใช้ Instagram เพื่อสร้างคอนเทนเนอร์สื่อสำหรับรูปภาพหรือวิดีโอ หรือดูที่สร้างคอนเทนเนอร์สื่อที่แท็กสำหรับ Reels หรือภาพสไลด์

POST /{ig-user-id}/media

พารามิเตอร์

  • image_url — (จำเป็นต้องระบุสำหรับรูปภาพเท่านั้น) พาธไปยังรูปภาพ รูปภาพของคุณต้องอยู่บนเซิร์ฟเวอร์สาธารณะ
  • user_tags - (รูปภาพเท่านั้น) อาร์เรย์ของชื่อผู้ใช้สาธารณะและพิกัด x/y สำหรับผู้ใช้ Instagram สาธารณะที่คุณต้องการแท็กในรูปภาพ โดยอาร์เรย์จะต้องอยู่ในรูปแบบ JSON และมีพร็อพเพอร์ตี้ username, x และ y ตัวอย่างเช่น [{username:'natgeo',x:0.5,y:1.0}] ค่า x และ y ต้องเป็นเลขทศนิยม ซึ่งมาจากด้านซ้ายบนของรูปภาพ โดยอยู่ในช่วงระหว่าง 0.0-1.0 ผู้ใช้ที่ถูกแท็กจะได้รับการแจ้งเตือนเมื่อมีการเผยแพร่สื่อ
  • video_url — (จำเป็นต้องระบุสำหรับวิดีโอเท่านั้น) พาธไปยังวิดีโอ วิดีโอของคุณต้องอยู่บนเซิร์ฟเวอร์สาธารณะ
  • thumb_offset - (วิดีโอเท่านั้น) ตำแหน่งของเฟรม (มีหน่วยเป็นมิลลิวินาที) สำหรับภาพขนาดย่อของหน้าปกวิดีโอ โดยจะมีค่าเริ่มต้นเป็น 0 ซึ่งก็คือเฟรมแรกของวิดีโอ
  • product_tags — (จำเป็นต้องระบุ) อาร์เรย์ของอ็อบเจ็กต์ที่ระบุแท็กสินค้าที่จะเพิ่มลงในรูปภาพหรือวิดีโอ คุณสามารถระบุได้สูงสุด 20 แท็กสำหรับโพสต์ฟีดรูปภาพและวิดีโอ และระบุได้สูงสุดรวม 20 แท็กต่อโพสต์แบบภาพสไลด์ (สูงสุด 5 แท็กต่อภาพสไลด์)
    • แท็กและ ID สินค้าต้องไม่ซ้ำกัน
    • ระบบรองรับแท็กสำหรับสินค้าที่หมดสต็อก
    • โดยอ็อบเจ็กต์แต่ละรายการควรมีข้อมูลต่อไปนี้
      • product_id - (จำเป็นต้องระบุ) ID สินค้า
      • x - (รูปภาพเท่านั้น) ตัวเลขทศนิยมที่ระบุระยะห่างเป็นเปอร์เซ็นต์จากขอบด้านซ้ายของรูปภาพสื่อที่เผยแพร่ โดยที่ค่าจะต้องอยู่ในช่วง 0.0 – 1.0
    • y - (รูปภาพเท่านั้น) ตัวเลขทศนิยมที่ระบุระยะห่างเป็นเปอร์เซ็นต์จากขอบด้านบนของรูปภาพสื่อที่เผยแพร่ โดยที่ค่าจะต้องอยู่ในช่วง 0.0 – 1.0

หากดำเนินการสำเร็จ API จะส่งคืน ID คอนเทนเนอร์ ซึ่งคุณสามารถนำไปใช้เพื่อเผยแพร่คอนเทนเนอร์ได้

ตัวอย่างคำขอ

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/media?image_url=https%3A%2F%2Fupl...&location_id=7640348500&product_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3231775643511089'%2C%0A%20%20%20%20x%3A%200.5%2C%0A%20%20%20%20y%3A%200.8%0A%20%20%7D%0A%5D&access_token=EAAOc..."

เนื้อหาต่อไปนี้คือสตริงเพย์โหลด POST ที่ถอดรหัสด้วย HTML สำหรับใช้ในการอ้างอิง

https://graph.facebook.com/v12.0/90010177253934/media?image_url=https://upl...&location_id=7640348500 &product_tags=[ { product_id:'3231775643511089', x: 0.5, y: 0.8 } ]&access_token=EAAOc...

ตัวอย่างการตอบกลับ

{
  "id": "17969578066508312"
}

สร้างคอนเทนเนอร์ที่แท็กสำหรับ Reels

ใช้ตำแหน่งข้อมูลสื่อของผู้ใช้ Instagram เพื่อสร้างคอนเทนเนอร์สื่อสำหรับ Reels หรือดูที่สร้างคอนเทนเนอร์สื่อที่แท็กหรือภาพสไลด์

POST /{ig-user-id}/media

พารามิเตอร์

  • media_type — คุณต้องระบุประเภทสื่อ REELS
  • video_url — พาธไปยังวิดีโอสำหรับ Reels วิดีโอของคุณต้องอยู่บนเซิร์ฟเวอร์สาธารณะ วิดีโอของคุณต้องเป็นไปตามข้อมูลจำเพาะสำหรับ Reels
  • thumb_offset - ตำแหน่งของเฟรม (มีหน่วยเป็นมิลลิวินาที) สำหรับใช้เป็นภาพขนาดย่อของหน้าปกวิดีโอ โดยจะมีค่าเริ่มต้นเป็น 0 ซึ่งก็คือเฟรมแรกของวิดีโอ
  • caption — คำบรรยายสำหรับ Reels
  • product_tags — (จำเป็นต้องระบุ) อาร์เรย์ของอ็อบเจ็กต์ที่ระบุแท็กสินค้าที่จะเพิ่มลงใน Reels คุณสามารถระบุได้ถึง 30 แท็ก ทั้งนี้แท็กและ ID สินค้าต้องไม่ซ้ำกัน ระบบรองรับแท็กสำหรับสินค้าที่หมดสต็อก โดยอ็อบเจ็กต์แต่ละรายการควรมีข้อมูลต่อไปนี้
    • product_id - (จำเป็นต้องระบุ) ID สินค้า
  • location_id - ID ของเพจที่เชี่ยมโยงกับตำแหน่งที่คุณต้องการใช้แท็กวิดีโอ โปรดดูรายละเอียดที่พารามิเตอร์สตริงการสืบค้นสื่อของผู้ใช้ Instagram
  • share_to_feed — true เพื่อส่งคำขอให้วิดีโอปรากฏทั้งบนแท็บฟีดและ Reels false เพื่อส่งคำขอให้วิดีโอปรากฏบนแท็บ Reels เท่านั้น
  • access_token — โทเค็นการเข้าถึงผู้ใช้ของคุณ

หากดำเนินการสำเร็จ API จะส่งคืน ID คอนเทนเนอร์ ซึ่งคุณสามารถนำไปใช้เพื่อเผยแพร่คอนเทนเนอร์ได้

ตัวอย่างคำขอ

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/media?media_type=REELS&video_url=https://upl...&product_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3231775643511089'%0A%20%20%7D%0A%5D&access_token=EAAOc..."

เนื้อหาต่อไปนี้คือสตริงเพย์โหลด POST ที่ถอดรหัสด้วย HTML สำหรับใช้ในการอ้างอิง

https://graph.facebook.com/v12.0/90010177253934/media?media_type=REELS&video_url=https://upl... &product_tags=[ { product_id:'3231775643511089' } ]&access_token=EAAOc...

ตัวอย่างการตอบกลับ

{
  "id": "17969578066508312"
}

เผยแพร่คอนเทนเนอร์สื่อที่แท็ก

ใช้ตำแหน่งข้อมูลการเผยแพร่สื่อของผู้ใช้ Instagram เพื่อเผยแพร่คอนเทนเนอร์สื่อที่แท็ก โดยคุณสามารถเผยแพร่คอนเทนเนอร์สื่อที่แท็กในนามของผู้ใช้แอพได้มากถึง 25 รายการภายในระยะเวลา 24 ชั่วโมง หากคุณต้องการเผยแพร่ภาพสไลด์ โปรดดูภาพสไลด์ มีเพียงสินค้าที่มี review_status เป็น approved เท่านั้นที่จะปรากฏบนโพสต์ที่เผยแพร่ หากสินค้าใดในกลุ่มนี้หมดสต็อก แท็กสำหรับสินค้าดังกล่าวจะยังคงปรากฏบนโพสต์ที่เผยแพร่

POST /{ig-user-id}/media_publish

พารามิเตอร์

  • creation_id - (ต้องระบุ) ID คอนเทนเนอร์ภาพสไลด์

หากการดำเนินการสำเร็จ API จะส่งคืน ID สื่อบน IG

ตัวอย่างคำขอ

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010177253934/media_publish?creation_id=17969578066508312&access_token=EAAOc"

ตัวอย่างการตอบกลับ

{
  "id": "90010778325754"
}

เรียกดูแท็กในสื่อ

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

GET /{ig-media-id}/product_tags

ระบบส่งคืนอาร์เรย์ของแท็กสินค้าและเมตาดาต้าของแท็กนั้นๆ ในสื่อบน Instagram ซึ่งการตอบกลับอาจมีช่องในแท็กสินค้าต่อไปนี้

  • product_id - ID สินค้า
  • merchant_id - ID ผู้ขาย
  • name - ชื่อสินค้า
  • price_string - ราคาสินค้า
  • image_url - URL ของรูปภาพสินค้า
  • review_status - บ่งบอกสถานะการมีสิทธิ์แท็กผลิตภัณฑ์ ซึ่งอาจมีค่าเป็น:
  • approved - สินค้าได้รับอนุมัติ
  • rejected - สินค้าถูกการปฏิเสธ
  • pending - ยังอยู่ในระหว่างการตรวจสอบ
  • outdated - สินค้าได้รับการอนุมัติแล้ว แต่มีการแก้ไขสินค้าและต้องได้รับการอนุมัติใหม่
  • "" - ไม่มีสถานะการตรวจสอบ
  • no_review - ไม่มีสถานะการตรวจสอบ
  • is_checkout - หากเป็น true จะสามารถซื้อสินค้าได้โดยตรงผ่านแอพ Instagram แต่หากเป็น false จะสามารถซื้อสินค้าได้บนเว็บไซต์ของผู้ขายเท่านั้น
  • stripped_price_string - สตริงราคาสินค้าแบบย่อ (ราคาที่แสดงในพื้นที่จำกัด เช่น $100 แทนที่จะเป็น 100 USD)
  • string_sale_price_string - ราคาขายสินค้า
  • x - ตัวเลขทศนิยมที่ระบุระยะห่างเป็นเปอร์เซ็นต์จากขอบด้านซ้ายของรูปภาพสื่อ โดยที่ค่าจะอยู่ในช่วง 0.0-1.0
  • y - ตัวเลขทศนิยมที่ระบุระยะห่างเป็นเปอร์เซ็นต์จากขอบด้านบนของรูปภาพสื่อ โดยที่ค่าจะอยู่ในช่วง 0.0-1.0

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ

{
  "data": [
    {
      "product_id": 3231775643511089,
      "merchant_id": 90010177253934,
      "name": "Gummy Wombats",
      "price_string": "$3.50",
      "image_url": "https://scont...",
      "review_status": "approved",
      "is_checkout": true,
      "stripped_price_string": "$3.50",
      "x": 0.5,
      "y": 0.80000001192093
    }
  ]
}

แท็กสื่อที่มีอยู่

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

POST /{ig-media-id}/product_tags

พารามิเตอร์

  • updated_tags - (ต้องระบุ) อาร์เรย์ของอ็อบเจ็กต์ที่ระบุว่าจะใช้แท็กผลิตภัณฑ์ใดแท็กรูปภาพหรือวิดีโอ (สูงสุด 5 แท็ก โดยที่แท็กและ ID สินค้าต้องไม่ซ้ำกัน) โดยอ็อบเจ็กต์แต่ละรายการควรมีข้อมูลต่อไปนี้
  • product_id - (จำเป็นต้องระบุ) ID สินค้า หากไม่มีการแท็ก ID นี้ลงบนสื่อบน IG ระบบจะเพิ่มแท็กลงบนสื่อนั้น แต่หากสื่อดังกล่าวถูกแท็กด้วย ID นี้แล้ว พิกัดการแสดงผลของแท็กจะได้รับการอัพเดต
  • x - (รูปภาพเท่านั้น และต้องระบุ) ตัวเลขทศนิยมที่ระบุระยะห่างเป็นเปอร์เซ็นต์จากขอบด้านซ้ายของรูปภาพสื่อที่เผยแพร่ โดยที่ค่าจะต้องอยู่ในช่วง 0.0 – 1.0
  • y - (รูปภาพเท่านั้น และต้องระบุ) ตัวเลขทศนิยมที่ระบุระยะห่างเป็นเปอร์เซ็นต์จากขอบด้านบนของรูปภาพสื่อที่เผยแพร่ โดยที่ค่าจะต้องอยู่ในช่วง 0.0 – 1.0

คุณสามารถแท็กสื่อเพิ่มได้เรื่อยๆ จนกว่าจะครบ 5 แท็ก หากสินค้าในคำขอมีการแท็กสื่อเป้าหมายอยู่แล้ว ค่า x และ y ของแท็กเก่าจะได้รับการอัพเดตด้วยค่าใหม่ของแท็กนั้น (โดยจะไม่มีการเพิ่มแท็กใหม่)

หากสามารถอัพเดตสินค้าได้ ระบบจะส่งคืนค่าเป็น true หากไม่ได้ จะส่งคืนค่าเป็น false

ตัวอย่างคำขอ

curl -i -X POST \
 "https://graph.facebook.com/v19.0/90010778325754/product_tags?updated_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20x%3A%200.5%2C%0A%20%20%20%20y%3A%200.8%0A%20%20%7D%0A%5D&access_token=EAAOc..."

เนื้อหาต่อไปนี้คือสตริงเพย์โหลด POST ที่ถอดรหัสด้วย HTML สำหรับใช้ในการอ้างอิง

https://graph.facebook.com/v12.0/90010778325754/product_tags?updated_tags=[ { product_id:'3859448974125379', x: 0.5, y: 0.8 } ]&access_token=EAAOc...

ตัวอย่างการตอบกลับ

{
  "success": true
}

ลบแท็ก

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

DELETE /{ig-media-id}/product_tags

พารามิเตอร์

  • deleted_tags - (ต้องระบุ) อาร์เรย์ที่มีข้อมูลต่อไปนี้สำหรับแท็กสินค้าแต่ละแท็กที่จะทำการลบ ดังนี้
  • merchant_id - (ต้องระบุ) ID ผู้ขาย
  • product_id - (จำเป็นต้องระบุ) ID สินค้า

หากลบแท็กสำเร็จ ระบบจะส่งคืนค่าเป็น true หากไม่สำเร็จ จะส่งคืนค่าเป็น false

ตัวอย่างคำขอ

curl -i -X DELETE \
 "https://graph.facebook.com/v19.0/90010778325754/product_tags?deleted_tags=%5B%0A%20%20%7B%0A%20%20%20%20product_id%3A'3859448974125379'%2C%0A%20%20%20%20merchant_id%3A'90010177253934'%0A%20%20%7D%0A%5D&access_token=EAAOc..."

เนื้อหาต่อไปนี้คือสตริงเพย์โหลด POST ที่ถอดรหัสด้วย HTML สำหรับใช้ในการอ้างอิง

https://graph.facebook.com/v12.0/90010778325754/product_tags?deleted_tags=[ { product_id:'3859448974125379', merchant_id:'90010177253934' } ]&access_token=EAAOc...

ตัวอย่างการตอบกลับ

{
  "success": true
}

อุทธรณ์การปฏิเสธสินค้า

ใช้ตำแหน่งข้อมูลการอุทธรณ์สินค้าของผู้ใช้ Instagram หากคุณต้องการให้ผู้ใช้แอพของคุณมีช่องทางในการอุทธรณ์การปฏิเสธสินค้า (แท็กของสินค้าที่ถูกปฏิเสธจะไม่ปรากฏบนโพสต์ที่เผยแพร่) แม้ไม่ใช่การดำเนินการที่จำเป็น แต่เราขอแนะนำให้คุณจัดเตรียมช่องทางในการอุทธรณ์การปฏิเสธไว้ให้ผู้ใช้แอพ หรือแนะนำผู้ใช้แอพให้อุทธรณ์การปฏิเสธโดยใช้ตัวจัดการธุรกิจ

POST /{ig-user-id}/product_appeal

พารามิเตอร์

  • appeal_reason - (ต้องระบุ) คำอธิบายว่าเหตุใดสินค้าจึงควรได้รับการอนุมัติ
  • product_id - (จำเป็นต้องระบุ) ID สินค้า

หากเรารับคำขอของคุณได้ ระบบจะส่งคืนค่าเป็น true หากไม่ได้ จะส่งคืนค่าเป็น false ซึ่งการตอบกลับไม่ได้เป็นการบ่งบอกผลของการอุทธรณ์แต่อย่างใด

ตัวอย่างคำขอ

curl -i -X POST \

"https://graph.facebook.com/v19.0/90010177253934/product_appeal?appeal_reason=product%20is%20a%20toy%20and%20not%20a%20real%20weapon&product_id=4382881195057752&access_token=EAAOc..."

ตัวอย่างการตอบกลับ

{
  "success": true
}

เรียกดูสถานะของการอุทธรณ์

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

GET /{ig-user-id}/product_appeal

พารามิเตอร์

  • product_id - (จำเป็นต้องระบุ) ID สินค้า

ส่งคืนเมตาดาต้าสถานะของการอุทธรณ์ ซึ่งการตอบกลับอาจมีช่องในการอุทธรณ์ต่อไปนี้

  • eligible_for_appeal - บ่งบอกว่าสามารถอุทธรณ์คำตัดสินได้หรือไม่ (อุทธรณ์ได้หากเป็น true และอุทธรณ์ไม่ได้หากเป็น false)
  • product_id - ID สินค้า
  • review_status - สถานะการตรวจสอบ ซึ่งอาจมีค่าดังนี้
  • approved - สินค้าได้รับอนุมัติ
  • rejected - สินค้าถูกการปฏิเสธ
  • pending - ยังอยู่ในระหว่างการตรวจสอบ
  • outdated - สินค้าได้รับการอนุมัติแล้ว แต่มีการแก้ไขสินค้าและต้องได้รับการอนุมัติใหม่
  • "" - ไม่มีสถานะการตรวจสอบ
  • no_review - ไม่มีสถานะการตรวจสอบ

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ

{
  "data": [
    {
      "product_id": 4029274203846188,
      "review_status": "approved",
      "eligible_for_appeal": false
    }
  ]
}

ภาพสไลด์

คุณสามารถเผยแพร่ภาพสไลด์ (อัลบั้ม) ที่มีรูปภาพ วิดีโอ หรือทั้งสองอย่างรวมกันที่ถูกแท็กได้ไม่เกิน 10 รายการ หากต้องการเผยแพร่ภาพสไลด์ดังกล่าว เมื่อดำเนินการในขั้นตอนที่ 1 จาก 3 ของกระบวนการเผยแพร่โพสต์แบบภาพสไลด์ เพียงสร้างคอนเทนเนอร์สื่อที่แท็กสำหรับรูปภาพหรือวิดีโอแต่ละรายการที่แท็กตามที่คุณต้องการให้ปรากฏในภาพสไลด์ที่เป็นอัลบั้ม แล้วดำเนินการในกระบวนการเผยแพร่ภาพสไลด์ต่อตามปกติ

เรียกดูสื่อรองในภาพสไลด์

หากต้องการเรียกดู ID ของสื่อบน Instagram ในภาพสไลด์ที่เป็นอัลบั้ม ให้ใช้ตำแหน่งข้อมูลสื่อรองบน Instagram