ภาพรวม

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

URL ฐาน

ตำแหน่งข้อมูลทั้งหมดสามารถเข้าถึงได้ผ่านโฮสต์ graph.facebook.com

ผู้ใช้แอพ

บัญชีมืออาชีพบน Instagram จะเข้าถึงทางอ้อมได้ผ่านบัญชี Facebook ดังนั้นผู้ใช้แอพของคุณต้องมีบัญชี Facebook และใช้บัญชีนั้นเมื่อลงชื่อเข้าใช้แอพของคุณ นอกจากนั้น บัญชี Facebook ต้องสามารถทำงานที่เทียบเท่ากับผู้ดูแลบนเพจ Facebook ที่เชื่อมต่อกับบัญชี Instagram ที่ผู้ใช้พยายามจะเข้าถึง

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

การยืนยันตัวตน

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

การอนุญาต

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

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

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

API ใช้สิทธิ์การอนุญาตและฟีเจอร์ต่อไปนี้:

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

การส่งข้อความบน Instagram

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

ผู้มีส่วนร่วม

ฟีเจอร์ Instagram Collab เปิดโอกาสให้ผู้ใช้แอพ Instagram สามารถร่วมสร้างสรรค์เนื้อหา (กล่าวคือ เผยแพร่สื่อ) กับบัญชีอื่นๆ (ผู้มีส่วนร่วม) ได้

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

เพจ

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

บทความช่วยเหลือเกี่ยวกับการเพิ่มหรือเปลี่ยนแปลงเพจ Facebook ที่เชื่อมต่อกับบัญชีมืออาชีพบน Instagram ของคุณจะอธิบายวิธีเชื่อมต่อเพจ Facebook เข้ากับบัญชีมืออาชีพบน Instagram

งาน

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

สิทธิ์การอนุญาต	`MANAGE`	`CREATE_CONTENT`	`MODERATE`	`ADVERTISE`	`ANALYZE`
instagram_basic	✔	✔	✔	✔	✔
instagram_content_publish	✔	✔
instagram_manage_comments	✔	✔	✔
instagram_manage_insights	✔	✔	✔	✔	✔

คุณสามารถระบุงานที่ผู้ใช้แอพสามารถดำเนินการบนเพจได้โดยการสืบค้นตำแหน่งข้อมูล GET /me/accounts ด้วยโทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ ตำแหน่งข้อมูลจะส่งคืนรายการเพจที่ผู้ใช้แอพสามารถทำงานได้ และระบุงานที่ผู้ใช้สามารถทำในแต่ละเพจได้

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

การอ้างอิงถึงงาน

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

เพจแบบคลาสสิก

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

บทบาท	สิทธิ์การอนุญาตที่ให้ได้
ผู้แก้ไข	instagram_basic instagram_content_publish
ผู้ควบคุม	instagram_basic instagram_manage_comments instagram_manage_insights
ผู้ลงโฆษณา	instagram_basic instagram_manage_insights
นักวิเคราะห์	instagram_basic instagram_manage_insights

เพจที่ใช้ประสบการณ์แบบใหม่

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

สิทธิ์การเข้าถึงงาน	สิทธิ์การอนุญาตที่ให้ได้
โฆษณา	instagram_basic
เนื้อหา	instagram_basic instagram_content_publish
ข้อมูลเชิงลึก	instagram_basic instagram_manage_insights
ข้อความและกิจกรรมของชุมชน	instagram_basic instagram_manage_comments

หากต้องการระบุว่าเพจกำลังใช้ประสบการณ์แบบใหม่อยู่หรือไม่ ให้ส่งคำขอช่อง has_transitioned_to_new_page_experience ของเพจดังกล่าว ค่านี้จะแสดงเป็น true หากเพจใช้ประสบการณ์แบบใหม่

การตรวจสอบแอพ

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

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

แอพส่วนตัว

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

การตรวจสอบยืนยันธุรกิจ

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

การจำกัดอัตรา

ตำแหน่งข้อมูลทั้งหมดจะเป็นไปตามการจำกัดอัตราของกรณีการใช้งาน Instagram Business ยกเว้นตำแหน่งข้อมูลการค้นพบธุรกิจและการค้นหาแฮชแท็ก ซึ่งขึ้นอยู่กับการจำกัดอัตราของแพลตฟอร์ม

Webhooks

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

การส่งข้อความบน Instagram

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