สื่อการถ่ายทอดสดของผู้ใช้ Instagram

แสดงถึงคอลเลกชั่นสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสดของผู้ใช้ Instagram

การสร้าง

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

การอ่าน

GET /{ig-user-id}/live_media

รับคอลเลกชั่นสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสดของผู้ใช้ Instagram

ข้อจำกัด

ระบบจะส่งคืนเฉพาะสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสดที่กำลังแพร่ภาพอยู่ในตอนที่ส่งคำขอเท่านั้น

การแบ่งหน้าโดยอิงจากเวลา

ตำแหน่งข้อมูลนี้รองรับการแบ่งหน้าโดยอิงจากเวลา ใส่พารามิเตอร์สตริงการสืบค้น since และ until เข้าไปโดยใช้ประทับเวลา Unix หรือค่าข้อมูล strtotime เพื่อกำหนดช่วงเวลา

ข้อกำหนด

ประเภท ข้อกำหนด

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

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

ผู้ใช้

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

instagram_basic
instagram_read_engagement
pages_read_engagement

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

ads_management
business_management

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

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

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

ตัวยึดตำแหน่ง	ค่า
`{api-version}` สตริง	เวอร์ชั่นของ API
`{ig-user-id}` จำเป็นต้องระบุ สตริง	ID ผู้ใช้ในแอพของผู้ใช้แอพ

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

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

การตอบกลับ

อ็อบเจ็กต์รูปแบบ JSON ที่มีข้อมูลที่คุณส่งคำขอ

{
  "data": [],
  "paging": {}
}

เนื้อหาของการตอบกลับ

คุณสมบัติ	ค่า
`data`	อาร์เรย์สื่อบน Instagram ของผู้ใช้ Instagram
`paging`	อ็อบเจ็กต์ที่ประกอบด้วยเคอร์เซอร์การแบ่งหน้าและ URL การดึงชุดข้อมูลถัดไป/ก่อนหน้า

ตัวอย่าง cURL

คำขอ

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914/live_media?fields=id,media_type,media_product_type,owner,username,comments&access_token=IGQVJ...'

การตอบกลับ

{
   "id":"90010498116233",
   "media_type":"BROADCAST",
   "media_product_type":"LIVE",
   "owner":{
      "id":"17841405822304914"
   },
   "username":"jayposiris",
   "comments":{
      "data":[
        {
            "hidden": false,
            "id": "17907364514064687",
            "like_count": 0,
            "media": {
                "id": "17892642502701087"
            },
            "text": "@jayposiris",
            "timestamp": "2021-08-17T21:23:07+0000",
            "username": "bztest0316_11",
            "from": {
                "id": "5895605157123796",
                "username": "bztest0316_11"
            }
        }
      ]
   }
}

การอัพเดต

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

การลบ

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