ผู้ใช้ Instagram

หมายถึงบัญชีธุรกิจบน Instagram หรือบัญชีครีเอเตอร์บน Instagram

ในเอกสารประกอบของเรา เราใช้คำว่า "ผู้ใช้ Instagram" และ "บัญชี Instagram" แทนกันได้ ทั้ง 2 คำนี้แสดงถึงบัญชีมืออาชีพบน 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 Business และบัญชีครีเอเตอร์

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>`	จำเป็นต้องระบุ ID ผู้ใช้ Instagram

พารามิเตอร์สตริงการสืบค้น

คีย์	ตัวยึดตำแหน่ง	ค่า
`access_token`	`<ACCESS_TOKEN>`	จำเป็นต้องระบุ โทเค็นการเข้าถึงผู้ใช้ของผู้ใช้แอพ
`fields`	`<LIST_OF_FIELDS>`	รายการช่องของผู้ใช้ Instagram ที่คั่นด้วยเครื่องหมายจุลภาคที่คุณต้องการให้ส่งคืนสำหรับผู้ใช้ Instagram แต่ละรายในชุดผลลัพธ์

ช่อง

จุดเชื่อมโยงสามารถส่งคืนช่องสาธารณะได้โดยใช้การขยายเงื่อนไขในช่อง มีเพียงไม่กี่ช่องเท่านั้นที่จะพร้อมใช้งานสำหรับการเข้าถึงบัญชี Instagram ที่มีเพจอยู่เบื้องหลัง

ชื่อช่อง	คำอธิบาย
`alt_text` สาธารณะ	ข้อความอธิบายรูปภาพเพื่อช่วยในการเข้าถึง
`biography` สาธารณะ	ข้อความคำอธิบายตัวเองบนโปรไฟล์
`followers_count` สาธารณะ	จำนวนผู้ใช้ Instagram ทั้งหมดที่กำลังติดตามผู้ใช้
`follows_count`	จำนวนผู้ใช้ Instagram ทั้งหมดที่ผู้ใช้ติดตามอยู่
`has_profile_pic`	ระบุว่าบัญชีมืออาชีพบน Instagram ของผู้ใช้แอพของคุณมีรูปโปรไฟล์หรือไม่
`id` สาธารณะ	ID ผู้ใช้ในแอพ พร้อมใช้งานสำหรับบัญชี Instagram ที่มีเพจอยู่เบื้องหลัง
`is_published`	ระบุว่าบัญชี Instagram ของผู้ใช้แอพของคุณได้รับการเผยแพร่หรือไม่ พร้อมใช้งานสำหรับบัญชี Instagram ที่มีเพจอยู่เบื้องหลัง
`legacy_instagram_user_id`	Instagram ID ของผู้ใช้แอพที่สร้างขึ้นสำหรับตำแหน่งข้อมูล API การตลาดสำหรับเวอร์ชั่น 21.0 และเวอร์ชั่นก่อนหน้า พร้อมใช้งานสำหรับบัญชี Instagram ที่มีเพจอยู่เบื้องหลัง
`media_count` สาธารณะ	จำนวนสื่อบน Instagram ทั้งหมดที่เผยแพร่ในบัญชีของผู้ใช้แอพของคุณ
`name`	ชื่อโปรไฟล์ Instagram ของผู้ใช้แอพของคุณ
`profile_picture_url`	URL รูปโปรไฟล์ Instagram ของผู้ใช้แอพของคุณ
`collaborative_media_search`	ค้นหาสื่อร่วมที่เฉพาะเจาะจงตาม ID เข้าถึงผ่านการขยายช่อง ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น
`shopping_product_tag_eligibility`	ส่งคืนค่า `true` หากผู้ใช้แอพของคุณได้ตั้งค่าร้านค้าบน Instagram เอาไว้ และจะมีสิทธิ์ในการแท็กสินค้า แต่หากไม่ได้ตั้งค่า จะส่งคืนค่าเป็น `false`
`username` สาธารณะ	ชื่อผู้ใช้โปรไฟล์ Instagram ของผู้ใช้แอพของคุณ
`website` สาธารณะ	URL เว็บไซต์ของผู้ใช้แอพของคุณ

จุดเชื่อมโยง

จุดเชื่อมโยง	คำอธิบาย
`agencies`	รายการธุรกิจที่สามารถลงโฆษณาสำหรับบัญชีมืออาชีพบน Instagram นี้ได้
`authorized_adaccounts`	บัญชีโฆษณาที่สามารถลงโฆษณาสำหรับบัญชีมืออาชีพบน Instagram นี้ได้
`business_discovery`	รับข้อมูลเกี่ยวกับผู้ใช้ Instagram ที่ใช้บัญชี Instagram Business หรือบัญชีครีเอเตอร์บน Instagram รายอื่นๆ
`connected_threads_user`	แสดงถึงบัญชี Threads ที่เชื่อมโยงกับบัญชี Instagram
`content_publishing_limit`	แสดงถึงการใช้งานการเผยแพร่เนื้อหาในปัจจุบันของผู้ใช้ Instagram
`insights`	แสดงถึงเกณฑ์ชี้วัดการโต้ตอบทางโซเชียลของผู้ใช้ Instagram
`instagram_backed_threads_user`	แสดงถึงบัญชี Threads ที่มีบัญชี Instagram รองรับ
`live_media`	แสดงถึงคอลเลกชั่นสื่อบน Instagram ที่เป็นวิดีโอถ่ายทอดสดของผู้ใช้ Instagram
`media`	แสดงถึงคอลเลกชั่นสื่อบน Instagram ของผู้ใช้ Instagram
`media_publish`	เผยแพร่คอนเทนเนอร์ Instagram ของผู้ใช้ Instagram ที่ใช้ Instagram Business
`mentions`	สร้างความคิดเห็นบน Instagram ในส่วนความคิดเห็นบน Instagram หรือสื่อบน Instagram ที่มีคำบรรยาย ซึ่งผู้ใช้ Instagram ได้รับการ @กล่าวถึง จากผู้ใช้ Instagram รายอื่น
`mentioned_comment`	รับข้อมูลเกี่ยวกับความคิดเห็นบน Instagram ที่ผู้ใช้ Instagram ได้รับการ @กล่าวถึง จากผู้ใช้ Instagram รายอื่น
`mentioned_media`	รับข้อมูลเกี่ยวกับสื่อบน Instagram ที่ผู้ใช้ Instagram ได้รับการ @กล่าวถึง ในคำบรรยายจากผู้ใช้ Instagram รายอื่น
`recently_searched_hashtags`	รับแฮชแท็กบน Instagram ที่ผู้ใช้ Instagram ได้ทำการค้นหาภายใน 7 วันที่ผ่านมา
`stories`	แสดงถึงคอลเล็กชั่นของอ็อบเจ็กต์สื่อบน Instagram ที่เป็นสตอรี่ของผู้ใช้ Instagram
`tags`	แสดงถึงคอลเลกชั่นสื่อบน Instagram ที่ผู้ใช้ Instagram ได้รับการติดแท็กจากผู้ใช้ Instagram รายอื่น
`upcoming_events`	รายการเหตุการณ์ที่บัญชีมืออาชีพบน Instagram นี้กำลังโฮสต์อยู่
`collaboration_invites`	แสดงคอลเลกชั่นคุณลักษณะของอ็อบเจ็กต์ `IG Media` (media_id, media_owner_username, caption, media_url) ที่ผู้ใช้ Instagram ได้รับเชิญให้มีส่วนร่วม
`collaborative_media`	แสดงถึงคอลเลกชั่นสื่อบน IG ในกรณีที่ผู้ใช้ Instagram เป็นผู้มีส่วนร่วมที่ได้รับการยอมรับ ไม่รวมสื่อที่ผู้ใช้เป็นเจ้าของโดยตรง ใช้งานได้กับ Instagram API ที่ใช้การเข้าสู่ระบบด้วย Facebook เท่านั้น

การตอบกลับ

อ็อบเจ็กต์รูปแบบ 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/"
}

การอัพเดต

ระบบไม่รองรับการดำเนินการนี้

การลบ

ระบบไม่รองรับการดำเนินการนี้