メディア

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

作成

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

読み取り

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。
`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" }

更新

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

削除

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