メディア

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

作成

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

読み取り

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`	メディアのキャプションテキスト。アルバム内のメディアについては返すことができません。
`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"
}

更新

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

削除

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