บันทึกการเปลี่ยนแปลงนี้อ้างอิงถึงการเปลี่ยนแปลงที่เกิดขึ้นโดย API ของ Instagram
ขั้นตอนของข้อความต้อนรับพร้อมให้ใช้งานแล้วสำหรับ Instagram API ที่มีการเข้าสู่ระบบด้วย Instagram เรียนรู้เพิ่มเติม
Applies to v21.0+. Will apply to all versions on January 8, 2025.
The video media metric video_views
will no longer be supported.
The following endpoints and metrics are affected:
GET /{ig-media-id}/insights
video_views
Applies to v21.0+. Will apply to all versions on January 8, 2025.
The email_contacts
, get_direction_clicks
, profile_views
, text_message_clicks
, website_clicks
, and phone_call_clicks
time series metrics will no longer be supported.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insights
email_contacts
get_direction_clicks
profile_views
text_message_clicks
website_clicks
phone_call_clicks
scope
ใหม่มีผลกับทุกเวอร์ชั่น
เพื่อให้มั่นใจถึงความสอดคล้องกันระหว่างค่า scope
กับชื่อสิทธิ์การอนุญาต เราจึงขอแนะนำค่า scope
ใหม่สำหรับ Instagram API พร้อมด้วยการเข้าสู่ระบบด้วย Instagram ค่า scope
ใหม่ ได้แก่
instagram_business_basic
instagram_business_content_publish
instagram_business_manage_comments
instagram_business_manage_messages
โดยจะแทนที่ค่า business_basic
, business_content_publishing
, business_manage_comments
และ business_manage_messages
ที่มีอยู่ตามลำดับ
โปรดทราบว่าเราจะเลิกใช้งานค่า scope
เก่าในวันที่ 27 มกราคม 2025 คุณจึงจำเป็นต้องอัพเดตโค้ดก่อนวันที่ดังกล่าวเพื่อไม่ให้ฟังก์ชั่นการทำงานของแอพหยุดชะงัก หากไม่อัพเดตโค้ด จะส่งผลให้แอพของคุณไม่สามารถเรียกใช้ตำแหน่งข้อมูลต่างๆ ของ Instagram ได้
การแก้ไข: วันที่เลิกใช้งานเปลี่ยนจาก 17 ธันวาคม 2024 เป็น 27 มกราคม 2025
ส่วนประกอบของ Instagram API ใหม่นี้:
graph.instagram.com
instagram_business_basic
instagram_business_content_publish
instagram_business_manage_comments
instagram_business_manage_messages
มีผลกับทุกเวอร์ชั่น
นอกจาก ad_id
และ ad_title
, แล้ว ระบบจะส่งคืน original_media_id
ในอ็อบเจ็กต์ media
ของอ็อบเจ็กต์ value
ของช่อง comments
เมื่อมีคนแสดงความคิดเห็นบนโพสต์บน Instagram หรือโพสต์โฆษณาบน Instagram ที่ได้รับการโปรโมท โปรดดูข้อมูลเพิ่มเติมที่ตั้งค่า Webhooks สำหรับ Instagram
Applies to v20.0+. Will apply to all versions on August 19, 2024.
The last_14_days
, last_30_days
, last_90_days
and prev_month
timeframes will no longer be supported for the reached_audience_demographics
and engaged_audience_demographics
metrics.
The following endpoints and metrics are affected:
GET /{ig-user-id}/insights
engaged_audience_demographics
reached_audience_demographics
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.
มีผลกับทุกเวอร์ชั่น
ระบบจะส่งคืน ad_id
และ ad_title
ในอ็อบเจ็กต์ media
ของอ็อบเจ็กต์ value
ของช่อง comments
เมื่อมีคนแสดงความคิดเห็นบนโพสต์บน Instagram หรือโพสต์โฆษณาบน Instagram ที่ได้รับการโปรโมท
มีผลกับทุกเวอร์ชั่น
API การแท็กสินค้าบน Instagram สำหรับ Reels พร้อมให้ใช้งานแล้ว โดยคุณสามารถแท็กสินค้าได้สูงสุด 30 รายการเมื่อเผยแพร่ Reels
มีผลกับทุกเวอร์ชั่น
ระบบรองรับ Reels แล้วในขณะนี้ หากต้องการเผยแพร่วิดีโอเป็นคลิป Reels ให้กำหนดพารามิเตอร์ media_type
เป็น REELS
เมื่อสร้างคอนเทนเนอร์โพสต์ที่มีสื่อรายการเดียว โปรดดูเอกสารอ้างอิง POST /ig-user/media endpoint
เพื่อเรียนรู้ว่าพารามิเตอร์ใดบ้างที่สามารถใช้ได้กับคลิป Reels และข้อกำหนดสำหรับวิดีโอที่เป็นคลิป Reels
มีผลกับทุกเวอร์ชั่น
เราได้ลบเอกสารประกอบสำหรับผู้พัฒนาเกี่ยวกับ Instagram API แบบเดิมออกแล้ว และตอนนี้ระบบจะเปลี่ยนเส้นทางไปยังเอกสารประกอบสำหรับผู้พัฒนาเกี่ยวกับแพลตฟอร์ม Instagram แทน
มีผลกับทุกเวอร์ชั่น
คุณสามารถสร้างและจัดการแท็กสินค้า Instagram Shopping ในสื่อที่เผยแพร่ของ Instagram Business ได้แล้วตอนนี้ เรียนรู้วิธีในคู่มือการแท็กสินค้า
มีผลกับทุกเวอร์ชั่น
สำหรับพาร์ทเนอร์ในเบต้าการแท็กสินค้า ตอนนี้ระบบจะส่งคืนแบบสินค้าทั้งหมดที่ตรงกับเกณฑ์การค้นหาของการสืบค้นเมื่อค้นหาสินค้าในแค็ตตาล็อก
ใช้ได้กับทุกเวอร์ชั่น
ในตอนนี้ คุณสามารถใช้ Instagram API เพื่อเผยแพร่โพสต์ที่มีรูปภาพและวิดีโอหลายรายการได้แล้ว (โพสต์ภาพสไลด์) โปรดดูขั้นตอนการเผยแพร่ฉบับสมบูรณ์ในคู่มือการเผยแพร่เนื้อหา
หากแอพของคุณได้รับการอนุมัติสิทธิ์การอนุญาตที่จำเป็นต่อการเผยแพร่เนื้อหามาก่อนแล้ว คุณก็ไม่ต้องนำเนื้อหาเข้าสู่กระบวนการตรวจสอบแอพอีกครั้ง และสามารถใช้ประโยชน์จากฟังก์ชั่นการทำงานนี้ได้เลย
มีผลกับทุกเวอร์ชั่น
ในตอนนี้คุณสามารถใช้ API ของ Instagram เพื่อรับสื่อบน IG ที่เป็นวิดีโอถ่ายทอดสดที่แพร่ภาพโดยผู้ใช้แอพของคุณ รับความคิดเห็นในวิดีโอเหล่านั้น และใช้ API การส่งข้อความบน Instagram เพื่อส่งข้อความตอบกลับแบบส่วนตัว (DM) ไปยังผู้เขียนความคิดเห็นได้ เราได้ทำการเปลี่ยนแปลงต่อไปนี้เพื่อรองรับฟังก์ชั่นการทำงานดังกล่าว
media
ในความคิดเห็นบน IG จะส่งคืนอ็อบเจ็กต์ที่มีทั้ง ID (id
) และตำแหน่งที่เผยแพร่ (media_product_type
) ของสื่อในตอนที่สร้างความคิดเห็นlive_comments
เวอร์ชั่นใหม่สามารถส่งการแจ้งเตือนที่ประกอบด้วยความคิดเห็นแบบสดในวิดีโอถ่ายทอดสดของผู้ใช้แอพของคุณในขณะที่กำลังแพร่ภาพได้โปรดดูเอกสารประกอบเกี่ยวกับข้อความตอบกลับแบบส่วนตัวของ API การส่งข้อความบน Instagram เพื่อดูวิธีการส่งข้อความตอบกลับแบบส่วนตัวไปยังผู้ใช้ที่ได้แสดงความคิดเห็นในสื่อบน IG ที่เป็นวิดีโอถ่ายทอดสดของผู้ใช้แอพของคุณ
มีผลกับทุกเวอร์ชั่น
เราได้เพิ่ม 2 ช่องใหม่ในความคิดเห็นบน IG:
from
— ส่งคืนอ็อบเจ็กต์ซึ่งประกอบด้วย IGSID (id
) และชื่อผู้ใช้ (username
) ของผู้ที่แสดงความคิดเห็นนั้นparent_id
— ส่งคืน ID ของความคิดเห็นหลักบน IG ในกรณีที่ความคิดเห็นนี้อยู่ในอีกความคิดเห็นหนึ่งบน IG (กล่าวคือ เป็นการตอบกลับความคิดเห็นอีกทีหนึ่ง)มีผลกับทุกเวอร์ชั่น
ในตอนนี้ ช่อง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 (กล่าวคือ เป็นการตอบกลับความคิดเห็นอีกทีหนึ่ง)การเปลี่ยนแปลงต่อไปนี้จะมีผลกับวิดีโอ Instagram TV ที่สร้างในหรือหลังวันที่ 5 ตุลาคม 2021 วิดีโอ Instagram TV ที่สร้างก่อนวันที่ดังกล่าวจะได้รับการยกเว้นจากการเปลี่ยนแปลงเหล่านี้
ในวันที่ 3 มกราคม 2022 การเปลี่ยนแปลงข้างต้นจะมีผลกับ API ทุกเวอร์ชั่นและวิดีโอ Instagram TV ทั้งหมด ไม่ว่าจะสร้างวิดีโอขึ้นเมื่อไรก็ตาม ซึ่งหมายความว่าตั้งแต่วันที่ 3 มกราคม 2022 เป็นต้นไป แอพที่ใช้ API เวอร์ชั่นเก่าจะสามารถสืบค้นวิดีโอ Instagram TV ได้ (การรองรับการอ่านได้เปิดตัวใน เวอร์ชั่น 10.0 และจำกัดการใช้งานเฉพาะ เวอร์ชั่น 10.0 ขึ้นไป)
ตั้งแต่เวอร์ชั่น 14.0 เป็นต้นไป ระบบจะไม่รองรับช่อง video_title
และ API จะแสดงข้อผิดพลาดหากมีการขอช่องดังกล่าว
มีผลกับเวอร์ชั่น 11.0 ขึ้นไป จะมีผลกับทุกเวอร์ชั่นในวันที่ 7 กันยายน 2021
หากสืบค้นสื่อบน Instagram ทางอ้อมผ่านตำแหน่งข้อมูลหรือการขยายช่องอื่น like_count
ช่องดังกล่าวจะถูกละเว้นจากการตอบกลับ API หากเจ้าของสื่อได้ซ่อนจำนวนการกดถูกใจไว้ ส่วนการสืบค้นสื่อบน Instagram โดยตรง (ซึ่งเจ้าของสื่อบน Instagram เท่านั้นที่ทำได้) จะส่งคืนจำนวนการกดถูกใจตามจริง แม้ว่าจะมีการซ่อนจำนวนการกดถูกใจก็ตาม
มีผลกับเวอร์ชั่น 11.0 ขึ้นไป
พารามิเตอร์ since
และ until
ที่เพิ่มในตำแหน่งข้อมูล GET /{ig-user-id}/media
เพื่อรองรับการแบ่งหน้าโดยอิงจากเวลา
หากสืบค้นสื่อบน IG ทางอ้อมผ่านตำแหน่งข้อมูลอื่น ช่อง like_count จะส่งคืน 0
ในขณะนี้ หากผู้ใช้แอพไม่ได้เป็นเจ้าของสื่อและเจ้าของสื่อได้ซ่อนจำนวนการกดถูกใจของสื่อ ส่วนการสืบค้นสื่อบน IG โดยตรงซึ่งเจ้าของสื่อบน IG เท่านั้นที่ทำได้จะส่งคืนจำนวนการกดถูกใจจริง แม้ว่าเจ้าของจะซ่อนจำนวนการกดถูกใจของสื่อก็ตาม
วิธีที่เราคำนวณเกณฑ์ชี้วัด online_followers
ของผู้ใช้ IG มีการเปลี่ยนแปลงไปเล็กน้อย
ระบบจะไม่รวมการโต้ตอบกับสื่อบน IG ที่เป็นสตอรี่โดยผู้ใช้ในประเทศญี่ปุ่นในการคำนวณเกณฑ์ชี้วัด replies
บางรายการอีกต่อไป:
replies
จะคืนค่ากลับมาเป็น 0
แล้วในตอนนี้replies
จะยังคืนค่าจำนวนการตอบกลับอยู่ แต่ระบบจะไม่รวมการตอบกลับของผู้ใช้ในประเทศญี่ปุ่นในการคำนวณด้วยแก้ไขจุดบกพร่องเล็กน้อยในเกณฑ์ชี้วัดการเข้าถึงสำหรับสื่อบน Instagram ในสตอรี่
status
บนคอนเทนเนอร์ของ Instagram จะส่งคืนรหัสย่อยของข้อผิดพลาดหากค่าในช่อง error_code
ของคอนเทนเนอร์เป็น ERROR
video_views
ข้อมูลเชิงลึกของสื่อ Instagram รองรับอัลบั้มแล้วและจะส่งคืนผลรวมของ video_views
สำหรับวิดีโอทั้งหมดในอัลบั้มแทนที่จะเป็น 0
สื่อบน Instagram TV มีการรองรับในเวอร์ชั่น 10.0 ขึ้นไปแล้ว โดยจะมีผลกับตำแหน่งข้อมูลทั้งหมดยกเว้นตำแหน่งข้อมูลที่ใช้สำหรับเผยแพร่เนื้อหาและ Webhooks เพื่อสนับสนุนการเปลี่ยนแปลงนี้ จึงมีการเพิ่มช่อง media_product_type
และ video_title
ใหม่ในโหนดสื่อบน Instagram สื่อบน Instagram TV จะต้องแชร์ไปยัง Instagram ในตอนที่เผยแพร่ (โดยเปิดใช้งานโพสต์พรีวิวหรือแชร์พรีวิวไปยังฟีด) เพื่อให้เข้าถึงผ่าน API ได้
การเผยแพร่เนื้อหาเวอร์ชั่นเบต้าได้สิ้นสุดลงแล้ว และผู้พัฒนาทุกรายสามารถเผยแพร่สื่อในบัญชีมืออาชีพบน Instagram ได้แล้ว โปรดดูรายละเอียดการใช้งานในคู่มือการเผยแพร่เนื้อหา
เพื่อปฏิบัติตามข้อกำหนดด้าน ePrivacy ของสหภาพยุโรป การโต้ตอบของสื่อบน Instagram ในสตอรี่ที่เกี่ยวข้องกับการส่งข้อความจากผู้ใช้ในเขตเศรษฐกิจยุโรป (EEA) หลังจากวันที่ 1 ธันวาคม 2020 เป็นต้นไปจะไม่รวมอยู่ในการคำนวณเกณฑ์ชี้วัดบางรายการ ดังนี้
replies
จะส่งคืนค่าเป็น 0
replies
จะส่งคืนค่าเป็นจำนวนการตอบกลับ แต่การตอบกลับจากผู้ใช้ใน EEA จะไม่รวมอยู่ในการคำนวณนี้การเปลี่ยนแปลงนี้มีผลกับทุกเวอร์ชั่น
follower_count
จะใกล้เคียงกับค่าที่สอดคล้องกันซึ่งปรากฏในแอพ Instagram มากยิ่งขึ้น นอกจากนั้น ขณะนี้ follower_count
จะส่งคืนข้อมูลได้สูงสุด 30 วัน แทนที่จะเป็น 2 ปี การเปลี่ยนแปลงนี้มีผลกับเวอร์ชั่น 9.0 ขึ้นไปและจะมีผลกับทุกเวอร์ชั่นในวันที่ 9 พฤษภาคม 2021timestamp
ในสื่อบน Instagram ที่ส่งคืนมาโดยใช้การสืบค้นการค้นหาแฮชแท็กGET /{ig-hashtag-id}/top_media
และ GET /{ig-hashtag-id}/recent_media
ได้ ตัวอย่างเช่น GET /{ig-hashtag-id}/top_media?fields=timestamp
story_insights
กำหนดให้ต้องมีสิทธิ์การอนุญาต instagram_manage_insights
แทน instagram_manage_comments
#spooky
!/{ig-media-id}/comments
- การส่งคำขอ GET
โดยใช้ API เวอร์ชั่น 3.1 หรือเก่ากว่านั้นจะได้รับผลลัพธ์กลับมาแบบเรียงตามลำดับเวลา ส่วนการส่งคำขอโดยใช้เวอร์ชั่น 3.2 ขึ้นไปจะได้รับผลลัพธ์ที่เรียงตามลำดับเวลาแบบย้อนกลับ /{ig-media-id}
- คุณสามารถใช้การขยายเงื่อนไขในช่องเพื่อใช้ช่อง permalink
ในอ็อบเจ็กต์สื่อได้แล้ว/{ig-comment-id}
:
username
ใหม่GET
ช่อง user
จะไม่รวมอยู่ในการตอบกลับ เว้นแต่ว่าผู้ใช้ที่ส่งคำขอจะเป็นเจ้าของความคิดเห็นนั้น โดยเราจะส่งคืน username
ของผู้แสดงความคิดเห็นทุกคนแทน แนวทางนี้ยังมีผลกับการสืบค้นความคิดเห็นผ่าน API อื่นๆ เช่น API ของ Mentions อีกด้วย/{ig-media-id}
:
username
ใหม่GET
ช่อง owner
จะไม่รวมอยู่ในการตอบกลับ เว้นแต่ว่าผู้ใช้ที่ส่งคำขอจะเป็นเจ้าของอ็อบเจ็กต์สื่อนั้น โดยเราจะส่งคืน username
ของผู้แสดงความคิดเห็นทุกคนแทน แนวทางนี้ยังมีผลกับการสืบค้นอ็อบเจ็กต์สื่อผ่าน API อื่นๆ เช่น API ของ Mentions อีกด้วยAPI ข้อมูลเชิงลึก - ขณะนี้ ข้อมูลเชิงลึกจะรวมกิจกรรมโฆษณาที่สร้างผ่าน API, อินเทอร์เฟซโฆษณาบน Facebook และฟีเจอร์การโปรโมทของ Instagram ด้วย โดยจะมีผลกับเกณฑ์ชี้วัดดังต่อไปนี้
impressions
reach
/{ig-user-id}/media
เพื่อแท็กตำแหน่งที่ตั้งและผู้ใช้ Instagram แบบสาธารณะเมื่อเผยแพร่รูปภาพได้แล้วtimestamp
ในโหนด /{ig-media-id}
เป็นช่องสาธารณะแล้ว และสามารถส่งคืนผ่านการขยายเงื่อนไขในช่องได้/{ig-user-id}
, /{ig-comment-id}
และ /{ig-media-id}
จะส่งคืนช่องสาธารณะทั้งหมดเมื่อมีการเข้าถึงโดยจุดเชื่อมโยงผ่านการขยายเงื่อนไขในช่อง โปรดดูเอกสารอ้างอิงของโหนดแต่ละรายการเพื่อดูว่าช่องใดบ้างที่เป็นสาธารณะ/{ig-user-id}/media
ได้แล้ว มาใส่แฮชแท็กแบบ #crazywildebeest
กันได้เลย!