IGユーザーメディア

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

作成

POST /<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media

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

メディアオブジェクトを公開する手順には、以下が含まれます。

1. コンテナを作成する
2. コンテナにメディアをアップロードする
3. コンテナを公開する

制限

一般的な制限

• コンテナは24時間後に期限切れになります。
• Instagramアカウントは24時間以内に400個のコンテナしか作成できません。
• ターゲットのInstagramプロアカウントにリンクされているページでページ公開認証(PPA)が求められる場合は、PPAを完了する必要があります。そうしないとリクエストが失敗します。
• ターゲットのInstagramプロアカウントにリンクされているページで二段階認証が必要な場合、Facebookユーザーも二段階認証を実行する必要があります。そうしないとリクエストは失敗します。
• URL、US ASCII文字のみを含むURL、URL、HTTP IETF標準文字セットを強くおすすめします。そうしないとリクエストが失敗します。

リールの制限

• リールはカルーセルに表示できません。
• 公開の際にはアカウントプライバシー設定が適用されます。例えば、リミックス許可が有効になっている場合、公開されるリールでは公開時にリミックスが有効になります。公開済みのリールのリミックスは、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秒
• ファイルサイズ: 最大300MB

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

• フォーマット: 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/v25.0/<YOUR_APP_USERS_IG_USER_ID>/media ?image_url=<IMAGE_URL> &is_carousel_item=<TRUE_OR_FALSE> &alt_text=<IMAGE_ALTERNATIVE_TEXT> &caption=<IMAGE_CAPTION> &location_id=<LOCATION_PAGE_ID> &user_tags=<ARRAY_OF_USERS_FOR_TAGGING>> &product_tags=<ARRAY_OF_PRODUCTS_FOR_TAGGING> &access_token=<USER_ACCESS_TOKEN>

リールコンテナ

標準アップロード

POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media ?media_type=REELS &video_url=<REEL_URL> &caption=<IMAGE_CAPTION> &share_to_feed=<TRUE_OR_FALSE> &collaborators=<COLLABORATOR_USERNAMES> &cover_url=<COVER_URL> &audio_name=<AUDIO_NAME> &user_tags=<ARRAY_OF_USERS_FOR_TAGGING>> &location_id=<LOCATION_PAGE_ID> &thumb_offset=<THUMB_OFFSET> &share_to_feed=<TRUE_OR_FALSE> &trial_params=<TRIAL_PARAM> &access_token=<USER_ACCESS_TOKEN>

再開可能なアップロードセッション

POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media ?media_type=REELS &upload_type=resumable &caption=<IMAGE_CAPTION> &collaborators=<COLLABORATOR_USERNAMES> &cover_url=<COVER_URL> &audio_name=<AUDIO_NAME> &user_tags=<ARRAY_OF_USERS_FOR_TAGGING>> &location_id=<LOCATION_PAGE_ID> &thumb_offset=<THUMB_OFFSET> &access_token=<USER_ACCESS_TOKEN>

成功した場合、応答でig-container-idとuriが返されます。これらは後続のステップで次のように使われます。

{
  "id": "<IG_CONTAINER_ID>",
  "uri": "https://rupload.facebook.com/ig-api-upload/v25.0/<IG_CONTAINER_ID>"
}

カルーセルコンテナ

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

標準アップロード

POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media ?media_type=CAROUSEL &caption=<IMAGE_CAPTION> &share_to_feed=<TRUE_OR_FALSE> &collaborators=<COLLABORATOR_USERNAMES> &location_id=<LOCATION_PAGE_ID> &product_tags=<ARRAY_OF_PRODUCTS_FOR_TAGGING> &children=<ARRAY_OF_CAROUSEL_CONTAINTER_IDS> &access_token=<USER_ACCESS_TOKEN>

再開可能なアップロードセッション

POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media ?media_type=VIDEO &is_carousel_item=true &upload_type=resumable &access_token=<USER_ACCESS_TOKEN>

成功した場合、応答でig-container-idとuriが返されます。これらは後続のステップで次のように使用されます。

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

POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media ?image_url=<IMAGE_URL> &media_type=STORIES &user_tags=<ARRAY_OF_USERS_FOR_TAGGING> &access_token=<USER_ACCESS_TOKEN>

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

標準アップロード

POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media ?video_url=<VIDEO_URL> &media_type=STORIES &user_tags=<ARRAY_OF_USERS_FOR_TAGGING> &access_token=<USER_ACCESS_TOKEN>

再開可能なアップロードセッション

POST https://graph.facebook.com/v25.0/<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media ?media_type=STORIES &upload_type=resumable &access_token=<USER_ACCESS_TOKEN>

成功すると、応答でInstagramコンテナIDとURIが返されます。これらは後続のステップで使用されます。

再開可能なアップロードプロトコルを介して動画をアップロードする

• すべてのmedia_typeは、同じフローを共有して動画をアップロードします。
• ig-container-idは、上記の再開可能なリール、カルーセル、動画コンテナのアップロードセッション例のIDです。
• access-tokenは、他のステップで使われているものと同じです。
• offsetは、アップロードされる最初のバイトに設定され、通常は0です。
• file_sizeは、バイト単位でファイルのサイズに設定されます。
• Your_file_local_pathは、ローカルファイルのファイルパスに設定されます。例えば、macOSでDownloadsフォルダーからファイルをアップロードする場合、パスは@Downloads/example.movです。

curl -X POST "https://rupload.facebook.com/ig-api-upload/v25.0/<IG_CONTAINER_ID>" \
     -H "Authorization: OAuth <USER_ACCESS_TOKEN>" \
     -H "offset: 0" \
     -H "file_size: Your_file_size_in_bytes" \
     --data-binary "@Your_local_file_path.extension"

成功した場合、次の例のような応答が表示されます。

{
  "success":true,
  "message":"Upload successful. ..."
}  

ホストされたURLから動画をアップロードする

このサービスは、ホストされたURLからの動画アップロードもサポートできます。

curl -X POST "https://rupload.facebook.com/ig-api-upload/v25.0/<IG_CONTAINER_ID>" \
     -H "Authorization: OAuth <USER_ACCESS_TOKEN>" \
     -H "file_url: <VIDEO_URL>"

パスパラメーター

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

応答

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

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

{
  "id":"<IG_CONTAINER_ID>"
}

リクエストの例

POST graph.facebook.com/17841400008460056/media
  ?image_url=curls//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 /<YOUR_APP_USERS_INSTAGRAM_USER_ID>/media

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

制限

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

要件

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

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

リクエストの例

GET graph.facebook.com/v25.0/17841405822304914/media

応答の例

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

更新

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

削除

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

参考情報

• エラーコード