สื่อผู้ใช้

คือคอลเลกชั่นของสื่อสำหรับผู้ใช้

การสร้าง

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

การอ่าน

GET /{user-id}/media

รับคอลเลกชั่นของสื่อสำหรับผู้ใช้

ข้อจำกัด

ระบบไม่รองรับสตอรี่
ระบบไม่รองรับสื่อในโพสต์ที่ถูกโปรโมท
ส่งคืนสื่อที่เพิ่งสร้างขึ้นส่วนใหญ่ได้สูงสุด 10,000 รายการ

ข้อกำหนด

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

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

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

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

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

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

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

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

การตอบกลับ

อ็อบเจ็กต์รูปแบบ JSON ที่มีข้อมูลที่คุณส่งคำขอ

{
  "data": [],
  "paging": {}
}

เนื้อหาของการตอบกลับ

คุณสมบัติ	ค่า
`data`	อาร์เรย์ของสื่อสำหรับผู้ใช้
`paging`	อ็อบเจ็กต์ที่ประกอบด้วยเคอร์เซอร์การแบ่งหน้าและ URL การดึงชุดข้อมูลถัดไป/ก่อนหน้า

ตัวอย่าง cURL

คำขอ

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171/media?access_token=IGQVJ...'

การตอบกลับ

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

การอัพเดต

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

การลบ

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