الوسائط

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 /{media-id}

يمكن الحصول على الحقول وعناصر الربط المتوفرة ضمن صورة أو فيديو أو ألبوم.

المتطلبات

النوع	المطلب
رموز الوصول	مستخدم Instagram
الأذونات	`instagram_graph_user_media`

بنية الطلب

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

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

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

المفتاح	القيمة
`access_token` مطلوبة String (سلسلة)	يمثل رمز وصول مستخدم Instagram لدى مستخدم التطبيق.
`fields` قائمة مفصولة بفاصلة	قائمة مفصولة بفاصلة تتضمن الحقول وعناصر الربط التي ترغب في إرجاعها. إذا تم حذفها، فسيتم إرجاع الحقول الافتراضية.

الحقول

يمكنك استخدام معلمة سلسلة الاستعلام fields لطلب الحقول التالية في الوسائط.

اسم الحقل	الوصف
`caption`	نص الشرح التوضيحي للوسائط. غير قابل للإرجاع للوسائط الموجودة في الألبومات. ملاحظة: عند استخدام الرموز التعبيرية في الشروح التوضيحية، يجب أن يكون تنسيق الترميز UTF-8 وقد يتأثر طول الأحرف استنادًا إلى الرمز التعبيري المستخدم.
`id`	معرف الوسائط.
`is_shared_to_feed`	لمقاطع ريلز فقط. عندما تكون القيمة `true`، يشير ذلك إلى إمكانية ظهور مقطع ريلز في علامتي التبويب الموجز وريلز. وعندما تكون القيمة `false`، هذا يشير إلى أن مقطع ريلز لا يمكنه الظهور سوى في علامة التبويب ريلز. لاحظ أن القيمتين لا تحددان ما إذا كان مقطع ريلز يظهر بالفعل في علامة التبويب ريلز، نظرًا لأن مقطع ريلز قد لا يفي بمتطلبات الأهلية أو قد لا يتم تحديده بواسطة الخوارزمية لدينا. راجع مواصفات مقطع ريلز للاطلاع على معايير الأهلية.
`media_type`	نوع الوسائط. يمكن أن يكون `IMAGE` أو `VIDEO` أو `CAROUSEL_ALBUM`.
`media_url`	عنوان URL للوسائط.
`permalink`	عنوان URL الدائم للوسائط. سيتم حذفه إذا كانت الوسائط تحتوي على مادة محمية بموجب حقوق النشر، أو تم تحديدها بأنها تنتهك حقوق النشر.
`thumbnail_url`	عنوان URL للصورة المصغرة في الوسائط. ولا يتوفر إلا في وسائط `VIDEO`.
`timestamp`	تاريخ نشر الوسائط بتنسيق ISO 8601.
`username`	اسم المستخدم لمالك الوسائط.

عناصر الربط

يمكنك طلب عناصر الربط التالية كمعلمات المسار أو من خلال استخدام معلمة سلسلة الاستعلام fields.

عنصر الربط	الوصف
`children`	يمكن الحصول على قائمة بالوسائط الموجودة في ألبوم الوسائط. يتوفر فقط في وسائط `CAROUSEL_ALBUM`.

الاستجابة

كائن بتنسيق لغة JSON يتضمن الحقول وعناصر الربط الافتراضية والمطلوبة.

{
  "{field}":"{value}",
  ...
}

مثال على cURL

الطلب

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

التحديث

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

الحذف

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