คืออัลบั้ม รูปภาพ หรือวิดีโอ (วิดีโอที่อัพโหลด, วิดีโอถ่ายทอดสด, คลิป Reels หรือสตอรี่) บน Instagram
If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.
ขอแนะนำช่องต่อไปนี้
legacy_instagram_media_idระบบไม่รองรับช่องของตำแหน่งข้อมูลโฆษณาบน Instagram ของ API การตลาดต่อไปนี้
filter_namelocationlocation_namelatitudelongitudeระบบไม่รองรับการดำเนินการนี้
GET /<IG_MEDIA_ID>
เรียกดูช่องและจุดเชื่อมโยงในสื่อบน Instagram
| Instagram API ที่ใช้การเข้าสู่ระบบด้วย Instagram | Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook | |
|---|---|---|
โทเค็นการเข้าถึง |
| |
URL โฮสต์ |
|
|
ประเภทการเข้าสู่ระบบ | การเข้าสู่ระบบธุรกิจสำหรับ Instagram | การเข้าสู่ระบบด้วย Facebook สำหรับธุรกิจ |
| สิทธิ์การอนุญาต |
|
หากผู้ใช้แอพได้รับบทบาทในเพจที่เชื่อมต่อกับบัญชีมืออาชีพบน Instagram ของผู้ใช้แอพของคุณผ่านทางตัวจัดการธุรกิจ แอพของคุณจะต้องมีสิทธิ์การอนุญาตอย่างใดอย่างหนึ่งต่อไปนี้ด้วย
|
comments_count และ like_count จะส่งคืนการมีส่วนร่วมบนสื่อบน Instagram เป้าหมายเท่านั้น และจะไม่รวมข้อมูลจากตำแหน่งอื่นๆ ตัวอย่างเช่น comments_count จะส่งคืนจำนวนความคิดเห็นบนรูปภาพ แต่จะไม่ส่งคืนจำนวนความคิดเห็นบนโฆษณาที่มีรูปภาพดังกล่าว ใช้ total_comments_count และ total_like_count เพื่อดึงข้อมูลจำนวนรวมที่รวมการมีส่วนร่วมจากสื่อที่โปรโมท/โฆษณา ทั้งนี้อาจรวมจำนวนของโพสต์บน Facebook ที่มีการโพสต์ข้ามด้วยหากโพสต์นั้นเปิดให้ผู้ใช้เซสชั่นเข้าถึงได้@ เว้นแต่ว่าผู้ใช้แอพจะสามารถดำเนินงานที่เทียบเท่ากับผู้ดูแลในแอพได้ด้วยpermalink จะไม่สามารถใช้กับรูปภาพที่อยู่ในอัลบั้ม (รอง) ได้reposts_count, saved_count, shares_count, total_like_count, total_comments_count และ total_views_count ไม่สามารถใช้งานกับสื่อรองของภาพสไลด์ได้และจะส่งคืนเฉพาะสำหรับอ็อบเจ็กต์สื่อระดับสูงสุดเท่านั้น เจ้าของสื่อสามารถปิดใช้งานการแสดงจำนวนการกดถูกใจ ความคิดเห็น การรีโพสต์ และการแชร์ได้ ในกรณีนี้ ระบบจะไม่ส่งคืนช่องที่เกี่ยวข้องGET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \ ?fields=<LIST_OF_FIELDS> \ &access_token=<ACCESS_TOKEN>
| ตัวยึดตำแหน่ง | ค่า |
|---|---|
เวอร์ชั่นล่าสุดคือ: v26.0 | เวอร์ชั่นของ API ที่แอพของคุณใช้งานอยู่ หากไม่ได้ระบุในการเรียกใช้ API จะเป็นเวอร์ชั่นล่าสุด ณ เวลาที่คุณสร้างแอพ Meta ของคุณขึ้นมา หรือหากเวอร์ชั่นดังกล่าวไม่สามารถใช้ได้อีกต่อไป API จะเป็นเวอร์ชั่นเก่าที่สุดที่ใช้งานได้ เรียนรู้เพิ่มเติมเกี่ยวกับการกำหนดเวอร์ชั่น |
| URL โฮสต์ที่แอพของคุณใช้เพื่อสืบค้นตำแหน่งข้อมูล |
| จำเป็นต้องระบุ ID สำหรับสื่อที่จะได้รับการเผยแพร่ |
| คีย์ | ตัวยึดตำแหน่ง | ค่า |
|---|---|---|
|
| จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ Facebook หรือ Instagram ของผู้ใช้แอพ |
|
| รายการที่คั่นด้วยเครื่องหมายจุลภาคที่ระบุช่องที่คุณต้องการให้ส่งคืน |
ช่องสาธารณะสามารถอ่านผ่านการขยายเงื่อนไขในช่องได้
| ช่อง | คำอธิบาย | ||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ข้อความอธิบายรูปภาพเพื่อช่วยในการเข้าถึง | ||||||||||||||||
| แสดงภาพรวมของข้อมูลโฆษณาบน Instagram ทั้งหมดที่เกี่ยวข้องกับสื่อออร์แกนิกสำหรับโฆษณาที่มีสถานะ | ||||||||||||||||
| ช่องนี้จะให้ข้อมูลเกี่ยวกับคุณสมบัติในการโปรโมทสื่อบน Instagram ในฐานะโฆษณา และจะให้รายละเอียดเพิ่มเติมหากสื่อดังกล่าวไม่เข้าเกณฑ์ ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น | ||||||||||||||||
| คำบรรยาย ไม่รวมรายการย่อยของอัลบั้ม ไม่ใส่สัญลักษณ์ | ||||||||||||||||
| จำนวนความคิดเห็นของสื่อ ไม่รวมความคิดเห็นของสื่อที่เป็นอัลบั้มรองและคำบรรยายของสื่อ รวมการตอบกลับในความคิดเห็น | ||||||||||||||||
| ส่งกลับอ็อบเจ็กต์
หากวิดีโอละเมิดลิขสิทธิ์ ระบบจะส่ง
| ||||||||||||||||
| ID สื่อ | ||||||||||||||||
| ระบุว่าสื่อมีป้าย AI หรือไม่ ไม่รวมรายการย่อยของอัลบั้ม | ||||||||||||||||
| ระบุว่าความคิดเห็นเปิดหรือปิดใช้งาน ไม่รวมรายการย่อยของอัลบั้ม | ||||||||||||||||
| สำหรับคลิป Reels เท่านั้น หากมีค่าเป็น ทั้ง 2 ค่านี้ไม่ได้กำหนดว่าคลิป Reels จะปรากฏในแท็บ Reels จริงๆ เนื่องจากคลิป Reels อาจไม่เป็นไปตามข้อกำหนดการได้รับสิทธิ์ หรืออาจไม่ได้รับเลือกจากอัลกอริทึมของเรา ดูเกณฑ์การได้รับสิทธิ์ได้ที่ข้อมูลจำเพาะเกี่ยวกับคลิป Reels | ||||||||||||||||
| ID สำหรับสื่อบน Instagram ที่สร้างขึ้นสำหรับตำแหน่งข้อมูล API การตลาดสำหรับเวอร์ชั่น 21.0 และเวอร์ชั่นก่อนหน้า | ||||||||||||||||
| การนับจำนวนการกดถูกใจของสื่อ ไม่รวมการตอบกลับความคิดเห็น ไม่รวมการกดถูกใจของสื่อที่เป็นอัลบั้มรองและการกดถูกใจของโพสต์ที่โปรโมทซึ่งสร้างจากสื่อนั้น ในกรณีที่สืบค้นโดยอ้อมผ่านตำแหน่งข้อมูลหรือการขยายของช่อง ช่อง | ||||||||||||||||
| ประเภทของเสียงที่ใช้ในสื่อ โดยอาจเป็น | ||||||||||||||||
| แพลตฟอร์มที่มีการเผยแพร่สื่อ โดยอาจเป็น | ||||||||||||||||
| ประเภทสื่อ อาจจะเป็น | ||||||||||||||||
| URL ของสื่อ ช่อง | ||||||||||||||||
| ID ของผู้ใช้ Instagram ที่สร้างสื่อ ระบบจะส่งคืนเฉพาะกรณีที่ผู้ใช้แอพที่สืบค้นนั้นเป็นผู้สร้างสื่อด้วย มิฉะนั้นจะส่งคืนช่อง | ||||||||||||||||
| URL ถาวรไปยังสื่อ | ||||||||||||||||
| โค้ดแบบสั้นไปยังสื่อ | ||||||||||||||||
| URL ภาพขนาดย่อของสื่อ ใช้ได้ในสื่อ | ||||||||||||||||
| วันที่สร้างในรูปแบบ ISO 8601 ตามเวลา UTC (ค่าเริ่มต้นคือ UTC ±00:00) | ||||||||||||||||
| ชื่อผู้ใช้ของผู้ใช้ที่สร้างสื่อ | ||||||||||||||||
| ยอดดูสำหรับคลิป Reels บน Instagram ซึ่งรวมทั้งเกณฑ์ชี้วัดแบบได้รับการสนับสนุนและแบบออร์แกนิก สำหรับเนื้อหาที่โพสต์ข้ามไปยัง Facebook ระบบจะส่งคืนจำนวนการรับชมบน Instagram และ Facebook รวมกัน หากผู้ใช้เซสชั่นสามารถเข้าถึงโพสต์บน Facebook ได้ พร้อมใช้งานสำหรับ Business Discovery API เท่านั้น | ||||||||||||||||
| จำนวนครั้งที่มีการรีโพสต์สื่อ พร้อมใช้งานสำหรับสื่อที่เป็นฟีดและคลิป Reels ไม่สามารถเข้าถึงได้ผ่านตำแหน่งข้อมูล API แฮชแท็ก ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น | ||||||||||||||||
| จำนวนครั้งที่มีการบันทึกสื่อ พร้อมใช้งานสำหรับสื่อที่เป็นฟีดและคลิป Reels มีเพียงเจ้าของสื่อหรือผู้มีส่วนร่วมที่ได้รับการยอมรับเท่านั้นที่จะสามารถเข้าถึงได้ ไม่สามารถเข้าถึงได้ผ่าน Business Discovery สื่อที่ถูกแท็ก/มีการกล่าวถึง หรือตำแหน่งข้อมูลแฮชแท็ก API ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น | ||||||||||||||||
| จำนวนครั้งที่มีการแชร์สื่อ พร้อมใช้งานสำหรับสื่อที่เป็นฟีดและคลิป Reels ไม่สามารถเข้าถึงได้ผ่าน Business Discovery หรือตำแหน่งข้อมูล API ของแฮชแท็ก ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น | ||||||||||||||||
| จำนวนความคิดเห็นทั้งหมดของสื่อในทุกแพลตฟอร์ม ซึ่งรวมถึงความคิดเห็นบนสื่อที่เกี่ยวข้องซึ่งได้รับการโปรโมท ไม่สามารถเข้าถึงได้ผ่านตำแหน่งข้อมูล API แฮชแท็ก ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น | ||||||||||||||||
| จำนวนการกดถูกใจสื่อทั้งหมดในทุกแพลตฟอร์ม ซึ่งรวมถึงการกดถูกใจบนสื่อที่เกี่ยวข้องซึ่งได้รับการโปรโมท ไม่สามารถเข้าถึงได้ผ่านตำแหน่งข้อมูล API แฮชแท็ก ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น | ||||||||||||||||
| จำนวนการรับชมทั้งหมดของเนื้อหาวิดีโอในทุกช่องทาง รวมถึงจำนวนการรับชมจากสื่อที่ได้รับการโปรโมทและการเล่นซ้ำด้วย ใช้ได้สำหรับสื่อที่เป็นวิดีโอเท่านั้น ไม่สามารถเข้าถึงได้ผ่าน Business Discovery หรือตำแหน่งข้อมูล API ของแฮชแท็ก สำหรับ Business Discovery ให้ใช้ |
จุดเชื่อมโยงสาธารณะสามารถส่งคืนผ่านการขยายเงื่อนไขในช่องได้
| จุดเชื่อมโยง | คำอธิบาย |
|---|---|
| คือคอลเลกชั่นอ็อบเจ็กต์สื่อบน Instagram ในอัลบั้มสื่อบน Instagram |
คือรายชื่อผู้ใช้ที่ถูกเพิ่มเป็นผู้มีส่วนร่วมในอ็อบเจ็กต์สื่อบน Instagram ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น | |
คือคอลเลกชั่นความคิดเห็นบน Instagram ในอ็อบเจ็กต์สื่อบน Instagram | |
คือเกณฑ์ชี้วัดการโต้ตอบบนโซเชียลในอ็อบเจ็กต์สื่อบน Instagram |
curl -X GET \
'https://graph.instagram.com/v26.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'
{
"id": "17918920912340654",
"media_type": "IMAGE",
"media_url": "https://sconten...",
"owner": {
"id": "17841405309211844"
},
"timestamp": "2019-09-26T22:36:43+0000"
}POST /<IG_MEDIA_ID>
เปิดใช้งานหรือปิดใช้งานการแสดงความคิดเห็นในสื่อบน Instagram
| Instagram API with Instagram Login | Instagram API with Facebook Login | |
|---|---|---|
Access Tokens |
| |
Host URL |
|
|
Login Type | Business Login for Instagram | Facebook Login for Business |
| Permissions |
|
If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:
|
ไม่รองรับสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสด
POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> ?comment_enabled=<BOOL> &access_token=<ACCESS_TOKEN>
| ตัวยึดตำแหน่ง | ค่า |
|---|---|
เวอร์ชั่นล่าสุดคือ: v26.0 | เวอร์ชั่นของ API ที่แอพของคุณใช้งานอยู่ หากไม่ได้ระบุในการเรียกใช้ API จะเป็นเวอร์ชั่นล่าสุด ณ เวลาที่คุณสร้างแอพ Meta ของคุณขึ้นมา หรือหากเวอร์ชั่นดังกล่าวไม่สามารถใช้ได้อีกต่อไป API จะเป็นเวอร์ชั่นเก่าที่สุดที่ใช้งานได้ เรียนรู้เพิ่มเติมเกี่ยวกับการกำหนดเวอร์ชั่น |
| URL โฮสต์ที่แอพของคุณใช้เพื่อสืบค้นตำแหน่งข้อมูล |
| จำเป็นต้องระบุ ID สำหรับสื่อที่จะได้รับการเผยแพร่ |
| คีย์ | ตัวยึดตำแหน่ง | ค่า |
|---|---|---|
|
| จำเป็นต้องระบุโทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ |
|
| จำเป็นต้องระบุ ตั้งค่าเป็น |
curl -i -X POST \
"https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."
{
"success": true
}DELETE /<IG_MEDIA_ID>
ลบสื่อบน Instagram
| Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook | |
|---|---|
โทเค็นการเข้าถึง | |
URL โฮสต์ |
|
ประเภทการเข้าสู่ระบบ | การเข้าสู่ระบบด้วย Facebook สำหรับธุรกิจ |
| สิทธิ์การอนุญาต |
|
API นี้รองรับเฉพาะ API ของ Instagram ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น โดยรองรับโพสต์, สตอรี่, คลิป Reels และอัลบั้มภาพสไลด์ที่ไม่ใช่โฆษณาทั้งหมด หากต้องการลบสื่อที่อยู่ในอัลบั้มภาพสไลด์ คุณจะต้องลบอัลบั้มภาพสไลด์ทั้งอัลบั้มโดยระบุ ID สื่อของคอนเทนเนอร์ภาพสไลด์ ระบบไม่รองรับการลบสื่อในภาพสไลด์แบบทีละรายการ
POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID> ?access_token=<ACCESS_TOKEN>
| ตัวยึดตำแหน่ง | ค่า |
|---|---|
เวอร์ชั่นล่าสุดคือ: v26.0 | เวอร์ชั่นของ API ที่แอพของคุณใช้งานอยู่ หากไม่ได้ระบุในการเรียกใช้ API จะเป็นเวอร์ชั่นล่าสุด ณ เวลาที่คุณสร้างแอพ Meta ของคุณขึ้นมา หรือหากเวอร์ชั่นดังกล่าวไม่สามารถใช้ได้อีกต่อไป API จะเป็นเวอร์ชั่นเก่าที่สุดที่ใช้งานได้ เรียนรู้เพิ่มเติมเกี่ยวกับการกำหนดเวอร์ชั่น |
| จำเป็นต้องระบุ ID สำหรับสื่อที่จะได้รับการเผยแพร่ |
| คีย์ | ตัวยึดตำแหน่ง | ค่า |
|---|---|---|
|
| จำเป็นต้องระบุโทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ |
curl -i -X DELETE \
"https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."
{
"success": true,
"deleted_id": "17918920912340654"
}
{
"error": {
"message": "Fatal",
"type": "OAuthException",
"code": -1,
"error_subcode": 2207073,
"is_transient": false,
"error_user_title": "Media Type Not Supported",
"error_user_msg": "The media type is not supported for this endpoint",
"fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
},
}