ユーザーメディア

ユーザーのメディアのコレクションを表します。

作成

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

読み取り

GET /{user-id}/media

ユーザーのメディアのコレクションを取得します。

制限

ストーリーズはサポートされていません。
宣伝投稿内のメディアはサポートされていません。
最後に作成されたメディアの最大10Kを返します。

要件

タイプ	要件
アクセストークン	Instagramユーザー
アクセス許可	`instagram_graph_user_media`, `instagram_graph_user_profile`

リクエストの構文

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

パスパラメーター

プレースホルダー	値
`{api-version}` 文字列	APIバージョン。
`{user-id}` 必須文字列	アプリユーザーのapp-scoped user ID (バージョン11.0以降)または生ユーザーID (すべてのバージョン)。

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

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

キー	値
`access_token` 必須文字列	アプリユーザーのInstagramユーザーアクセストークン。
`fields` コンマ区切りリスト	結果セット内の各メディアノードのフィールド拡張機能によって戻り値を取得する、メディアフィールドのコンマ区切りリスト。
`since` タイムスタンプ	時間ベースのデータ範囲の始まりを指すUNIXタイムスタンプまたは`strtotime`データ値。時間ベースのページネーションをご覧ください。
`until` タイムスタンプ	時間ベースのデータ範囲の終わりを指すUNIXタイムスタンプまたは`strtotime`データ値。時間ベースのページネーションをご覧ください。

応答

リクエストしたデータを含むJSON形式のオブジェクト。

{
  "data": [],
  "paging": {}
}

応答の内容

プロパティ	値
`data`	ユーザーのメディアの配列。
`paging`	ページングカーソルと次/前のデータセット取得URLを含んでいるオブジェクト。

cURLの例

リクエスト

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171/media?access_token=IGQVJ...'

応答

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

更新

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

削除

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