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

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

بدءًا من 9 نوفمبر 2023، لن يتم دعم القيمة VIDEO في media_type بعد الآن. استخدم نوع الوسائط REELS لنشر الفيديو في الموجز.

الإنشاء

POST /{ig-user-id}/media

أنشئ حاوية IG لصورة أو إعلان دوّار أو قصة أو مقطع ريلز لاستخدامها في عملية نشر المنشورات. يمكن الرجوع إلى دليل نشر المحتوى للتعرف على خطوات النشر الكاملة.

التقييدات

التقييدات العامة

علمًا بأنه تنتهي صلاحية الحاويات بعد 24 ساعة.
إذا كانت الصفحة المرتبطة بالحساب الاحترافي في Instagram المستهدف تتطلب وجود تصريح النشر على الصفحة (PPA)، فيجب حينها إكمال تصريح النشر على الصفحة (PPA) وإلا فسيفشل الطلب.
إذا كانت الصفحة المرتبطة بالحساب الاحترافي في Instagram المستهدف تتطلب مصادقة ثنائية، فيجب أن يكون مستخدم فيسبوك قد أجرى أيضًا مصادقة ثنائية وإلا سيفشل الطلب.
النشر على Instagram TV غير مدعوم.

تقييدات مقاطع ريلز

لا يمكن عرض مقاطع ريلز في إعلانات الألبوم الدوّارة.
تتم مراعاة إعدادات خصوصية الحساب عند النشر. على سبيل المثال، إذا تم تمكين السماح بميزة ريمكس، فسيتم تمكين ميزة ريمكس في مقاطع ريلز المنشورة عند النشر ويمكن تعطيل ميزة ريمكس في مقاطع ريلز المنشورة يدويًا من خلال تطبيق Instagram.
لا تتوفر الإشارة إلى الموسيقى إلا لمقطع الصوت الأصلي.

تقييدات القصة

تنتهي الصلاحية القصص بعد 24 ساعة.
يمكن دعم عنوان URL للفيديو فقط أو عنوان URL لمقاطع ريلز فقط وليس كلاهما.
لا يتم دعم نشر الملصقات (مثل الرابط واستطلاع الرأي والموقع).

المتطلبات

النوع	الوصف
رموز الوصول	المستخدم
أدوار النشاط التجاري	إذا كنت تُنشئ حاويات للإشارة إلى المنتجات، فيجب أن يتوفر لدى مستخدم التطبيق دور مسؤول في مدير الأعمال الذي يمتلك متجر Instagram لمستخدم IG.
متجر Instagram	إذا كنت تُنشئ حاويات للإشارة إلى المنتجات، فيجب أن يمتلك مستخدم IG متجر Instagram معتمدًا يتضمن كتالوج منتجات يحتوي على المنتجات.
الأذونات	`instagram_basic` `instagram_content_publish` `pages_read_engagement` أو `pages_show_list` إذا تم منح مستخدم التطبيق دورًا في الصفحة عبر مدير الأعمال، فستحتاج أيضًا إلى أي مما يلي: `ads_management` `business_management` إذا كنت تُنشئ حاويات للإشارة إلى المنتجات، فستحتاج أيضًا إلى: `catalog_management` `instagram_shopping_tag_products`
المهام	يجب أن يكون مستخدم التطبيق الذي يتم استخدام رمزه في الطلب قادرًا على تنفيذ المهمة `MANAGE` أو `CREATE_CONTENT` في الصفحة المرتبطة بحساب Instagram المستهدف.

مواصفات الصورة

التنسيق: JPEG
حجم الملف: 8 ميجابايت كحد أقصى
نسبة العرض إلى الارتفاع: يجب أن تكون في نطاق من 4:5 إلى 1.91:1
الحد الأدنى للعرض: 320 (سيتم تكبيره إلى الحد الأدنى إذا لزم الأمر)
الحد الأقصى للعرض: 1440 (سيتم تقليصه إلى الحد الأقصى إذا لزم الأمر)
الارتفاع: يختلف حسب العرض ونسبة العرض إلى الارتفاع
مساحة الألوان: sRGB. سيتم تحويل مساحات ألوان الصور التي تستخدم مساحات ألوان أخرى إلى نظام ألوان sRGB.

مواصفات مقطع ريلز

فيما يلي مواصفات ريلز:

الحاوية: MOV أو MP4 (MPEG-4 Part 14)، بدون قوائم تحرير، moov atom في مقدمة الملف.
ترميز الصوت: ترميز AAC، عينة من معدل بقيمة 48 كيلو هرتز كحد أقصى، قناة واحدة أو قناتان (أحادية أو ستريو).
ترميز الفيديو: ترميز HEVC أو H264، المسح التقدمي، مجموعة GOP مُغلقة، أخذ عينات فرعية من الألوان 4:2:0.
معدل الإطارات: من 23 إلى 60 إطارًا في الثانية.
حجم الصورة:
- الحد الأقصى للأعمدة (وحدات البيكسل الأفقية): 1920
- تتراوح نسبة العرض إلى الارتفاع المطلوبة بين 0.01:1 و10:1 ولكن نوصي باستخدام النسبة 9:16 لتجنب الاقتصاص أو ظهور مسافة فارغة.
معدل البت للفيديو: معدل البت المتغير (VBR)، 25 ميجابت في الثانية كحد أقصى
معدل البت للصوت: 128 كيلو بت في الثانية
المدة: 15 دقيقة كحد أقصى، 3 ثوان كحد أدنى
حجم الملف: 1 جيجابايت كحد أقصى

فيما يلي مواصفات صورة غلاف ريلز:

التنسيق: JPEG
حجم الملف: 8 ميجابايت كحد أقصى
مساحة الألوان: sRGB. وسيتم تحويل الصور التي تستخدم مساحات ألوان أخرى إلى نظام ألوان sRGB.
نسبة العرض إلى الارتفاع: نوصي بالنسبة 9:16 لتجنب الاقتصاص أو المساحة الفارغة. إذا لم تكن نسبة العرض إلى الارتفاع للصورة الأصلية 9:16، فإننا نقتص الصورة ونستخدم المستطيل المتوسط 9:16 كصورة غلاف لمقطع ريلز. إذا قمت بمشاركة مقطع ريلز في الموجز، فيتم اقتصاص الصورة واستخدام المربع المتوسط 1:1 كصورة غلاف لمنشور الموجز.

مواصفات صورة القصة

التنسيق: JPEG
حجم الملف: 8 ميجابايت كحد أقصى.
نسبة العرض إلى الارتفاع: نوصي بالنسبة 9:16 لتجنب الاقتصاص أو المساحة الفارغة
مساحة الألوان: sRGB. وسيتم تحويل الصور التي تستخدم مساحات ألوان أخرى إلى نظام ألوان sRGB

مواصفات فيديو القصة

الحاوية: MOV أو MP4 (MPEG-4 Part 14)، بدون قوائم تحرير، moov atom في مقدمة الملف.
ترميز الصوت: ترميز AAC، عينة من معدل بقيمة 48 كيلو هرتز كحد أقصى، قناة واحدة أو قناتان (أحادية أو ستريو).
ترميز الفيديو: ترميز HEVC أو H264، المسح التقدمي، مجموعة GOP مُغلقة، أخذ عينات فرعية من الألوان 4:2:0.
معدل الإطارات: من 23 إلى 60 إطارًا في الثانية.
حجم الصورة:
- الحد الأقصى للأعمدة (وحدات البيكسل الأفقية): 1920
- تتراوح نسبة العرض إلى الارتفاع المطلوبة بين 0.1:1 و10:1 ولكن نوصي باستخدام النسبة 9:16 لتجنب الاقتصاص أو ظهور مسافة فارغة
معدل البت للفيديو: معدل البت المتغير (VBR)، 25 ميجابت في الثانية كحد أقصى
معدل البت للصوت: 128 كيلو بت في الثانية
المدة: 60 ثانية كحد أقصى، 3 ثوان كحد أدنى
حجم الملف: 100 ميجابايت كحد أقصى

بنية الطلب

حاويات الصور

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

حاويات ريلز

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

حاويات الإعلان الدوّار

حاويات الإعلان الدوّار فقط. لإنشاء حاويات عنصر إعلان دوّار، قم بإنشاء حاويات صور أو فيديو بدلاً من ذلك (مقاطع ريلز غير مدعومة). راجع منشورات الإعلان الدوّار للحصول على خطوات النشر الكاملة.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

حاويات قصة الصورة

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

حاويات قصة الفيديو

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

معلمات المسار

العنصر النائب	القيمة
`{api-version}`	يمثل إصدار API.
`{ig-user-id}` مطلوب	معرف المستخدم على مستوى التطبيق لدى مستخدم التطبيق.

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

المفتاح	العنصر النائب	الوصف
`access_token`	`{access-token}`	مطلوب. رمز وصول المستخدم الخاص بمستخدم التطبيق.
`audio_name`	`{audio-name}`	لمقاطع ريلز فقط. اسم المقطع الصوتي لوسائط ريلز. لا يمكنك إعادة التسمية إلا مرة واحدة، إما أثناء إنشاء مقطع ريلز أو بعده من صفحة الصوت.
`caption`	`{caption}`	يمثل شرحًا توضيحيًا لصورة أو فيديو أو إعلان دوّار. ويمكن أن يتضمن إشارات هاشتاج (مثل `#crazywildebeest`) وأسماء مستخدمي Instagram (مثل `@natgeo`). كما سيتلقى مستخدمو Instagram الذين يتم @ذكرهم إشعارًا عند نشر الحاوية. علمًا بأن الحد الأقصى هو 2200 حرف و30 إشارة هاشتاج و20 إشارة ذكر @. غير مدعوم على الصور أو مقاطع الفيديو في الإعلانات الدوّارة..
`collaborators`	`{caption}`	لصورة الموجز وريلز والإعلانات الدوّارة فقط. قائمة بما يصل إلى 3 أسماء مستخدمين في Instagram كمساهمين في وسائط ig. غير مدعوم للقصص.
`children`	`{children}`	مطلوب للإعلانات الدوّارة. ينطبق فقط على الإعلانات الدوّارة. يمثل مصفوفة تضم حتى 10 معرفات حاوية لكل صورة أو فيديو يجب أن يظهر في الإعلان الدوّار المنشور. يمكن أن تتضمن الإعلانات الدوّارة حتى 10 صور أو مقاطع فيديو أو مزيجًا من الاثنين.
`cover_url`	`{cover-url}`	لمقاطع ريلز فقط. مسار الصورة المطلوب استخدامها كصورة غلاف لعلامة التبويب ريلز. سيتم إجراء طلبات cURL للصورة باستخدام عنوان URL الذي تحدده، لذا يجب أن تتوفر هذه الصورة على خادم عام. إذا حددت كل من `cover_url` و`thumb_offset`، فسنستخدم `cover_url` ونتجاهل `thumb_offset`. يجب أن تمتثل الصورة إلى مواصفات صورة غلاف ريلز.
`image_url`	`{image-url}`	للصور فقط ومطلوبة للصور. يمثل مسار الصورة. وسيتم إجراء طلبات cURL للصورة باستخدام عنوان URL الذي تحدده، لذا يجب أن تتوفر هذه الصورة على خادم عام.
`is_carousel_item`	`{is-carousel-item}`	ينطبق فقط على الصور والفيديو. يتم التعيين إلى `true`. ويشير إلى أن الصورة أو الفيديو يظهر في إعلان دوّار.
`location_id`	`{location-id}`	يمثل معرف الصفحة المرتبطة بالموقع الذي تريد الإشارة إلى الصورة أو الفيديو فيه. استخدم API البحث عن الصفحات للبحث عن الصفحات التي تتطابق أسماؤها مع سلسلة البحث، وتحليل النتائج بعد ذلك لتحديد الصفحات التي تم إنشاؤها لموقع فعلي. واحرص على تضمين الحقل `location` في استعلامك والتحقق مما إذا كانت الصفحة التي تريد استخدامها تحتوي على بيانات الموقع أم لا. ستفشل محاولة إنشاء حاوية باستخدام صفحة لا تحتوي على بيانات موقع مع إرجاع الاستثناء `INSTAGRAM_PLATFORM_API__INVALID_LOCATION_ID` الذي يحتوي على رمز. غير مدعوم على الصور أو مقاطع الفيديو في الإعلانات الدوّارة..
`media_type`	`{media-type}`	مطلوب للإعلانات الدوّارة والقصص ومقاطع ريلز. يشير إلى أن الحاوية مخصصة لإعلان دوّار أو قصة أو مقطع ريلز. يمكن أن تكون القيمة كما يلي: `CAROUSEL` `REELS` `STORIES`
`product_tags`	`{product-tags}`	مطلوب للإشارة إلى المنتجات. ينطبق فقط على الصور ومقاطع الفيديو. مصفوفة من الكائنات تحدد إشارات المنتجات التي يمكن استخدامها في الصورة أو الفيديو (بحد أقصى 5 إشارات، يجب أن تكون الإشارات ومعرفات المنتجات فريدة). يجب أن تتوفر لدى كل كائن المعلومات التالية: `product_id` - مطلوب. معرف المنتج. `x` — الصور فقط. عدد صحيح عشري اختياري يشير إلى المسافة بالنسبة المئوية من الطرف الأيسر لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق `0.0`-`1.0`. `y` — الصور فقط. عدد صحيح عشري اختياري يشير إلى المسافة بالنسبة المئوية من الطرف العلوي لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق `0.0`-`1.0`. على سبيل المثال: `[{product_id:'3231775643511089',x: 0.5,y: 0.8}]`
`share_to_feed`	`{share-to-feed}`	لمقاطع ريلز فقط. عندما تكون القيمة `true`، يشير ذلك إلى إمكانية ظهور مقطع ريلز في علامتي التبويب الموجز وريلز. وعندما تكون القيمة `false`، هذا يشير إلى أن مقطع ريلز لا يمكنه الظهور سوى في علامة التبويب ريلز. لاحظ أن القيمتين لا تحددان ما إذا كان مقطع ريلز يظهر بالفعل في علامة التبويب ريلز، نظرًا لأن مقطع ريلز قد لا يفي بمتطلبات الأهلية أو قد لا يتم تحديده بواسطة الخوارزمية لدينا. راجع مواصفات مقطع ريلز للاطلاع على معايير الأهلية.
`thumb_offset`	`{thumb-offset}`	لمقاطع الفيديو وريلز. موقع إطار الفيديو أو مقطع ريلز، بالمللي ثانية، المطلوب استخدامه كصورة مصغرة للغلاف. وتكون القيمة الافتراضية `0` والتي تمثل الإطار الأول في الفيديو أو مقطع ريلز. بالنسبة إلى ريلز، إذا حددت كل من `cover_url` و`thumb_offset`، فسنستخدم `cover_url` ونتجاهل `thumb_offset`.
`user_tags`	`{user-tags}`	مطلوب للإشارة إلى المستخدمين. ينطبق على الصور ومقاطع الفيديو. مصفوفة من أسماء المستخدمين العامة وإحداثيات `x`/`y` لأي مستخدم Instagram عام تريد الإشارة إليه في الصورة. يجب أن تتوفر لدى كل كائن المعلومات التالية: `usernames` — مطلوب. أسماء المستخدمين العامة. `x` — الصور فقط. عدد صحيح عشري اختياري يشير إلى المسافة بالنسبة المئوية من الطرف الأيسر لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق `0.0`-`1.0`. `y` — الصور فقط. عدد صحيح عشري اختياري يشير إلى المسافة بالنسبة المئوية من الطرف العلوي لصورة الوسائط المنشورة. يجب أن تكون القيمة بين نطاق `0.0`-`1.0`.
`video_url`	`{video-url}`	مطلوب لمقاطع الفيديو ومقاطع ريلز. ينطبق فقط على مقاطع الفيديو ومقاطع ريلز. يمثل مسار الفيديو. نُجري طلبات cURL للفيديو باستخدام عنوان URL الذي تم إدخاله، لذا يجب أن يتوفر هذا الفيديو على خادم عام.

الاستجابة

كائن بتنسيق JSON يحتوي على معرف حاوية IG يمكنك استخدامه لنشر الحاوية.

تكون عمليات تحميل الفيديو غير متزامنة، لذا فإن استلام معرف الحاوية لا يضمن نجاح التحميل. للتحقق من تحميل الفيديو، اطلب الحقل status_code في حاوية IG. وإذا كانت قيمته FINISHED، فإنه قد تم تحميل الفيديو بنجاح.

{
  "id":"{ig-container-id}"
}

عينة من الطلب

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ]

عينة من الاستجابة

{
  "id": "17889455560051444"
}

القراءة

GET /{ig-user-id}/media

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

التقييدات

يمكن إرجاع 10 آلاف كحد أقصى من أحدث الوسائط التي تم إنشاؤها.
وسائط IG للقصص غير مدعومة، استخدم نقطة النهاية GET /{ig-user-id}/stories بدلاً من ذلك.

المتطلبات

النوع الوصف

رموز الوصول

المستخدم

الأذونات

instagram_basic
pages_read_engagement أو pages_show_list

إذا تم منح مستخدم التطبيق دورًا في الصفحة عبر مدير الأعمال، فستحتاج أيضًا إلى أي مما يلي:

ads_management
business_management

تقسيم الصفحات استنادًا إلى الوقت

تدعم نقطة النهاية هذه تقسيم الصفحات استنادًا إلى الوقت. يمكنك تضمين معلمات سلسلة الاستعلام since وuntil بطابع Unix الزمني أو قيم بيانات strtotime لتحديد نطاق زمني.

عينة من الطلب

GET graph.facebook.com/17841405822304914/media

عينة من الاستجابة

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

التحديث

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

الحذف

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