Instagram Graph API

Media Siaran Langsung Pengguna Instagram

Mewakili koleksi Media Instagram video siaran langsung tentang si Pengguna Instagram.

Membuat

Operasi ini tidak didukung.

Membaca

GET /{ig-user-id}/live_media

Mendapatkan koleksi Media Instagram video siaran langsung tentang si Pengguna Instagram.

Batasan

Hanya Media Instagram video siaran langsung yang sedang disiarkan pada waktu permintaan yang akan diberikan.

Paginasi Berbasis Waktu

Endpoint ini mendukung paginasi berbasis waktu. Sertakan parameter string-kueri since dan until dengan cap waktu Unix atau nilai data strtotime untuk menentukan rentang waktu.

Persyaratan

JenisPersyaratan

Token Akses

Pengguna

Izin

instagram_basic
instagram_read_engagement
pages_read_engagement


Jika pengguna aplikasi diberi peran melalui Pengelola Bisnis di Halaman yang terhubung ke Pengguna Instagram target, Anda juga memerlukan salah satu dari:


ads_management
business_management

Sintaksis Permintaan

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

Parameter Jalur

PlaceholderNilai

{api-version}
String

Versi API.

{ig-user-id}
Wajib
String

ID pengguna lingkup aplikasi milik pengguna aplikasi.

Parameter String Kueri

KodeNilai

access_token
Wajib
String

Token akses Pengguna aplikasi.

fields
Daftar yang dipisahkan koma

Daftar kolom Media Instagram yang dipisahkan koma yang Anda ingin ditampilkan untuk setiap Media Instagram siaran langsung di set hasil.

since
cap waktu

Cap waktu Unix atau nilai data strtotime yang menunjuk ke awal rentang data berbasis waktu. Lihat paginasi berbasis waktu.

until
cap waktu

Cap waktu Unix atau nilai data strtotime yang menunjuk ke akhir rentang data berbasis waktu. Lihat paginasi berbasis waktu.

Tanggapan

Objek berformat JSON berisi data yang Anda minta.

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

Konten Tanggapan

PropertiNilai

data

Array Media Instagram tentang si Pengguna Instagram.

paging

Objek berisi kursor halaman dan URL pengambilan set data berikutnya/sebelumnya.

Contoh cURL

Permintaan

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...'

Tanggapan

{
   "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"
            }
        }
      ]
   }
}

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.