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

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

الإنشاء

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

القراءة

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/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..."
  }
}

التحديث

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

الحذف

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