IGユーザーメディア

IGユーザーのIGメディアオブジェクトのコレクションを表します。

作成

POST /{ig-user-id}/media

• 投稿公開処理で使う画像、カルーセル、ストーリーズ、またはリール動画のIGコンテナを作成します。公開の手順について詳しくは、コンテンツ公開ガイドをご覧ください。

制限

一般的な制限

• コンテナは24時間後に期限切れになります。
• ターゲットのInstagramプロアカウントにリンクされているページでページ公開認証(PPA)が求められる場合は、PPAを完了する必要があります。そうしないとリクエストが失敗します。
• ターゲットのInstagramプロアカウントにリンクされているページで二段階認証が必要な場合、Facebookユーザーも二段階認証を実行する必要があります。そうしないとリクエストは失敗します。
• Instagram TVへの公開はサポートされていません。

リールの制限

• リールをアルバムカルーセルに表示することはできません。
• 公開の際にはアカウントプライバシー設定が適用されます。例えば、リミックス許可が有効になっている場合、公開されるリール動画では公開時にリミックスが有効になります。公開済みのリール動画のリミックスは、Instagramアプリから手動で無効にすることができます。
• 音楽のタグ付けはオリジナル音源にのみ利用できます。

ストーリーズの制限事項

• ストーリーズは24時間後に期限切れになります。
• 動画のURLまたはリール動画のURLのどちらか一方のみサポートし、両方同時にサポートすることはありません。
• スタンプ(リンク、アンケート、位置情報など)の公開はサポートされていません。

要件

画像の仕様

• フォーマット: JPEG
• ファイルサイズ: 最大8 MB。
• アスペクト比: 4:5から1.91:1までの範囲内
• 最小幅: 320 (必要な場合、この最小幅まで拡大されます)
• 最大幅: 1440 (必要な場合、この最大幅まで縮小されます)
• 高さ: 幅とアスペクト比に応じて可変
• カラースペース: sRGB。画像で他の色空間を使用している場合、sRGBに変換されます。

リールの仕様

リールの仕様は次のとおりです。

• コンテナ: MOVまたはMP4 (MPEG-4 Part 14)、エディットリストなし、ファイルの先頭にmoov atom。
• 音声コーデック: AAC、最大サンプルレート48kHz、1または2チャンネル(モノラルまたはステレオ)。
• 動画コーデック: HEVCまたはH264、プログレッシブスキャン、クローズドGOP、クロマサブサンプリング4:2:0。
• フレームレート: 23-60 FPS。
• 写真サイズ

  • 最大カラム(水平ピクセル数): 1920
  • 必要なアスペクト比は0.01:1～10:1ですが、トリミングや余白を避けるため9:16にすることをおすすめします。
• 動画のビットレート: VBR、最大25Mbps
• 音声のビットレート: 128kbps
• 長さ: 最大15分、最小3秒
• ファイルサイズ: 最大1GB

リールのカバー写真の仕様は次のとおりです。

• フォーマット: JPEG
• ファイルサイズ: 最大8 MB
• カラースペース: sRGB。画像で他の色空間を使っている場合、sRGBに変換されます。
• アスペクト比: トリミングや余白を避けるため9:16にすることをおすすめします。元の画像のアスペクト比が9:16でない場合、画像がトリミングされて、真ん中の9:16長方形がリールのカバー写真として使われます。リールをフィードにシェアした場合、画像はトリミングされ、真ん中の1:1正方形がフィード投稿のカバー写真として使われます。

ストーリーズ画像の仕様

• フォーマット: JPEG
• ファイルサイズ: 最大8 MB。
• アスペクト比: トリミングや余白を避けるため9:16にすることをおすすめしていました
• カラースペース: sRGB。画像で他の色空間を使用している場合、sRGBに変換されます

ストーリーズ動画の仕様

• コンテナ: MOVまたはMP4 (MPEG-4 Part 14)、エディットリストなし、ファイルの先頭にmoov atom。
• 音声コーデック: AAC、最大サンプルレート48kHz、1または2チャンネル(モノラルまたはステレオ)。
• 動画コーデック: HEVCまたはH264、プログレッシブスキャン、クローズドGOP、クロマサブサンプリング4:2:0。
• フレームレート: 23-60 FPS。
• 写真サイズ

  • 最大カラム(水平ピクセル数): 1920
  • 必要なアスペクト比は0.1:1～10:1ですが、トリミングや余白を避けるため9:16にすることをおすすめします
• 動画のビットレート: VBR、最大25Mbps
• 音声のビットレート: 128kbps
• 長さ: 最大60秒、最小3秒
• ファイルサイズ: 最大100MB

リクエストの構文

画像コンテナ

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}

リールコンテナ

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}

カルーセルコンテナ

カルーセルコンテナのみ。カルーセルアイテムのコンテナを作成する場合、代わりに画像コンテナか動画コンテナを作成してください(リール動画はサポートされていません)。詳しい公開手順については、カルーセル投稿をご覧ください。

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}

画像ストーリーズコンテナ

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

動画ストーリーズコンテナ

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

パスパラメーター

クエリ文字列パラメーター

応答

コンテナを公開するのに使用できるIGコンテナIDを含むJSON形式のオブジェクト。

動画アップロードは非同期処理なので、コンテナIDを受け取ったとしても、アップロードが成功したとは限りません。動画がアップロードされたことを確認するには、IGコンテナのstatus_codeフィールドをリクエストします。その値がFINISHEDであれば、動画は正常にアップロードされています。

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

リクエストの例

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

応答の例

{
  "id": "17889455560051444"
}

読み取り

GET /{ig-user-id}/media

IGユーザーのIGメディアをすべて取得します。

制限

• 直近で作成されたメディアの最大10Kを返します。
• ストーリーズIGメディアはサポートされていません。代わりにGET /{ig-user-id}/storiesエンドポイントを使ってください。

要件

時間ベースのページネーション

このエンドポイントでは、時間ベースのページネーションがサポートされています。時間範囲を定義するため、Unixタイムスタンプまたはstrtotimeデータ値を指定した、クエリ文字列パラメーターsinceとuntilを含めます。

リクエストの例

GET graph.facebook.com/17841405822304914/media 

応答の例

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

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。