IG 用戶

在本文件中，「Instagram 用戶」和「Instagram 帳號」會交替使用。兩者都代表應用程式用戶的 Instagram 專業帳號。

Requirements

	Instagram API with Instagram Login	Instagram API with Facebook Login
Access Tokens	Instagram User user access token	Facebook User access token
Host URL	`graph.instagram.com`	`graph.facebook.com`
Login Type	Business Login for Instagram	Facebook Login for Business
Permissions	`instagram_business_basic`	`instagram_basic` `pages_read_engagement` If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of: `ads_management` `ads_read` If you are requesting the `shopping_product_tag_eligibility` field for product tagging, you will also need: `catalog_management` `instagram_shopping_tag_products`
Business Roles	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the app user must have an admin role on the Business Manager that owns the IG User's Instagram Shop.
Instagram Shop	Not applicable.	If you are requesting the `shopping_product_tag_eligibility` field for product tagging, the IG User must have an approved Instagram Shop with a product catalog containing products.

建立

不支援執行此作業。

讀取

GET /<IG_USER_ID>

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

If you are migrating from Marketing API Instagram Ads endpoints to Instagram Platform endpoints, be aware that some field names are different.

要求語法

GET https://graph.facebook.com/<API_VERSION>/<IG_USER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

路徑參數

預留位置	值
`<API_VERSION>`	API 版本。
`<IG_USER_ID>`	必要項目。IG 用戶編號。

查詢字串參數

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

欄位

使用欄位擴展可透過關係連線傳回公開欄位。只有少數欄位可用於存取粉絲專頁型 Instagram 帳號。

欄位名稱	說明
`alt_text` 公開	無障礙環境的圖像說明文字。
`biography` 公開	個人檔案簡介文字。
`followers_count` 公開	追蹤該用戶的 Instagram 用戶總數。
`follows_count`	該用戶追蹤的 Instagram 用戶總數。
`has_profile_pic`	指明應用程式用戶的 Instagram 專業帳號是否有大頭貼照。
`id` 公開	應用程式範圍用戶編號。適用於粉絲專頁型 Instagram 帳號。
`is_published`	指明應用程式用戶的 Instagram 帳號是否已發佈。適用於粉絲專頁型 Instagram 帳號。
`legacy_instagram_user_id`	為 21.0 和以下版本行銷 API 端點建立的應用程式用戶 Instagram 編號。適用於粉絲專頁型 Instagram 帳號。
`media_count` 公開	應用程式用戶帳號發佈的 IG 影音內容總數。
`name`	應用程式用戶的 Instagram 個人檔案名稱。
`profile_picture_url`	應用程式用戶的 Instagram 大頭貼照網址。
`collaborative_media_search`	依編號查詢特定協作影音內容。透過欄位擴充存取。僅適用於含有 Facebook 登入的 Instagram API。
`shopping_product_tag_eligibility`	如果應用程式用戶已設定 Instagram 商店，因而有資格使用商品標註功能，系統會傳回 `true`，否則會傳回 `false`。
`username` 公開	應用程式用戶的 Instagram 個人檔案用戶名稱。
`website` 公開	應用程式用戶的網站網址。

關係連線

關係連線	說明
`agencies`	可以為此 Instagram 專業帳號刊登廣告的商家清單。
`authorized_adaccounts`	可以為此 Instagram 專業帳號刊登廣告的廣告帳號。
`business_discovery`	取得其他 Instagram 商業或 Instagram 創作者 IG 用戶的相關資料。
`connected_threads_user`	代表連結到 Instagram 帳號的 Threads 帳號。
`content_publishing_limit`	代表 IG 用戶的現有內容發佈使用量。
`insights`	代表 IG 用戶的社群互動衡量指標。
`instagram_backed_threads_user`	代表由 Instagram 帳號支援的 Threads 帳號。
`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 用戶。
`upcoming_events`	此 Instagram 專業帳號即將舉辦的活動清單。
`collaboration_invites`	代表 IG 用戶已受邀協作的 `IG Media` 物件屬性（media_id、media_owner_username、caption、media_url）集合。
`collaborative_media`	代表 IG 用戶作為已接受的協作者的 IG 影音內容集合。不包含用戶直接擁有的影音內容。僅適用於含有 Facebook 登入的 Instagram API。

回應

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

{
  "<FIELD>":"<VALUE>",
  ...
}

cURL 範例

要求

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

回應

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

更新

不支援執行此作業。

刪除

不支援執行此作業。