メディア

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

画像、動画、またはアルバムを表します。

作成

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

読み取り

GET /{media-id}

画像、動画、またはアルバムのフィールドおよびエッジを取得します。

要件

型	要件
アクセストークン	Instagramユーザー
アクセス許可	`instagram_graph_user_media`

リクエストの構文

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

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

リクエストに以下のクエリ文字列パラメーターを追加します。

キー	値
`access_token` 必須文字列	アプリユーザーのInstagramユーザーアクセストークン。
`fields` コンマ区切りリスト	結果として返すフィールドとエッジのコンマ区切りリスト。省略した場合、デフォルトのフィールドが返されます。

フィールド

メディアの以下のフィールドをリクエストするには、fieldsクエリ文字列パラメーターを使用します。

フィールド名	説明
`caption`	メディアのキャプションテキスト。アルバム内のメディアについては返すことができません。注: キャプションに絵文字を使う場合、エンコーディングフォーマットはUTF-8でなければなりません。また、使う絵文字によっては文字の長さが影響を受ける場合があります。
`id`	メディアのID。
`is_shared_to_feed`	リールのみ。`true`の場合、リール動画は[フィード]タブと[リール]タブの両方に表示されます。`false`の場合、リール動画は[リール]タブだけに表示されます。これらの値はどちらも、リール動画が実際に[リール]タブに表示されるかどうかを決定するものではありません。リール動画が利用条件を満たしていない場合や、当社のアルゴリズムで選択されない場合があるからです。利用要件については、リール仕様をご覧ください。
`media_type`	メディアのタイプ。`IMAGE`、`VIDEO`、`CAROUSEL_ALBUM`のいずれか。
`media_url`	メディアのURL。
`permalink`	メディアの永続URL。メディアに著作権対象コンテンツが含まれている場合、または著作権違反のフラグが付いている場合は除外されます。
`thumbnail_url`	メディアのサムネイル画像のURL。`VIDEO`メディアでのみ使用可能。
`timestamp`	メディアの公開日付(ISO 8601形式)。
`username`	メディア所有者のユーザーネーム。

エッジ

以下のエッジを、パスパラメーターとして指定したり、fieldsクエリ文字列パラメーターを使用したりしてリクエストできます。

エッジ	説明
`children`	メディアアルバム上のメディアのリストを取得します。`CAROUSEL_ALBUM`メディアでのみ使用可能。

応答

デフォルトとリクエストのフィールドおよびエッジを含む、JSON形式のオブジェクト。

{
  "{field}":"{value}",
  ...
}

cURLの例

リクエスト

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

応答

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

更新

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

削除

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