Media Pengguna Instagram

Merupakan koleksi objek Media Instagram tentang Pengguna Instagram.

Membuat

POST /{ig-user-id}/media

• Buat gambar, carousel, cerita, atau reel Kontainer Instagram untuk digunakan dalam proses penerbitan postingan. Baca panduan Penerbitan Konten untuk langkah-langkah penerbitan selengkapnya.

Batasan

Batasan Umum

• Kontainer kedaluwarsa dalam 24 jam.
• Jika Halaman yang terhubung ke akun Profesional Instagram yang ditargetkan mewajibkan Otorisasi Penerbitan Halaman / Page Publishing Authorization (PPA), PPA harus diselesaikan. Jika tidak, permintaan akan gagal.
• Jika Halaman yang terhubung ke akun Profesional Instagram yang ditargetkan memerlukan autentikasi dua faktor, Pengguna Facebook juga harus telah melakukan autentikasi dua faktor; jika tidak, permintaan akan gagal.
• Menerbitkan ke Instagram TV tidak didukung.

Batasan Reels

• Reels tidak bisa muncul di album carousel.
• Pengaturan privasi akun dihormati setelah diterbitkan. Contoh: jika Izinkan remix diaktifkan, reel yang diterbitkan akan memiliki remix yang diaktifkan saat terbit tetapi remix dapat dinonaktifkan pada reel yang diterbitkan secara manual melalui aplikasi Instagram.
• Penandaan musik hanya tersedia untuk audio asli.

Batasan Cerita

• Cerita kedaluwarsa setelah 24 jam.
• Mendukung URL atau Reel, tetapi tidak keduanya.
• Menerbitkan stiker (yaitu: tautan, polling, lokasi) tidak didukung.

Persyaratan

Spesifikasi Gambar

• Format: JPEG
• Ukuran file: maksimal 8 MB.
• Rasio aspek: Harus dalam rentang 4:5 sampai 1,91:1
• Lebar minimum: 320 (akan diperbesar ke minimum jika perlu)
• Lebar maksimum: 1440 (akan diperkecil ke maksimum jika perlu)
• Tinggi: Bervariasi, bergantung pada lebar dan rasio aspek
• Ruang Warna: sRGB. Gambar yang menggunakan ruang warna lain akan diubah ruang warnanya menjadi sRGB.

Spesifikasi Reel

Berikut ini adalah spesifikasi untuk Reels:

• Kontainer: MOV atau MP4 (MPEG-4 Bagian 14), tidak ada daftar edit, moov atom di depan file.
• Codec audio: AAC, laju sampel maksimum 48khz, 1 atau 2 saluran (mono atau stereo).
• Codec video: HEVC atau H264, pemindaian progresif, GOP tertutup, subsampling chroma 4:2: 0.
• Frame rate: 23-60 FPS.
• Ukuran gambar:

  • Kolom maksimum (piksel horizontal): 1.920
  • Rasio aspek yang diperlukan adalah antara 0,01:1 dan 10:1, tetapi kami rekomendasikan 9:16 untuk menghindari pemotongan atau ruang kosong.
• Laju bit video: VBR, maksimum 25 Mbps
• Laju bit audio: 128 kbps
• Durasi: maksimal 15 menit, minimal 3 detik
• Ukuran file: maksimum 1GB

Berikut ini adalah spesifikasi untuk foto sampul Reels:

• Format: JPEG
• Ukuran file: maksimal 8 MB
• Ruang Warna: sRGB. Gambar yang menggunakan ruang warna lain akan dikonversi menjadi sRGB.
• Rasio aspek: Direkomendasikan 9:16 untuk menghindari pemotongan atau ruang kosong. Jika rasio aspek gambar asli bukan 9:16, kami memotong gambar dan menggunakan persegi paling tengah 9:16 sebagai foto sampul untuk reel. Jika Anda membagikan reel ke kabar Anda, kami akan memotong gambar dan menggunakan persegi paling tengah 1:1 sebagai foto sampul untuk postingan kabar Anda.

Spesifikasi Gambar Cerita

• Format: JPEG
• Ukuran file: maksimum 8 MB.
• Rasio aspek: Direkomendasikan 9:16 untuk menghindari pemotongan atau ruang kosong
• Ruang Warna: sRGB. Gambar yang menggunakan ruang warna lain akan diubah ruang warnanya menjadi sRGB

Spesifikasi Video Cerita

• Kontainer: MOV atau MP4 (MPEG-4 Part 14), tidak ada daftar edit, moov atom di awal file.
• Codec audio: AAC, laju sampel maksimum 48khz, 1 atau 2 saluran (mono atau stereo).
• Codec video: HEVC atau H264, pemindaian progresif, GOP tertutup, subsampling chroma 4:2: 0.
• Frame rate: 23-60 FPS.
• Ukuran gambar:

  • Kolom maksimum (piksel horizontal): 1.920
  • Rasio aspek yang diperlukan adalah antara 0,1:1 dan 10:1, tetapi kami merekomendasikan 9:16 untuk menghindari pemotongan atau ruang kosong
• Laju bit video: VBR, maksimum 25 Mbps
• Laju bit audio: 128 kbps
• Durasi: maksimal 60 detik, minimal 3 detik
• Ukuran file: maksimum 100MB

Sintaksis Permintaan

Kontainer Gambar

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

Kontainer Reel

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

Kontainer Carousel

Hanya kontainer carousel. Untuk membuat kontainer item carousel, buat kontainer gambar atau video (reel tidak didukung). Lihat Postingan Carousel untuk langkah lengkap penerbitan.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

Kontainer Cerita Gambar

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

Kontainer Cerita Video

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

Parameter Jalur

Parameter String Kueri

Tanggapan

Objek berformat JSON berisi ID Kontainer Instagram yang dapat Anda gunakan untuk menerbitkan kontainer.

Unggahan video tidak sinkron, jadi menerima ID kontainer tidak menjamin bahwa unggahan berhasil. Untuk memverifikasi bahwa video telah diunggah, minta kolom status_code pada Kontainer Instagram. Jika nilainya FINISHED, video berhasil diunggah.

{
  "id":"{ig-container-id}"
}

Contoh Permintaan

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

Contoh Tanggapan

{
  "id": "17889455560051444"
}

Membaca

GET /{ig-user-id}/media

Mendapatkan semua objek Media Instagram tentang Pengguna Instagram.

Batasan

• Menampilkan maksimum 10 ribu dari media yang paling baru dibuat.
• Media Instagram Cerita tidak didukung, gunakan endpoint GET /{ig-user-id}/stories sebagai gantinya.

Persyaratan

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.

Contoh Permintaan

GET graph.facebook.com/17841405822304914/media 

Contoh Tanggapan

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

Memperbarui

Operasi ini tidak didukung.

Menghapus

Operasi ini tidak didukung.