เอกสารนี้นี้ได้รับการอัพเดตแล้ว
คำแปลเป็น ภาษาไทย ยังไม่เสร็จสมบูรณ์

ภาษาอังกฤษที่อัพเดต: 6 ก.ย.

สื่อบน Instagram

คืออัลบั้ม รูปภาพ หรือวิดีโอ (วิดีโอที่อัพโหลด วิดีโอถ่ายทอดสด หรือวิดีโอที่สร้างจากแอพ Instagram TV, คลิป Reels หรือสตอรี่) บน Instagram

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

การสร้าง

ระบบไม่รองรับการดำเนินการนี้

การอ่าน

GET /<IG_MEDIA_ID>

ดึงข้อมูลช่องและจุดเชื่อมโยงในสื่อบน Instagram

ข้อจำกัด

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

รูปแบบคำสั่งของคำขอ

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

พารามิเตอร์พาธ

ตัวยึดตำแหน่ง	ค่า
`<API_VERSION>`	เวอร์ชั่นของ API
`<IG_MEDIA_ID>`	จำเป็นต้องระบุ ID สำหรับสื่อที่จะได้รับการเผยแพร่

พารามิเตอร์สตริงการสืบค้น

คีย์	ตัวยึดตำแหน่ง	ค่า
`access_token`	`<ACCESS_TOKEN>`	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ
`fields`	`<LIST_OF_FIELDS>`	รายการที่คั่นด้วยเครื่องหมายจุลภาคที่ระบุช่องที่คุณต้องการให้ส่งคืน

ช่อง

ช่องสาธารณะสามารถอ่านผ่านการขยายเงื่อนไขในช่องได้

ช่อง คำอธิบาย

boost_ads_list

แสดงภาพรวมของข้อมูลโฆษณาบน Instagram ทั้งหมดที่เกี่ยวข้องกับสื่อออร์แกนิก ซึ่งจะประกอบด้วย ID โฆษณาและสถานะการแสดงโฆษณาที่เกี่ยวข้อง ใช้งานได้กับ API กราฟของ Instagram เท่านั้น

boost_eligibility_info

ช่องนี้จะให้ข้อมูลเกี่ยวกับคุณสมบัติในการโปรโมทสื่อบน Instagram ในฐานะโฆษณา และจะให้รายละเอียดเพิ่มเติมหากสื่อดังกล่าวไม่เข้าเกณฑ์ ใช้งานได้กับ API กราฟของ Instagram เท่านั้น

caption
สาธารณะ

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

comments_count
สาธารณะ

จำนวนความคิดเห็นของสื่อ ไม่รวมความคิดเห็นของสื่อที่เป็นอัลบั้มรองและคำบรรยายของสื่อ รวมการตอบกลับในความคิดเห็น

copyright_check_information.status

ส่งกลับอ็อบเจ็กต์ status และ matches_found

อ็อบเจ็กต์สถานะ คำอธิบาย

status

completed – กระบวนการตรวจหาเสร็จสิ้นแล้ว
error – มีข้อผิดพลาดเกิดขึ้นระหว่างกระบวนการตรวจหา
in_progress – กระบวนการตรวจหากำลังดำเนินอยู่
not_started – กระบวนการตรวจหายังไม่เริ่มต้น

matches_found

ตั้งค่าเป็นอย่างใดอย่างหนึ่งต่อไปนี้

false หากวิดีโอไม่ละเมิดลิขสิทธิ์
true หากวิดีโอไม่ละเมิดลิขสิทธิ์

หากวิดีโอละเมิดลิขสิทธิ์ ระบบจะส่ง copyright_matches กลับมาพร้อมด้วยอาร์เรย์ของอ็อบเจ็กต์เกี่ยวกับเนื้อหาที่มีลิขสิทธิ์ เมื่อมีการละเมิดเกิดขึ้นในวิดีโอ และการดำเนินการเพื่อลดผลกระทบของการละเมิด

อ็อบเจ็กต์ copyright_matches	คำอธิบาย
`author`	ผู้สร้างวิดีโอที่มีลิขสิทธิ์
`content_title`	ชื่อของวิดีโอที่มีลิขสิทธิ์
`matched_segments`	อาร์เรย์ของอ็อบเจ็กต์ที่มีคู่ค่าและคีย์ต่อไปนี้: * `duration_in_seconds` – จำนวนวินาทีที่เนื้อหามีการละเมิดลิขสิทธิ์ * `segment_type` – `AUDIO` หรือ `VIDEO` * `start_time_in_seconds` – ตั้งเป็นเวลาเริ่มต้นของวิดีโอ
`owner_copyright_policy`	อ็อบเจ็กต์ที่ส่งกลับมีดังต่อไปนี้ `name` – ชื่อนโยบายของเจ้าของลิขสิทธิ์ `actions` – อาร์เรย์ของอ็อบเจ็กต์ `action` ที่มีขั้นตอนการลดผลกระทบที่กำหนดโดยนโยบายของเจ้าของลิขสิทธิ์ โดยอาจรวมถึงขั้นตอนการลดผลกระทบต่างๆ สำหรับตำแหน่งที่แตกต่างกัน `action` – การดำเนินการลดผลกระทบต่อวิดีโอที่ละเมิดลิขสิทธิ์ เราอาจมีการดำเนินขั้นตอนการลดผลกระทบที่แตกต่างกันไปตามแต่ละประเทศ โดยอาจเป็นค่าใดค่าหนึ่งต่อไปนี้ `BLOCK` – วิดีโอถูกบล็อกจากผู้ชมที่มีรายชื่ออยู่ในอาร์เรย์ `geos` `MUTE` - วิดีโอถูกปิดการแจ้งเตือนสำหรับผู้ชมที่มีรายชื่ออยู่ในอาร์เรย์ `geos`

id
สาธารณะ

ID สื่อ

is_comment_enabled

ระบุว่าความคิดเห็นเปิดหรือปิดใช้งาน ไม่รวมรายการย่อยของอัลบั้ม

is_shared_to_feed
สาธารณะ

สำหรับคลิป Reels เท่านั้น หากมีค่าเป็น true แสดงว่าคลิป Reels สามารถปรากฏได้ทั้งในแท็บฟีดและ Reels แต่หากมีค่าเป็น false แสดงว่าคลิป Reels สามารถปรากฏได้ในแท็บ Reels เท่านั้น

ทั้ง 2 ค่านี้ไม่ได้กำหนดว่าคลิป Reels จะปรากฏในแท็บ Reels จริงๆ เนื่องจากคลิป Reels อาจไม่เป็นไปตามข้อกำหนดการได้รับสิทธิ์ หรืออาจไม่ได้รับเลือกจากอัลกอริทึมของเรา โปรดดูเกณฑ์การได้รับสิทธิ์ที่ข้อมูลจำเพาะเกี่ยวกับคลิป Reels

like_count

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

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

media_product_type
สาธารณะ

แพลตฟอร์มที่มีการเผยแพร่สื่อ โดยอาจเป็น AD, FEED, STORY หรือ REELS ก็ได้ ใช้งานได้กับ API กราฟของ Instagram เท่านั้น

media_type
สาธารณะ

ประเภทสื่อ อาจจะเป็น CAROUSEL_ALBUM, IMAGE หรือ VIDEO

media_url
สาธารณะ

URL ของสื่อ

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

owner
สาธารณะ

ID ของผู้ใช้ Instagram ที่สร้างสื่อ ระบบจะส่งคืนเฉพาะกรณีที่ผู้ใช้แอพที่สืบค้นนั้นเป็นผู้สร้างสื่อด้วย มิฉะนั้นจะส่งคืนช่อง username แทน

permalink
สาธารณะ

URL ถาวรไปยังสื่อ

shortcode
สาธารณะ

โค้ดแบบสั้นไปยังสื่อ

thumbnail_url
สาธารณะ

URL ภาพขนาดย่อของสื่อ ใช้ได้ในสื่อ VIDEO เท่านั้น

timestamp
สาธารณะ

วันที่สร้างในรูปแบบ ISO 8601 ตามเวลา UTC (ค่าเริ่มต้นคือ UTC ±00:00)

username
สาธารณะ

ชื่อผู้ใช้ของผู้ใช้ที่สร้างสื่อ

จุดเชื่อมโยง

จุดเชื่อมโยงสาธารณะสามารถส่งคืนผ่านการขยายเงื่อนไขในช่องได้

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

ตัวอย่าง cURL

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

curl -X GET \
  'https://graph.instagram.com/v21.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