وسائط المستخدم

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.

تمثل مجموعة من الوسائط حول المستخدم.

الإنشاء

هذه العملية غير مدعومة.

القراءة

GET /{user-id}/media

يمكن الحصول على مجموعة من الوسائط حول المستخدم.

القيود

القصص غير مدعومة.
الوسائط في المنشورات المروّج لها غير مدعومة.
يمكن إرجاع 10 آلاف كحد أقصى من أحدث الوسائط التي تم إنشاؤها.

المتطلبات

النوع	المطلب
رموز الوصول	مستخدم 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}` مطلوب سلسلة	معرف المستخدم على مستوى التطبيق لمستخدم التطبيق (الإصدار 11.0 والإصدارات الأحدث) أو معرف المستخدم الأولي (كل الإصدارات).

معلمات سلسلة الاستعلام

يمكن تضمين معلمات سلسلة الاستعلام التالية لتعزيز الطلب.

المفتاح	القيمة
`access_token` مطلوبة String (سلسلة)	يمثل رمز وصول مستخدم Instagram لدى مستخدم التطبيق.
`fields` قائمة مفصولة بفاصلة	يمثل قائمة مفصولة بفاصلة تضم حقول الوسائط التي تريد إرجاعها من خلال توسيع الحقل لكل عقدة وسائط في مجموعة النتائج.
طابع زمني`since`	يمثل طابعًا زمنيًا بتنسيق Unix أو قيمة بيانات `strtotime` تشير إلى بداية نطاق البيانات المستندة إلى الوقت. يمكنك الاطلاع على تقسيم الصفحات استنادًا إلى الوقت.
طابع زمني`until`	يمثل طابعًا زمنيًا بتنسيق Unix أو قيمة بيانات `strtotime` تشير إلى نهاية نطاق البيانات المستندة إلى الوقت. يمكنك الاطلاع على تقسيم الصفحات استنادًا إلى الوقت.

الاستجابة

كائن بتنسيق لغة JSON يتضمن البيانات التي طلبتها.

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

محتويات الاستجابة

الخاصية	القيمة
`data`	يمثل مصفوفة من الوسائط حول المستخدم.
`paging`	يمثل كائن يحتوي على مؤشرات تقسيم الصفحات وعناوين URL لاسترداد مجموعات البيانات التالية/السابقة.

مثال على cURL

الطلب

curl -X GET \
  'https://graph.instagram.com/v21.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..."
  }
}

التحديث

هذه العملية غير مدعومة.

الحذف

هذه العملية غير مدعومة.