建立

不支援這項操作。

讀取

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 創作者 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/"
}

更新

不支援這項操作。

刪除

不支援這項操作。