ผู้ใช้

เป็นตัวแทนโปรไฟล์ผู้ใช้ Instagram

ID ผู้ใช้ในแอพ (ASID) ได้รับการนำมาใช้กับ API เวอร์ชั่น 11.0 คุณจะยังสืบค้นผู้ใช้ต่อไปได้โดยใช้ ID ผู้ใช้ดิบของผู้ใช้เหล่านั้นหรือ ASID ที่เทียบเท่า ทั้งนี้หากใช้เวอร์ชั่น 11.0 ขึ้นไป ระบบจะตอบกลับเป็น ASID

ASID จะเข้ามาแทนที่ ID ผู้ใช้ดิบภายในเวลาประมาณ 2 ปีเมื่อระบบเลิกใช้เวอร์ชั่น 10.0 ดังนั้นเราขอแนะนำให้คุณเริ่มจับคู่ผู้ใช้แอพของคุณเข้ากับ ASID ที่เทียบเท่าของผู้ใช้เหล่านั้น

การสร้าง

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

การอ่าน

GET /{user-id}

รับฟิลด์และจุดเชื่อมโยงของผู้ใช้

ข้อจำกัด

ระบบไม่รองรับ ID ผู้ใช้ API แบบเดิมบน Instagram

ข้อกำหนด

ประเภท	ข้อกำหนด
โทเค็นการเข้าถึง	ผู้ใช้ Instagram
สิทธิ์การอนุญาต	ต้องมี `instagram_graph_user_profile` โดยช่อง`media_count` จะต้องมี `instagram_graph_user_media` ด้วย

รูปแบบคำสั่งของคำขอ

GET https://graph.instagram.com/{api-version}/{user-id}
  ?fields={fields}
  &access_token={access-token}

พารามิเตอร์พาธ

ตัวยึดตำแหน่ง	ค่า
`{api-version}` สตริง	เวอร์ชั่นของ API
`{user-id}` ต้องระบุ สตริง	ID ผู้ใช้ในแอพของผู้ใช้แอพ (เวอร์ชั่น 11.0 ขึ้นไป) หรือ ID ผู้ใช้ดิบ (ทุกเวอร์ชั่น)

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

เพิ่มพารามิเตอร์สตริงการสืบค้นต่อไปนี้เพื่อเสริมคำขอ

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

ช่อง

คุณสามารถใช้พารามิเตอร์สตริงการสืบค้น fields เพื่อส่งคำขอช่องต่อไปนี้สำหรับผู้ใช้ได้

ชื่อช่อง	คำอธิบาย
`account_type`	ประเภทบัญชีของผู้ใช้ โดยอาจเป็น `BUSINESS`, `MEDIA_CREATOR` หรือ `PERSONAL` ก็ได้
`id`	ID ในแอพของผู้ใช้แอพ (เวอร์ชั่น 11.0 ขึ้นไป) หรือ ID ผู้ใช้ดิบ (เวอร์ชั่น 10.0 และก่อนหน้า)
`media_count`	จำนวนของสื่อสำหรับผู้ใช้ ช่องนี้ต้องมีสิทธิ์การอนุญาต `instagram_graph_user_media`
`username`	ชื่อผู้ใช้ของผู้ใช้

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

คุณสามารถส่งคำขอจุดเชื่อมโยงต่อไปนี้เป็นพารามิเตอร์พาธหรือโดยใช้พารามิเตอร์สตริงการสืบค้น fields

จุดเชื่อมโยง	คำอธิบาย
`media`	รับรายการสื่อสำหรับผู้ใช้

การตอบกลับ

อ็อบเจ็กต์รูปแบบ JSON ที่ประกอบด้วยช่องและจุดเชื่อมโยงเริ่มต้นและที่ส่งคำขอ

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

ตัวอย่าง cURL

คำขอ

curl -X GET \
  'https://graph.instagram.com/v21.0/10218560180051171?fields=id,username&access_token=IGQVJ...'

การตอบกลับ

{
  "id": "17841405793187218",
  "username": "jayposiris"
}

การอัพเดต

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

การลบ

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