IG 用戶

建立

不支援執行此作業。

GET /{ig-user-id}

取得 Instagram 商業帳號或創作者帳號的欄位和關係連線。

類型	說明
存取權杖	用戶。
企業管理平台角色	如果您要為商品標註要求 `shopping_product_tag_eligibility` 欄位，應用程式用戶在擁有 IG 用戶的 Instagram 商店的企業管理平台上，必須具有管理員角色。
Instagram 商店	如果您要為商品標註要求 `shopping_product_tag_eligibility` 欄位，IG 用戶必須擁有獲得批准的 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}`	必要項目。IG 用戶編號。

索引鍵	預留位置	值
`access_token`	`{access-token}`	必要項目。應用程式用戶的用戶存取權杖。
`fields`	`{fields}`	您想要在結果集中為每個 IG 用戶傳回之 IG 用戶欄位的逗號分隔清單。

使用欄位擴展可透過關係連線傳回公開欄位。

欄位名稱	說明
`biography` 公開	個人檔案簡介文字。
`id` 公開	應用程式範圍用戶編號。
`ig_id`	Instagram 用戶編號。搭配舊版 Instagram API 使用，現已停用。請改用 `id`。
`followers_count` 公開	追蹤該用戶的 Instagram 用戶總數。
`follows_count`	該用戶追蹤的 Instagram 用戶總數。
`media_count` 公開	用戶發佈的 IG 影音素材總數。
`name`	個人檔案名稱。
`profile_picture_url`	大頭貼照網址。
`shopping_product_tag_eligibility`	如果應用程式用戶已設定 Instagram 商店，因而有資格使用產品標註功能，則系統會傳回 `true`，否則會傳回 `false`。
`username` 公開	個人檔案用戶名稱。
`website` 公開	單一個人檔案網站網址。

關係連線	說明
`business_discovery`	取得其他 Instagram 商業或 Instagram 創作者 IG 用戶的相關資料。
`content_publishing_limit`	代表 IG 用戶的現有內容發佈使用量。
`insights`	代表 IG 用戶的社群互動衡量指標。
`live_media`	代表 IG 用戶的直播影片 IG 影音素材集合。
`media`	代表 IG 用戶的 IG 影音素材集合。
`media_publish`	在 Instagram 商業 IG 用戶上發佈 IG 容器。
`mentions`	在 IG 留言或提供說明的 IG 影音素材上建立 IG 留言，其中某位 IG 用戶在這則留言中加註 @ 提及另一位 Instagram 用戶。
`mentioned_comment`	取得一則 IG 留言的資料，其中某位 IG 用戶在這則留言中加註 @ 提及另一位 Instagram 用戶。
`mentioned_media`	取得一項 IG 影音素材的資料，其中某位 IG 用戶在這項說明文字中加註 @ 提及另一位 Instagram 用戶。
`recently_searched_hashtags`	取得 IG 用戶過去 7 天內搜尋的 IG 主題標籤。
`stories`	代表 IG 用戶的限時動態 IG 影音素材物件集合。
`tags`	代表 IG 影音素材集合，其中某位 IG 用戶在這個集合中標註另一位 Instagram 用戶。

JSON 格式物件，包含預設和要求的欄位和關係連線。

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

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/"
}

不支援執行此作業。

不支援執行此作業。