ผู้ใช้ Instagram

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

การสร้าง

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

การอ่าน

GET /{ig-user-id}

รับช่องและจุดเชื่อมโยงบนบัญชี Instagram Business และบัญชีครีเอเตอร์

ข้อกำหนด

ประเภท	คำอธิบาย
โทเค็นการเข้าถึง	ผู้ใช้
บทบาททางธุรกิจ	หากคุณจะส่งคำขอช่อง `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}`	จำเป็นต้องระบุ ID ผู้ใช้ Instagram

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

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

ช่อง

จุดเชื่อมโยงสามารถส่งคืนช่องสาธารณะได้โดยใช้ส่วนขยายช่อง

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

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

จุดเชื่อมโยง	คำอธิบาย
`business_discovery`	รับข้อมูลเกี่ยวกับผู้ใช้ Instagram ที่ใช้บัญชี Instagram Business หรือบัญชีครีเอเตอร์บน Instagram รายอื่นๆ
`content_publishing_limit`	หมายถึงการใช้งานการเผยแพร่เนื้อหาในปัจจุบันของผู้ใช้ Instagram
`insights`	หมายถึงเกณฑ์ชี้วัดการโต้ตอบทางโซเชียลของผู้ใช้ 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 รายอื่น

การตอบกลับ

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

การอัพเดต

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

การลบ

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