แพลตฟอร์ม Instagram

สื่อบน Instagram

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

การสร้าง

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

การอ่าน

GET /{ig-media-id}

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

ข้อจำกัด

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

ข้อกำหนด

ประเภทคำอธิบาย

โทเค็นการเข้าถึง

ผู้ใช้

สิทธิ์การอนุญาต

instagram_basic
pages_read_engagement
pages_show_list


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


ads_management
business_management

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

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={fields}
  &access_token={access-token}

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

ตัวยึดตำแหน่งค่า

{api-version}

เวอร์ชั่นของ API

{ig-media-id}

จำเป็นต้องระบุ ID สื่อบน Instagram

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

คีย์ตัวยึดตำแหน่งค่า

access_token

{access-token}

จำเป็นต้องระบุโทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ

fields

{fields}

รายการที่คั่นด้วยเครื่องหมายจุลภาคที่ระบุช่องที่คุณต้องการให้ส่งคืน

ช่อง

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

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

caption
สาธารณะ

คำบรรยาย ไม่รวมรายการย่อยของอัลบั้ม ไม่ใส่สัญลักษณ์ @ เว้นแต่ว่าผู้ใช้แอพสามารถทำงานที่เทียบเท่ากับผู้ดูแลบนเพจ Facebook ซึ่งเชื่อมโยงไว้กับบัญชี 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 สื่อ

ig_id
สาธารณะ

ID สื่อบน Instagram ใช้กับ Instagram API แบบเก่า โดยเลิกใช้แล้วตอนนี้ ใช้ id แทน

is_comment_enabled

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

is_shared_to_feed
สาธารณะ

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

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

like_count

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


ในกรณีที่สืบค้นโดยอ้อมผ่านตำแหน่งข้อมูลหรือการขยายเงื่อนไขในช่องอีกรายการหนึ่ง:


  • การเรียกใช้เวอร์ชั่น 10.0 และก่อนหน้า: ค่าจะเป็น 0 หากเจ้าของสื่อซ่อนจำนวนการกดถูกใจสื่อเอาไว้
  • การเรียกใช้เวอร์ชั่น 11.0 ขึ้นไป: ช่อง like_count จะถูกละไว้หากเจ้าของสื่อซ่อนจำนวนการกดถูกใจสื่อเอาไว้

media_product_type
สาธารณะ

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

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
สาธารณะ

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

video_title
สาธารณะ

เลิกใช้แล้ว จะไม่รวมอยู่ในการตอบกลับ

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

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

จุดเชื่อมโยงคำอธิบาย

children
สาธารณะ

คือชุดข้อมูลอ็อบเจ็กต์ของสื่อบน Instagram ในอัลบั้มสื่อบน Instagram

collaborators

แสดงรายชื่อผู้ใช้ที่ถูกเพิ่มเป็นผู้มีส่วนร่วมในออบเจ็กต์สื่อบน Instagram

comments

คือชุดข้อมูลความคิดเห็นบน Instagram ในอ็อบเจ็กต์สื่อบน Instagram

insights

คือเกณฑ์ชี้วัดการโต้ตอบบนโซเชียลในอ็อบเจ็กต์สื่อบน Instagram

ตัวอย่าง cURL

คำขอ

curl -X GET \
  'https://graph.facebook.com/v19.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 ที่เป็นวิดีโอถ่ายทอดสด

ข้อกำหนด

ประเภทคำอธิบาย

โทเค็นการเข้าถึง

ผู้ใช้

สิทธิ์การอนุญาต

instagram_basic
instagram_manage_comments
pages_show_list


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


ads_management
business_management

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

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &access_token={access-token}

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

ตัวยึดตำแหน่งค่า

{api-version}

เวอร์ชั่นของ API

{ig-media-id}

จำเป็นต้องระบุ ID สื่อบน Instagram

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

คีย์ตัวยึดตำแหน่งค่า

access_token

{access-token}

จำเป็นต้องระบุโทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ

comment_enabled

{comment-enabled}

จำเป็นต้องระบุ ตั้งค่าเป็น true เพื่อเปิดใช้งานความคิดเห็น หรือเป็น false เพื่อปิดใช้งานความคิดเห็น

ตัวอย่าง cURL

คำขอ

curl -i -X POST \
 "https://graph.facebook.com/v19.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

การตอบกลับ

{
  "success": true
}

การลบ

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