> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # واجهة برمجة تطبيقات صفحة Facebook > خيارات النشر باستخدام واجهة برمجة تطبيقات Facebook export const PlansAvailable = ({plans = [], maxPackRequired}) => { let displayPlans = plans; if (plans && plans.length === 1) { const lowerCasePlan = plans[0].toLowerCase(); if (lowerCasePlan === "business") { displayPlans = ["Launch", "Business", "Enterprise"]; } else if (lowerCasePlan === "premium") { displayPlans = ["Premium", "Launch", "Business", "Enterprise"]; } } return Available on {displayPlans.length === 1 ? "the " : ""} {displayPlans.join(", ").replace(/\b\w/g, l => l.toUpperCase())}{" "} {displayPlans.length > 1 ? "plans" : "plan"}. {maxPackRequired && window.open('https://www.ayrshare.com/docs/additional/maxpack', '_self')} className="flex items-center mt-2 cursor-pointer"> Max Pack required } ; }; إذا كانت لديك مشكلات في ربط Facebook، يُرجى الاطلاع على [دليل استكشاف الأخطاء وإصلاحها](/help-center/technical-support/facebook_posting_issues). ## النشر على Facebook يتطلب النشر باستخدام Facebook API ربط صفحة Facebook. لا يسمح Facebook بربط الحسابات الشخصية. مثال JSON لمنشور أساسي مع رابط وصورة إلى صفحة Facebook: ```json Facebook Post with Image theme={"system"} { "post": "The best FB post ever #best https://www.facebook.com", // empty string is allowed "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"], "platforms": ["facebook"] } ``` لا تدعم واجهة برمجة تطبيقات Facebook مزج الصور والفيديوهات في منشور واحد. يمكنك تضمين عدة صور أو فيديو واحد، لكن ليس كليهما. ## صور Carousel انشر صور Facebook Carousel عبر واجهة Ayrshare API باستخدام معامل الجسم `carousel`. ```json Facebook Carousel Post theme={"system"} { "faceBookOptions": { "carousel": { // The URL of the "See More At" button - required "link": "URL of See More At...", "items": [ // 2 min, 10 max elements in the array { "name": "Image name", // optional "link": "URL when image clicked", // required "picture": "URL of image" // required }, { "name": "Image name", "link": "URL when image clicked", "picture": "URL of image" } ] } } } ``` **ملاحظة:** لا تستخدم `media_urls` مع `carousel`. إذا استُخدم `media_urls`، فسيُتجاهل `carousels`. راجع [دليل Facebook Carousel](https://www.ayrshare.com/blog/post-a-series-of-facebook-images-as-a-carousel/) لمزيد من المعلومات. ## Facebook Reels يمكنك نشر فيديو إلى Facebook Reels بـ `facebookOptions` التالية. تفرض Meta حدًا يبلغ 30 Reels لكل صفحة Facebook متصلة خلال أي فترة 24 ساعة لمنع الرسائل غير المرغوبة وضمان جودة المنصة. هذا حد متحرك، مما يعني أنه يحصي آخر 24 ساعة وليس أيام التقويم. ```json Facebook Reels Post theme={"system"} { "post": "The description of the video", "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/reel.mp4"], "faceBookOptions": { "reels": true, "title": "Super title for the Reel", // optional "thumbNail": "https://img.ayrshare.com/012/reel-thumbnail.jpg" // optional } } ``` راجع [متطلبات فيديو Reels API](/media-guidelines/facebook_pages#reels) أو [مثال على استخدام Facebook Reels API](https://www.ayrshare.com/blog/facebook-reels-api-how-to-post-fb-reels-using-a-social-media-api/). تواجه Meta أحيانًا مشكلات في معالجة Facebook Reels لبعض الحسابات. حتى إذا أُعيدت استجابة خطأ، فقد يكون Reel قد نُشر بالفعل. إذا واجهت أخطاء لـ Facebook Reels، نوصي بالتحقق من حالة Reel. إذا *لم يُنشر* المنشور، يمكنك محاولة [النشر مرة أخرى](/apis/post/retry-post). ينجح هذا في كثير من الأحيان. يمكنك استخدام الـ URL الوارد في حقل `verifyReelsUrl` للتحقق من الحالة. تأكد من استخدام نفس Profile Key كمنشورك الأصلي. انتظر حتى الوقت الوارد في `verifyReelsIn` للتحقق من حالة Reel (10 دقائق). إذا أُعيد رمز خطأ HTTP `400`، فقد فشل المنشور ويمكنك محاولة المنشور مرة أخرى. ```json Facebook Reels Post Error theme={"system"} { "action": "post", "status": "error", "code": 108, "message": "Facebook Error: Facebook cannot process your post at this time. Please try again. ", "detailsData": { "id": "104619420979033_36930641143", "verifyReelsUrl": "https://api.ayrshare.com/history/36930641143?searchPlatformId=true&platform=facebook", "verifyReelsIn": "2024-01-26T00:07:05.170Z", "postUrl": "https://www.facebook.com/1046194209_36930641143", "reels": true }, "retryAvailable": true, "platform": "facebook" } ``` ## Facebook Stories انشر Facebook Stories إلى صفحات Facebook إما كصورة أو كفيديو. ```json Facebook Stories Post theme={"system"} { "post": "", // Ignored by stories "platforms": ["facebook"], "mediaUrls": ["https://img.ayrshare.com/012/stories.mp4"], "faceBookOptions": { "stories": true } } ``` راجع [متطلبات الصور والفيديو لـ Stories API](/media-guidelines/facebook_pages#stories). ## تسميات توضيحية للوسائط عيّن تسمية توضيحية على Facebook لكل صورة وسائط منشورة. يقبل مصفوفة من نصوص التسميات التوضيحية. يجب أن تتوافق كل مصفوفة مع عنوان URL للوسائط. مثلًا، `["This is my best pic", "😃 here is the next one"]` تشير إلى الـ URLs الأولى والثانية في `mediaUrls`. ```json Facebook Media Captions theme={"system"} { "faceBookOptions": { "mediaCaptions": ["This is my best pic", "😃 here is the next one"] } } ``` ## وسم الموقع يُحدَّد وسم موقع Facebook بـ `locationId`، وهو معرّف صفحة Facebook أو اسم صفحة Facebook. على سبيل المثال، معرّف صفحة Facebook لـ [متحف Guggenheim](https://www.facebook.com/guggenheimmuseum) هو `7640348500` أو اسم صفحة Facebook `"@guggenheimmuseum"`. يجب أن تكون الصفحات مرتبطة بموقع فعلي. ```json Facebook Location Tagging theme={"system"} // Using the Facebook Page Id - must be associated with a location { "faceBookOptions": { "locationId": 7640348500 // Guggenheim Museum Page Id } } ``` يمكنك البحث عن `locationId` (Page Id) باستخدام [نقطة نهاية brand](/apis/listen/search/fb-page-search). يُرجى ملاحظة أنه يجب أن يكون للصفحة موقع مُدرج وإلا سيُعيد locationId خطأ. غير مدعوم في المنشورات النصية والصور وReels وStories. Videos غير مدعومة من Meta لوسم الموقع. ## استهداف الجمهور عند إنشاء منشور صفحة على Facebook، لديك خيار لتقييد رؤيته لجمهور معيّن باستخدام نوعين من الاستهداف: 1. Facebook Targeting: يتيح لك هذا تحديد جمهور منشورك بناءً على عوامل مثل العمر والجنس والموقع والحالة الاجتماعية. بضبط هذه المعاملات، يمكنك ضمان عرض منشورك فقط للأشخاص الذين يستوفون المعايير المحددة. 2. Facebook Feed Targeting: يُمكّنك هذا الخيار من تحسين رؤية منشورك ضمن News Feeds لجمهورك المستهدف. يمكنك استخدام أي خيار استهداف بشكل فردي أو الجمع بينهما. ### Targeting يعمل Facebook targeting على [تقييد الجمهور](https://www.facebook.com/help/352402648173466) لنشر المحتوى على فئات ديموغرافية محددة. أي شخص ليس ضمن هذه الفئات لن يتمكن من عرض هذا المحتوى. لن يتجاوز هذا أي قيود ديموغرافية على مستوى الصفحة قد تكون سارية. الحقول الديموغرافية المتاحة `targeting`: ```json Facebook Targeting theme={"system"} { "faceBookOptions": { "targeting": { "ageMin": 18, "countries": ["DE", "BR"] } } ``` ### Feed Targeting من الأرجح أن يرى أي شخص ضمن مجموعات Facebook feed targeting هذه المنشور، بينما أقل احتمالًا لغيرهم، لكن قد يظل يراه على أي حال. استخدم targeting، انظر أعلاه، إذا أردت ضمان التقييد. الحقول الديموغرافية المتاحة لـ `feedTargeting`: ```json Facebook Feed Targeting theme={"system"} { "feedTargeting": { "ageMax": 30, "ageMin": 26, "countries": ["DE", "BR"], "genders": [1, 2], "relationshipStatuses": [1, 2] } } ``` ## النص البديل أضف نصًا بديلًا في Facebook، المعروف أيضًا بالنص البديل (alt text)، إلى صورة أو فيديو. النص البديل في Facebook هو ميزة إمكانية وصول تُستخدم لمعلومات المستخدم الإضافية وقارئات الشاشة. استخدم `altText` في كائن `faceBookOptions`. ```json Facebook Alt Text theme={"system"} { "faceBookOptions": { // Array of Alt Texts "altText": ["This is my best pic", "😃 here is the next one"] } } ``` يجب أن يتوافق كل نص بديل مع صورة أو فيديو في مصفوفة `mediaUrls`. سيُطبَّق النص البديل على كل صورة بالترتيب. ## الصورة المصغّرة للفيديو عيّن صورة مصغّرة (صورة غلاف) لفيديو Facebook. أرسل عنوان URL بعيد لملف PNG أو JPG بنفس أبعاد الفيديو وأقل من 10 ميغابايت. يجب أن ينتهي الـ URL بـ .png أو .jpg. ```json Example Facebook Video Thumbnail theme={"system"} { "faceBookOptions": { "thumbNail": "https://octodex.github.com/images/Fintechtocat.png" } } ``` ## عنوان الفيديو أضف عنوان فيديو Facebook باستخدام معامل `title`. ```json Facebook Video Title theme={"system"} { "faceBookOptions": { "title": "The best video ever!" } } ``` ## صور GIF المتحركة يُسمح فقط بعنوان URL واحد في `mediaUrls` عند نشر Facebook GIF متحرك. إذا لم ينتهِ عنوان URL للوسائط بـ ".gif" أو ".GIF"، اضبط حقل `isVideo` على `true`. ```json Facebook Animated GIF theme={"system"} { "randomPost": true, "platforms": ["facebook"], // Set to true if the GIF URL does not end in .gif or .GIF "isVideo": false, // Only one URL is allowed in the array "mediaUrls": ["https://img.ayrshare.com/012/cat.gif"] } ``` ## إشارات صفحة Facebook يمكنك الإشارة إلى صفحة Facebook أخرى، المعروف أيضًا بإشارات Facebook أو وسم Facebook، بتضمين اسم صفحة Facebook أو Page ID في نص المنشور. لا يسمح Facebook بالإشارات أو وسم الملفات الشخصية أو المجموعات. ضمّن إشارة باستخدام @mention التالي: `@page-name` أو `@[page-id]` ### الإشارة باسم الصفحة مثال على نص منشور باسم صفحة. يمكنك العثور على اسم الصفحة من عنوان URL لـ Facebook، على سبيل المثال [https://www.facebook.com/Ayrshare](https://www.facebook.com/Ayrshare) ```json Facebook Page Mention with Page Name theme={"system"} { "post": "This is the best social media api by @Ayrshare" } ``` سيبذل Ayrshare محاولة قصوى للعثور على الصفحة المطابقة بناءً على الاسم، لكن أحيانًا لا يمكن العثور على تطابق. الطريقة الأكثر موثوقية هي استخدام Page ID. ### الإشارة بمعرّف الصفحة مثال على نص منشور بمعرّف صفحة؛ لاحظ استخدام \[]. راجع أدناه كيفية العثور على Page ID. ```json Facebook Page Mention with Page ID theme={"system"} { "post": "This is the best social media api by @[738681876342836]" // Ayrshare Page ID } ``` سيُحلّ معرّف صفحة Facebook إلى الصفحة المطابقة و\_**يُشعر الصفحة المذكورة**\_. استخدم الإشارة للصفحات بحذر بالإشارة فقط إلى الصفحات التي ترتبط بها. يجب أن تحرص على عدم إرسال رسائل مزعجة أبدًا. عندما تُشير إلى صفحة، **سيتم إشعار مالك الصفحة عبر تنبيه وبريد إلكتروني**. إذا اشتكت عدة صفحات من إشارتك إليها، فقد يحظر Facebook حسابك. عمومًا يجب أن توسم فقط الصفحات التي لديك علاقة راسخة معها. يجب أن تسمح صفحة Facebook التي يُشار إليها **للصفحات الأخرى** بالإشارة/الوسم لصفحتها. يمكن تفعيل الإشارات في إعدادات الصفحة العامة تحت "Others Tag this Page". يُرجى مراجعة [القواعد المهمة](/testing/post-verification#mentions) بشأن الإشارات. ### العثور على معرّف صفحة Facebook #### نقطة نهاية Brand يمكنك البحث عن مستخدم Facebook أو صفحة Facebook باستخدام [نقاط نهاية Brand](/apis/brand/overview). #### على Facebook.com 1. من News Feed في Facebook، انقر على **Pages** في القائمة الجانبية اليسرى. 2. انقر على اسم صفحتك للانتقال إلى صفحتك. 3. انقر على **About** في أعلى صفحتك. إن لم تراه، انقر على **More**▼. 4. مرّر لأسفل للعثور على **Page ID** الخاص بك أسفل **MORE INFO**. أو إذا أردت العثور على معرّف صفحة لا تملكها: `https://www.facebook.com/pages/ayrshare/123466789203` فإن Page ID هو الرقم في النهاية، مثل **123466789203**. يمكنك التحقق من أن Page ID صحيح بالانتقال إلى `https://facebook.com/page-id` وسيتم حلّه إلى الصفحة. يمكنك أيضًا تجربة أداة بحث عن Facebook Page من طرف ثالث، وهي غير مدعومة من Ayrshare، مثل: [https://lookup-id.com/](https://lookup-id.com/) إذا فشلت كل الطرق الأخرى، يمكنك الذهاب إلى صفحة Facebook في متصفح وعرض مصدر الصفحة. في Chrome، انقر بالزر الأيمن لتحديد "View Source". ثم ابحث عن `owning_profile_id` أو `profile_id` للعثور على Page ID. يُرجى مراجعة [القواعد المهمة](/testing/post-verification#mentions) بشأن الإشارات. ### تفعيل إشارات الصفحة يجب أن تسمح الصفحة بالإشارات والوسم في المنشورات والتعليقات. افتراضيًا هذا مُفعّل، لكن يمكنك التحقق بتسجيل الدخول إلى facebook.com والتبديل إلى صفحتك. 1. بعرضك كصفحتك، انقر على **صورة الملف الشخصي** لصفحتك في الزاوية اليمنى العليا. 2. انقر على **Settings & Privacy** -> **Settings**. 3. في قائمة Settings، انقر على **Privacy**. 4. انقر على **Page and Tagging**. 5. مرّر لأسفل إلى **Reviewing**. 6. بدّل الإعدادات للسماح بالوسم والإشارات. ## Meta Business Suite ### المنشورات كمسوّدة أنشئ منشور Facebook كمسوّدة يظهر في تبويب [Meta Business Suite Draft](https://business.facebook.com/latest/posts/draft_posts). مسوّدات Facebook هي منشورات بدأت بكتابتها لكن لم تنشرها بعد. يمكنك حفظ المسوّدات للعودة إليها لاحقًا، أو جدولتها للنشر في تاريخ لاحق. أضف المعامل `draft` إلى `faceBookOptions` لإرسال المنشور كمسوّدة. متاح للمنشورات النصية والصور والفيديو وReels. ```json Facebook Draft Post theme={"system"} { "faceBookOptions": { "draft": true } } ``` ### وقت نشر مجدول عيّن وقت نشر مجدول لمنشورات Facebook التي تظهر في تبويب [Meta Business Suite Scheduled Posts](https://business.facebook.com/latest/posts/scheduled_posts). المنشورات المجدولة في Facebook هي منشورات أنشأتها وجدولتها للنشر في تاريخ لاحق وتُدار في Meta Business Suite. يمكن أن يكون هذا مفيدًا لتخطيط منشورات وسائل التواصل الاجتماعي مسبقًا، أو لنشر المنشورات في الأوقات التي تعرف فيها أن جمهورك أكثر نشاطًا. متاح للمنشورات النصية والصور والفيديو وReels. يجب أن يكون وقت النشر أكبر من 10 دقائق من الوقت الحالي وضمن 29 يومًا من التاريخ الحالي. ما لم تكن بحاجة إلى إدارة منشورات Facebook في Meta Business Suite، نوصي باستخدام [تاريخ جدولة المنشور القياسي](/apis/post/overview#schedule-posts). أضف معامل `scheduledPublishDate` إلى `faceBookOptions` لجدولة وقت المنشور. ```json Facebook Scheduled Post theme={"system"} { "faceBookOptions": { "scheduledPublishDate": "2023-09-28T21:44:06Z" // Future date in UTC } } ``` ## معاينة الرابط سيُنشئ منشور Facebook تلقائيًا معاينة رابط لرابط في جسم المنشور. لكن، إذا أردت تحديد رابط مختلف أو فرض معاينة الرابط، فاستخدم معامل `link` مع الـ URL للرابط. ```json Facebook Link Preview theme={"system"} { "faceBookOptions": { "link": "https://www.ayrshare.com/instagram-hashtag-guide/" } } ``` إذا تم تضمين حقل `mediaUrls` في طلب المنشور، فستُعرض الوسائط بدلًا من معاينة الرابط. ## إعلانات Facebook إعلانات Facebook هي طريقة للترويج لمنشوراتك لجمهور أوسع. ## حدود الأحرف راجع [حدود أحرف Facebook](/help-center/technical-support/character_limits#facebook-character-limits) لمزيد من المعلومات. ## معلومات إضافية ### كيف أُضيف فواصل الأسطر أو النص المنسّق إلى منشور Facebook؟ يمكن إضافة فواصل الأسطر في Facebook إلى منشور بحرف [سطر جديد خاص](/apis/post/overview#line-breaks). يمكن إضافة نص منسّق، مثل الأحرف الغامقة أو المائلة، إلى منشور Facebook ببعض [عناصر html](/apis/post/overview#rich-text-posts). ### لماذا أرى "Published by Ayrshare" على منشور؟ لا تقلق، يظهر فقط في عرض المسؤول. راجع [دليل استكشاف الأخطاء وإصلاحها](/help-center/technical-support/facebook_shows_published_by_ayrshare) لمزيد من المعلومات.