แพลตฟอร์ม Instagram

บันทึกการเปลี่ยนแปลง

บันทึกการเปลี่ยนแปลงนี้กล่าวถึงการเปลี่ยนแปลงที่เกิดขึ้นกับ API กราฟของ Instagram

บันทึกการเปลี่ยนแปลงที่เกี่ยวข้อง

12 กันยายน 2023

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

9 พฤศจิกายน 2022

Webhooks สำหรับ Instagram

มีผลกับทุกเวอร์ชั่น

ระบบจะส่งคืน ad_id และ ad_title ในอ็อบเจ็กต์ media ของอ็อบเจ็กต์ value ของช่อง comments เมื่อมีคนแสดงความคิดเห็นบนโพสต์บน Instagram หรือโพสต์โฆษณาบน Instagram ที่มีการโปรโมท

31 ตุลาคม

Reels – แท็กสินค้า

มีผลกับทุกเวอร์ชั่น

API การแท็กสินค้าบน Instagram สำหรับ Reels พร้อมให้ใช้งานแล้ว โดยคุณสามารถแท็กสินค้าได้สูงสุด 30 รายการเมื่อเผยแพร่ Reels

28 มิถุนายน 2022

คลิป Reels

มีผลกับทุกเวอร์ชั่น

ระบบรองรับ Reels แล้วในขณะนี้ หากต้องการเผยแพร่วิดีโอเป็นคลิป Reels ให้กำหนดพารามิเตอร์ media_type เป็น REELS เมื่อสร้างคอนเทนเนอร์โพสต์ที่มีสื่อรายการเดียว โปรดดูเอกสารอ้างอิง POST /ig-user/media endpoint เพื่อเรียนรู้ว่าพารามิเตอร์ใดบ้างที่สามารถใช้ได้กับคลิป Reels และข้อกำหนดสำหรับวิดีโอที่เป็นคลิป Reels

27 มิถุนายน 2022

เอกสารประกอบเกี่ยวกับ Instagram API แบบเดิม

มีผลกับทุกเวอร์ชั่น

เราได้ลบเอกสารประกอบสำหรับผู้พัฒนาเกี่ยวกับ Instagram API แบบเดิมออกแล้ว และตอนนี้ระบบจะเปลี่ยนเส้นทางไปยังเอกสารประกอบสำหรับผู้พัฒนาเกี่ยวกับแพลตฟอร์ม Instagram แทน

20 มิถุนายน 2022

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

มีผลกับทุกเวอร์ชั่น

คุณสามารถสร้างและจัดการแท็กสินค้า Instagram Shopping ในสื่อที่เผยแพร่ของ Instagram Business ได้แล้วตอนนี้ เรียนรู้วิธีในคู่มือการแท็กสินค้า

27 พฤษภาคม 2022

แบบสินค้า

มีผลกับทุกเวอร์ชั่น

สำหรับพาร์ทเนอร์ในเบต้าการแท็กสินค้า ตอนนี้ระบบจะส่งคืนแบบสินค้าทั้งหมดที่ตรงกับเกณฑ์การค้นหาของการสืบค้นเมื่อค้นหาสินค้าในแค็ตตาล็อก

15 มีนาคม 2022

โพสต์ภาพสไลด์

ใช้ได้กับทุกเวอร์ชั่น

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

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

9 พฤศจิกายน 2021

วิดีโอถ่ายทอดสด

มีผลกับทุกเวอร์ชั่น

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

  • จุดเชื่อมโยง GET /ig-user/live_media เวอร์ชั่นใหม่สามารถส่งคืนสื่อบน IG ที่เป็นวิดีโอถ่ายทอดสดที่กำลังแพร่ภาพโดยผู้ใช้แอพของคุณในตอนที่ส่งคำขอได้
  • ในตอนนี้ช่อง media ในความคิดเห็นบน IG จะส่งคืนอ็อบเจ็กต์ที่มีทั้ง ID (id) และตำแหน่งที่เผยแพร่ (media_product_type) ของสื่อในตอนที่สร้างความคิดเห็น
  • ช่อง Webhooks ของ Instagram live_comments เวอร์ชั่นใหม่สามารถส่งการแจ้งเตือนที่ประกอบด้วยความคิดเห็นแบบสดในวิดีโอถ่ายทอดสดของผู้ใช้แอพของคุณในขณะที่กำลังแพร่ภาพได้

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

20 ตุลาคม 2021

ความคิดเห็นบน IG

มีผลกับทุกเวอร์ชั่น

เราได้เพิ่ม 2 ช่องใหม่ในความคิดเห็นบน IG:

  • from — ส่งคืนอ็อบเจ็กต์ซึ่งประกอบด้วย IGSID (id) และชื่อผู้ใช้ (username) ของผู้ที่แสดงความคิดเห็นนั้น
  • parent_id — ส่งคืน ID ของความคิดเห็นหลักบน IG ในกรณีที่ความคิดเห็นนี้อยู่ในอีกความคิดเห็นหนึ่งบน IG (กล่าวคือ เป็นการตอบกลับความคิดเห็นอีกทีหนึ่ง)

Webhooks สำหรับ Instagram

มีผลกับทุกเวอร์ชั่น

ในตอนนี้ ช่องcomments ของ Webhooks สำหรับ Instagram จะมีคุณสมบัติดังต่อไปนี้ในอ็อบเจ็กต์ช่อง value:

  • from.id — IGSID ของผู้ใช้ Instagram ที่แสดงความคิดเห็นนั้นๆ
  • from.username — ชื่อผู้ใช้ของผู้ใช้ Instagram ที่แสดงความคิดเห็นนั้นๆ
  • media.id — ID ของสื่อบน IG ที่มีการแสดงความคิดเห็นนั้นๆ
  • media.media_product_type — แพลตฟอร์ม (ตำแหน่งที่เผยแพร่) ของสื่อบน IG ที่มีการแสดงความคิดเห็นนั้นๆ
  • parent_id — ID ของความคิดเห็นหลักบน IG ในกรณีที่ความคิดเห็นนี้อยู่ในอีกความคิดเห็นหนึ่งบน IG (กล่าวคือ เป็นการตอบกลับความคิดเห็นอีกทีหนึ่ง)

5 ตุลาคม 2021

การเปลี่ยนแปลงต่อไปนี้จะมีผลกับวิดีโอ Instagram TV ที่สร้างในหรือหลังวันที่ 5 ตุลาคม 2021 วิดีโอ Instagram TV ที่สร้างก่อนวันที่ดังกล่าวจะได้รับการยกเว้นจากการเปลี่ยนแปลงเหล่านี้

  • ช่อง media_product_type จะส่งคืน FEED แทนที่จะเป็น IGTV
  • จะไม่มีการส่งคืนช่อง video_title
  • ระบบรองรับช่อง comments และ mentions ของ Instagram Webhooks แล้วในตอนนี้

ในวันที่ 3 มกราคม 2022 การเปลี่ยนแปลงข้างต้นจะมีผลกับ API ทุกเวอร์ชั่นและวิดีโอ Instagram TV ทั้งหมด ไม่ว่าจะสร้างวิดีโอขึ้นเมื่อไรก็ตาม ซึ่งหมายความว่าตั้งแต่วันที่ 3 มกราคม 2022 เป็นต้นไป แอพที่ใช้ API เวอร์ชั่นเก่าจะสามารถสืบค้นวิดีโอ Instagram TV ได้ (การรองรับการอ่านได้เปิดตัวใน เวอร์ชั่น 10.0 และจำกัดการใช้งานเฉพาะ เวอร์ชั่น 10.0 ขึ้นไป)

ตั้งแต่เวอร์ชั่น 14.0 เป็นต้นไป ระบบจะไม่รองรับช่อง video_title และ API จะแสดงข้อผิดพลาดหากมีการขอช่องดังกล่าว

8 มิถุนายน 2021

จำนวนการกดถูกใจ

มีผลกับเวอร์ชั่น 11.0 ขึ้นไป จะมีผลกับทุกเวอร์ชั่นในวันที่ 7 กันยายน 2021

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


การแบ่งหน้าโดยอิงจากเวลา

มีผลกับเวอร์ชั่น 11.0 ขึ้นไป

พารามิเตอร์ since และ until ที่เพิ่มในตำแหน่งข้อมูล GET /{ig-user-id}/media เพื่อรองรับการแบ่งหน้าโดยอิงจากเวลา

26 พฤษภาคม 2021

หากสืบค้นสื่อบน IG ทางอ้อมผ่านตำแหน่งข้อมูลอื่น ช่อง like_count จะส่งคืน 0 ในขณะนี้ หากผู้ใช้แอพไม่ได้เป็นเจ้าของสื่อและเจ้าของสื่อได้ซ่อนจำนวนการกดถูกใจของสื่อ ส่วนการสืบค้นสื่อบน IG โดยตรงซึ่งเจ้าของสื่อบน IG เท่านั้นที่ทำได้จะส่งคืนจำนวนการกดถูกใจจริง แม้ว่าเจ้าของจะซ่อนจำนวนการกดถูกใจของสื่อก็ตาม

4 พฤษภาคม 2021

วิธีที่เราคำนวณเกณฑ์ชี้วัด online_followers ของผู้ใช้ IG มีการเปลี่ยนแปลงไปเล็กน้อย

14 เมษายน 2021

ระบบจะไม่รวมการโต้ตอบกับสื่อบน IG ที่เป็นสตอรี่โดยผู้ใช้ในประเทศญี่ปุ่นในการคำนวณเกณฑ์ชี้วัด replies บางรายการอีกต่อไป:

  • สำหรับสตอรี่ที่ผู้ใช้ในประเทศญี่ปุ่นสร้างขึ้น เกณฑ์ชี้วัด replies จะคืนค่ากลับมาเป็น 0 แล้วในตอนนี้
  • สำหรับสตอรี่ที่ผู้ใช้นอกประเทศญี่ปุ่นสร้างขึ้น เกณฑ์ชี้วัด replies จะยังคืนค่าจำนวนการตอบกลับอยู่ แต่ระบบจะไม่รวมการตอบกลับของผู้ใช้ในประเทศญี่ปุ่นในการคำนวณด้วย

12 เมษายน 2021

แก้ไขจุดบกพร่องเล็กน้อยในเกณฑ์ชี้วัดการเข้าถึงสำหรับสื่อบน Instagram ในสตอรี่

9 เมษายน 2021

16 มีนาคม 2021

สื่อบน Instagram TV มีการรองรับในเวอร์ชั่น 10.0 ขึ้นไปแล้ว โดยจะมีผลกับตำแหน่งข้อมูลทั้งหมดยกเว้นตำแหน่งข้อมูลที่ใช้สำหรับเผยแพร่เนื้อหาและ Webhooks เพื่อสนับสนุนการเปลี่ยนแปลงนี้ จึงมีการเพิ่มช่อง media_product_type และ video_title ใหม่ในโหนดสื่อบน Instagram สื่อบน Instagram TV จะต้องแชร์ไปยัง Instagram ในตอนที่เผยแพร่ (โดยเปิดใช้งานโพสต์พรีวิวหรือแชร์พรีวิวไปยังฟีด) เพื่อให้เข้าถึงผ่าน API ได้

26 มกราคม 2021

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

2 ธันวาคม 2020

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

  • สำหรับสตอรี่ที่ผู้ใช้ใน EEA สร้างขึ้น ขณะนี้เกณฑ์ชี้วัด replies จะส่งคืนค่าเป็น 0
  • สำหรับสตอรี่ที่ผู้ใช้นอก EEA สร้างขึ้น เกณฑ์ชี้วัด replies จะส่งคืนค่าเป็นจำนวนการตอบกลับ แต่การตอบกลับจากผู้ใช้ใน EEA จะไม่รวมอยู่ในการคำนวณนี้

การเปลี่ยนแปลงนี้มีผลกับทุกเวอร์ชั่น

10 พฤศจิกายน 2020

  • ข้อมูลเชิงลึกของผู้ใช้ Instagram - ในตอนนี้ ค่า follower_count จะใกล้เคียงกับค่าที่สอดคล้องกันซึ่งปรากฏในแอพ Instagram มากยิ่งขึ้น นอกจากนั้น ขณะนี้ follower_count จะส่งคืนข้อมูลได้สูงสุด 30 วัน แทนที่จะเป็น 2 ปี การเปลี่ยนแปลงนี้มีผลกับเวอร์ชั่น 9.0 ขึ้นไปและจะมีผลกับทุกเวอร์ชั่นในวันที่ 9 พฤษภาคม 2021

5 พฤษภาคม 2020

3 ธันวาคม 2019

  • ข้อมูลเชิงลึก - เพื่อปรับลักษณะการทำงานของ API ให้สอดคล้องกับลักษณะการทำงานของแอพ Instagram ขณะนี้ข้อมูลเชิงลึกเกี่ยวกับผู้ใช้ Instagram จะพร้อมใช้งานเฉพาะสำหรับผู้ใช้ Instagram ที่มีผู้ติดตามตั้งแต่ 100 คนขึ้นไป

13 สิงหาคม 2019

  • การค้นพบธุรกิจ - สามารถใช้ API การค้นพบธุรกิจเพื่อรับข้อมูลเกี่ยวกับบัญชีครีเอเตอร์บน Instagram อื่นๆ ได้แล้ว

22 พฤษภาคม 2019

9 พฤษภาคม 2019

  • Webhooks - ขณะนี้ ช่อง story_insights กำหนดให้ต้องมีสิทธิ์การอนุญาต instagram_manage_insights แทน instagram_manage_comments

31 ตุลาคม 2018

  • API การค้นหาแฮชแท็ก - ขณะนี้ คุณสามารถค้นหาสื่อที่มีการติดแฮชแท็กแบบเฉพาะเจาะจงได้โดยใช้ API การค้นหาแฮชแท็กแบบใหม่ของเรา #spooky!

23 ตุลาคม 2018

  • จุดเชื่อมโยง /{ig-media-id}/comments - การส่งคำขอ GET โดยใช้ API เวอร์ชั่น 3.1 หรือเก่ากว่านั้นจะได้รับผลลัพธ์กลับมาแบบเรียงตามลำดับเวลา ส่วนการส่งคำขอโดยใช้เวอร์ชั่น 3.2 ขึ้นไปจะได้รับผลลัพธ์ที่เรียงตามลำดับเวลาแบบย้อนกลับ

7 มิถุนายน 2018

  • โหนด /{ig-media-id} - คุณสามารถใช้การขยายเงื่อนไขในช่องเพื่อใช้ช่อง permalink ในอ็อบเจ็กต์สื่อได้แล้ว

1 พฤษภาคม 2018

  • การตรวจสอบยืนยันธุรกิจ - หากต้องการใช้ API กราฟของ Instagram ทุกแอพจะต้องผ่านการตรวจสอบยืนยันธุรกิจ ซึ่งเป็นส่วนหนึ่งของกระบวนการตรวจสอบแอพและจำเป็นสำหรับตำแหน่งข้อมูล API กราฟของ Instagram ทั้งหมดแล้ว แอพที่เคยผ่านการตรวจสอบก่อนวันที่ 1 พฤษภาคม 2018 ต้องได้รับการตรวจสอบอีกครั้ง และมีเวลารับการตรวจสอบจนถึงวันที่ 1 สิงหาคม 2018 มิฉะนั้นจะสูญเสียสิทธิ์การเข้าถึง API ไป

24 เมษายน 2018

  • โหนด /{ig-comment-id}:
    • เพิ่มช่อง username ใหม่
    • เมื่อส่งคำขอ GET ช่อง user จะไม่รวมอยู่ในการตอบกลับ เว้นแต่ว่าผู้ใช้ที่ส่งคำขอจะเป็นเจ้าของความคิดเห็นนั้น โดยเราจะส่งคืน username ของผู้แสดงความคิดเห็นทุกคนแทน แนวทางนี้ยังมีผลกับการสืบค้นความคิดเห็นผ่าน API อื่นๆ เช่น API ของ Mentions อีกด้วย
  • โหนด /{ig-media-id}:
    • เพิ่มช่อง username ใหม่
    • เมื่อส่งคำขอ GET ช่อง owner จะไม่รวมอยู่ในการตอบกลับ เว้นแต่ว่าผู้ใช้ที่ส่งคำขอจะเป็นเจ้าของอ็อบเจ็กต์สื่อนั้น โดยเราจะส่งคืน username ของผู้แสดงความคิดเห็นทุกคนแทน แนวทางนี้ยังมีผลกับการสืบค้นอ็อบเจ็กต์สื่อผ่าน API อื่นๆ เช่น API ของ Mentions อีกด้วย

23 เมษายน 2018

  • API ข้อมูลเชิงลึก - ขณะนี้ ข้อมูลเชิงลึกจะรวมกิจกรรมโฆษณาที่สร้างผ่าน API, อินเทอร์เฟซโฆษณาบน Facebook และฟีเจอร์การโปรโมทของ Instagram ด้วย โดยจะมีผลกับเกณฑ์ชี้วัดดังต่อไปนี้

    • impressions
    • reach

13 มีนาคม 2018

  • API การเผยแพร่เนื้อหา - ขณะนี้ พาร์ทเนอร์เบต้าสามารถใช้จุดเชื่อมโยง /{ig-user-id}/media เพื่อแท็กตำแหน่งที่ตั้งและผู้ใช้ Instagram แบบสาธารณะเมื่อเผยแพร่รูปภาพได้แล้ว

8 มีนาคม 2018

  • ช่องสาธารณะ - ขณะนี้ ช่อง timestamp ในโหนด /{ig-media-id} เป็นช่องสาธารณะแล้ว และสามารถส่งคืนผ่านการขยายเงื่อนไขในช่องได้

22 กุมภาพันธ์ 2018

  • ช่องสาธารณะ - ขณะนี้ โหนด /{ig-user-id}, /{ig-comment-id} และ /{ig-media-id} จะส่งคืนช่องสาธารณะทั้งหมดเมื่อมีการเข้าถึงโดยจุดเชื่อมโยงผ่านการขยายเงื่อนไขในช่อง โปรดดูเอกสารอ้างอิงของโหนดแต่ละรายการเพื่อดูว่าช่องใดบ้างที่เป็นสาธารณะ

8 กุมภาพันธ์ 2018

  • API การเผยแพร่เนื้อหา - ขณะนี้ พาร์ทเนอร์เบต้าสามารถใส่แฮชแท็กเมื่อเผยแพร่รูปภาพผ่านจุดเชื่อมโยง /{ig-user-id}/media ได้แล้ว มาใส่แฮชแท็กแบบ #crazywildebeest กันได้เลย!