เอกสารนี้นี้ได้รับการอัพเดตแล้ว
คำแปลเป็น ภาษาไทย ยังไม่เสร็จสมบูรณ์

ภาษาอังกฤษที่อัพเดต: 4 ก.ย.
ภาษาไทย ที่อัพเดต: 25 เม.ย. 2023

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

Media Children

Represents a collection of image and video Media on an album Media.

Creating

This operation is not supported.

Reading

GET /{media-id}/children

Get a collection of image and video Media on an album Media.

Requirements

Type	Requirement
Access Tokens	Instagram User
Permissions	`instagram_graph_user_media`

Request Syntax

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

Query String Parameters

Include the following query string parameters to augment the request.

Key	Value
`access_token` Required String	The app user's Instagram User Access Token.
`fields` Comma-separated list	A comma-separated list of Media fields you want returned by field-expansion for each Media node in the result set.

Response

A JSON-formatted object containing the data you requested.

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

Response Contents

Property	Value
`data`	An array of image and video Media on the album Media.
`paging`	An object containing paging cursors and next/previous data set retrievial URLs.

cURL Example

Request

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

Response

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

Updating

This operation is not supported.

Deleting

This operation is not supported.