メディア

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

作成

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

読み取り

GET /{media-id}

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

要件

リクエストの構文

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

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

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

キー

access_token
必須
文字列

アプリユーザーのInstagramユーザーアクセストークン

fields
コンマ区切りリスト

結果として返すフィールドエッジのコンマ区切りリスト。省略した場合、デフォルトのフィールドが返されます。

フィールド

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

フィールド名説明

caption

メディアのキャプションテキスト。アルバム中のメディアについては返すことができません。

id

メディアのID。

media_type

メディアのタイプ。IMAGEVIDEO、または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" }

更新

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

削除

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