媒体

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

代表图片、视频或相册。

创建

不支持此操作。

读取

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`	素材的说明文本。相册中的素材不可返回。注意：在文字说明中使用表情时，编码格式应该为 UTF-8，字符长度可能因使用的表情而有所不同。
`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"
}

更新

不支持此操作。

删除

不支持此操作。