创建

不支持此操作。

读取

GET /{ig-user-id}

通过 Instagram 业务帐户或创作者帐户获取字段和连线。

要求

类型描述

访问口令

用户

商务管理平台用户身份

如果要为商品标记请求 shopping_product_tag_eligibility 字段,应用用户必须在此 Instagram 用户的 Instagram 店铺所属的商务管理平台上具有管理员身份。

Instagram 店铺

如果要为商品标记请求 shopping_product_tag_eligibility 字段,Instagram 用户必须拥有已获批准的 Instagram 店铺,以及包含商品的商品目录。

权限

instagram_basic
pages_read_engagement
pages_show_list


如果应用用户已通过商务管理平台获得公共主页用户身份,则您还需要具备以下权限之一:


ads_management
business_management


如果要为商品标记请求 shopping_product_tag_eligibility 字段,您还需要以下权限:


catalog_management
instagram_shopping_tag_products

请求语法

GET https://graph.facebook.com/{api-version}/{ig-user-id}
  ?fields={fields}
  &access_token={access-token}

路径参数

占位符

{api-version}

API 版本

{ig-user-id}

必要。Instagram 用户编号。

查询字符串参数

占位符

access_token

{access-token}

必要。应用用户的用户访问口令。

fields

{fields}

您希望系统针对结果集中的每个 Instagram 用户,返回的以英文逗号分隔的 Instagram 用户字段列表。

字段

公开字段可由连线使用字段扩展返回。

字段名称描述

biography
公开

个人主页个性签名文本。

id
公开

应用范围用户编号。

ig_id

Instagram 用户编号。用于旧版 Instagram API,现已停用。改用 id

followers_count
公开

关注特定用户的 Instagram 用户总数。

follows_count

特定用户关注的 Instagram 用户总数。

media_count
公开

特定用户发布的 Instagram 媒体总数。

name

个人主页名称。

profile_picture_url

头像网址。

shopping_product_tag_eligibility

如果应用用户开设 Instagram 店铺并因此有资格标记商品,则会传回 true,否则传回 false

username
公开

个人主页帐号。

website
公开

一个个人主页网址。

连线

连线描述

business_discovery

获取关于其他 Instagram 商家或 Instagram 创作者用户的数据。

content_publishing_limit

表示 Instagram 用户当前对内容发布功能的使用情况。

insights

代表 Instagram 用户的社交互动指标。

live_media

代表 Instagram 用户的直播视频 Instagram 媒体集合。

media

代表 Instagram 用户Instagram 媒体的集合。

media_publish

在 Instagram Business 的 Instagram 用户上发布 Instagram 容器

mentions

针对 Instagram 评论或带有说明的 Instagram 媒体(某个 Instagram 用户在其中 @ 提及了另一位 Instagram 用户)创建 Instagram 评论

mentioned_comment

获取特定 Instagram 评论的数据,此类评论中,某个 Instagram 用户 @ 提及了另一位 Instagram 用户。

mentioned_media

获取特定 Instagram 媒体的数据,此类媒体中,某位 Instagram 用户在说明中 @ 提及了另一位 Instagram 用户。

recently_searched_hashtags

获取 Instagram 用户过去 7 天内搜索过的 Instagram 话题标签

stories

代表 Instagram 用户的快拍 Instagram 媒体对象的集合。

tags

代表特定 Instagram 媒体的集合,此类集合中某个 Instagram 用户受到了其他 Instagram 用户的标记。

响应

JSON 格式的对象包含默认和请求的字段连线

{
  "{field}":"{value}",
  ...
}

cURL 示例

请求

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914?fields=biography%2Cid%2Cusername%2Cwebsite&access_token=EAACwX...'

响应

{
  "biography": "Dino data crunching app",
  "id": "17841405822304914",
  "username": "metricsaurus",
  "website": "http://www.metricsaurus.com/"
}

更新

不支持此操作。

删除

不支持此操作。