เรียกดูโปรไฟล์ผู้ใช้และสื่อของผู้ใช้

คู่มือนี้จะอธิบายวิธีเรียกดูโปรไฟล์และสื่อของผู้ใช้ Instagram

เรียกดูโปรไฟล์ของผู้ใช้

ทำตามขั้นตอนต่อไปนี้เพื่อเรียกดูข้อมูลโปรไฟล์ของผู้ใช้ Instagram (ช่อง) ในผู้ใช้

ขั้นตอนที่ 1: รับโทเค็นการเข้าถึงและสิทธิ์การอนุญาต

ทำตามคู่มือการเรียกดูโทเค็นการเข้าถึงและสิทธิ์การอนุญาต เพื่อเรียกดูโทเค็นการเข้าถึงผู้ใช้ Instagram ของผู้ใช้ คุณจะต้องมีสิทธิ์การอนุญาต instagram_graph_user_profile ด้วยเหตุนี้ ให้ส่งคำขอขอบเขต user_profile เมื่อคุณขออนุญาตจากผู้ใช้

ขั้นตอนที่ 2: สืบค้นโหนดผู้ใช้

ส่งคำขอไปยังตำแหน่งข้อมูลต่อไปนี้

GET /me?fields={fields}&access_token={access-token}

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

ตัวอย่างคำขอ

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

ตัวอย่างการตอบกลับ

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

รับสื่อของผู้ใช้

ทำตามขั้นตอนต่อไปนี้เพื่อเรียกดูคอลเลกชั่นสื่อของผู้ใช้ Instagram

ขั้นตอนที่ 1: รับโทเค็นการเข้าถึงและสิทธิ์การอนุญาต

ทำตามคู่มือการเรียกดูโทเค็นการเข้าถึงและสิทธิ์การอนุญาต เพื่อเรียกดูโทเค็นการเข้าถึงผู้ใช้ Instagram ของผู้ใช้ คุณจะต้องมีสิทธิ์การอนุญาต instagram_graph_user_profile และ instagram_graph_user_media permissions ด้วยเหตุนี้ ให้ส่งคำขอขอบเขต user_profile และ user_media เมื่อคุณขออนุญาตจากผู้ใช้

ขั้นตอนที่ 2: สืบค้นจุดเชื่อมโยงสื่อของผู้ใช้

ส่งคำขอไปยังตำแหน่งข้อมูลต่อไปนี้

GET /me/media?fields={fields}&access_token={access-token}

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

ตัวอย่างคำขอ

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

ตัวอย่างการตอบกลับ

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

รับข้อมูลสื่อ

ทำตามขั้นตอนต่อไปนี้เพื่อเรียกดูข้อมูล (ช่อง) เกี่ยวกับรูปภาพ วิดีโอ หรืออัลบั้ม

ขั้นตอนที่ 1: รับโทเค็นการเข้าถึงและสิทธิ์การอนุญาต

ทำตามคู่มือการเรียกดูโทเค็นการเข้าถึงและสิทธิ์การอนุญาต เพื่อเรียกดูโทเค็นการเข้าถึงผู้ใช้ Instagram ของผู้ใช้ คุณจะต้องมีสิทธิ์การอนุญาต instagram_graph_user_media ด้วยเหตุนี้ ให้ส่งคำขอขอบเขต user_media เมื่อคุณขออนุญาตจากผู้ใช้

ขั้นตอนที่ 2: สืบค้นโหนดสื่อ

ส่งคำขอไปยังตำแหน่งข้อมูลต่อไปนี้

GET /{media-id}?fields={fields}&access_token={access-token}

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

ตัวอย่างคำขอ

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

ตัวอย่างการตอบกลับ

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

ขั้นตอนที่ 2 (ทางเลือก): สืบค้นจุดเชื่อมโยงสื่อของผู้ใช้

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

GET /me/media?fields={fields}&access_token={access-token}

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

ตัวอย่างคำขอ

curl -X GET \
  'https://graph.instagram.com/me/media?fields=id,caption&access_token=IGQVJ...'

ตัวอย่างการตอบกลับ

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

รับเนื้อหาแบบอัลบั้ม

ทำตามขั้นตอนต่อไปนี้เพื่อเรียกดูคอลเลกชั่นสื่อแบบรูปภาพและวิดีโอในสื่อแบบอัลบั้ม

ขั้นตอนที่ 1: รับโทเค็นการเข้าถึงและสิทธิ์การอนุญาต

ทำตามคู่มือการเรียกดูโทเค็นการเข้าถึงและสิทธิ์การอนุญาต เพื่อเรียกดูโทเค็นการเข้าถึงผู้ใช้ Instagram ของผู้ใช้ คุณจะต้องมีสิทธิ์การอนุญาต instagram_graph_user_media ด้วยเหตุนี้ ให้ส่งคำขอขอบเขต user_media เมื่อคุณขออนุญาตจากผู้ใช้

ขั้นตอนที่ 2: สืบค้นจุดเชื่อมโยงรองของสื่อ

ส่งคำขอไปยังตำแหน่งข้อมูลต่อไปนี้

GET /{media-id}/children?fields={fields}&access_token={access-token}

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

ตัวอย่างคำขอ

curl -X GET \
  'https://graph.instagram.com/17896450804038745/children?access_token=IGQVJ...'

ตัวอย่างการตอบกลับ

{
  "data": [
    {
      "id": "17880997618081620"
    },
    {
      "id": "17871527143187462"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "previous": "https://graph.faceb...",
    "next": "https://graph.faceb..."
  }
}