素材

代表图片、视频或相册。

创建

不支持此操作。

读取

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`	素材编号。
`is_shared_to_feed`	仅适用于 Reels。如果为 `true`，表示 Reels 可以同时在动态和 Reels 选项卡中显示。如果为 `false`，则表示 Reels 只可在 Reels 选项卡中显示。这两个值都不表示 Reels 是否实际显示在 Reels 选项卡中，因为 Reels 可能不符合资格要求或未被我们的算法选中。有关资格标准，请参阅 Reels 规范。
`media_type`	素材类型。可以是 `IMAGE`、`VIDEO` 或 `CAROUSEL_ALBUM`。
`media_url`	素材网址。
`permalink`	素材的永久网址。如果素材包含受版权保护的内容，或者已被标记为侵犯版权，系统会删除此网址。
`thumbnail_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"
}

更新

不支持此操作。

删除

不支持此操作。