> ## 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.

# Threads API

> خيارات النشر باستخدام واجهة برمجة تطبيقات Threads

<Info>
  يجلب نشر Threads الوسائط من عنوان URL الخاص بك عبر زاحف Meta من جانب الخادم.
  إذا رأيت رمز خطأ Ayrshare 379 — لا سيما جنبًا إلى جنب مع خطأ Instagram 440 أو 138 في نفس
  عملية النشر — راجع [حظر زاحف وسائط Meta](/help-center/technical-support/meta_media_crawler_blocked).
</Info>

## النشر إلى Threads

JSON لمنشور أساسي مع رابط وصورة باستخدام واجهة برمجة تطبيقات Threads:

```json Threads Post theme={"system"}
{
  "post": "The best Threads post ever #best #awesome https://www.threads.net", // empty string is allowed
  "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"],
  "platforms": ["threads"]
}
```

لواجهة برمجة تطبيقات Threads المتطلبات والقيود التالية:

<ul class="custom-bullets">
  <li>
    سيعرض Threads معاينة للرابط في المنشور تلقائيًا ما لم تكن هناك صورة أو فيديو
    مضمّن. في المثال أعلاه ستظهر الصورة. إزالة الصورة ستؤدي إلى إظهار معاينة الرابط.
  </li>

  <li>تقتصر ملفات Threads على 250 منشورًا يُنشر عبر API خلال فترة متحركة مدتها 24 ساعة.</li>
  <li>يسمح Threads فقط بوسم واحد لكل منشور.</li>
  <li>سيتلقى مستخدمو Threads الذين تتم الإشارة إليهم بـ @ إشعارًا.</li>
  <li>الحد الأقصى 500 حرف للمنشور.</li>

  <li>
    تُدعم المنشورات متعددة الصور/الفيديوهات وتُرسل كـ carousel. يمكنك إرسال ما يصل إلى 20 فيديو
    وصورة.
  </li>

  <li>
    لا يدعم Threads الحذف عبر واجهة API. يجب أن يتم الحذف يدويًا باستخدام تطبيق Threads.
  </li>

  <li>
    إذا كان الفيديو الخاص بك لا ينتهي بامتداد فيديو معروف مثل mp4، يُرجى استخدام معامل `isVideo`.
    راجع [نقطة نهاية /post](/apis/post/post) للتفاصيل.
  </li>

  <li>
    يدعم Threads أيضًا إرسال الوسائط دون نص منشور. إذا كنت لا تريد تضمين نص منشور،
    فأرسل سلسلة فارغة `post: ""`.
  </li>

  <li>
    راجع [إرشادات وسائط Threads](/media-guidelines/threads) و[تفويض
    Threads](/dashboard/connect-social-accounts/threads) لمزيد من المعلومات.
  </li>
</ul>

## خيارات Threads

يمكنك تعيين خيارات إضافية للمنشور باستخدام معامل `threadsOptions`.

```json Threads Options theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"],
    "thread": true,
    "threadNumber": true,
    "mediaUrls": ["https://img.ayrshare.com/012/gb.jpg"] // used when sending as a thread of threads
  }
}
```

خيارات Threads هي حقول اختيارية يمكن استخدامها للتحكم في المنشور.

<ParamField body="allowCountries" type="array of strings">
  تقييد المنشورات لبلدان محددة باستخدام رموز البلدان. استخدم [رموز البلدان](/iso-codes/country).

  متاح فقط إذا مكّنت Meta قيود الموقع الجغرافي لحسابك.

  راجع [قيود الموقع الجغرافي لـ Threads](/apis/post/social-networks/threads#geo-restrictions) لمزيد من المعلومات.
</ParamField>

<ParamField body="thread" type="boolean" default={false}>
  تقسيم المنشورات الطويلة إلى سلسلة threads متصلة مع ترقيم اختياري ووسائط.

  راجع [Thread](/apis/post/social-networks/threads#thread) لمزيد من المعلومات.
</ParamField>

<ParamField body="threadNumber" type="boolean" default={false}>
  إضافة أرقام تلقائيًا في نهاية كل thread بالصيغة 1/n.

  يتطلب `thread: true`.
</ParamField>

<ParamField body="mediaUrls" type="array of strings">
  إضافة كائنات وسائط إلى thread من threads. سيُضاف كائن وسائط واحد إلى كل thread بالترتيب.

  استخدم `null` لتخطي الوسائط لـ thread معيّن. استخدم كائنات مع عدة عناوين URL لعدة وسائط لكل thread.

  راجع [Thread Media](/apis/post/social-networks/threads#thread-media) لمزيد من المعلومات.
</ParamField>

## إضافة فواصل أسطر أو نص منسّق إلى منشور Threads

يمكن إضافة فواصل أسطر Threads إلى منشور باستخدام [حرف السطر الجديد](/apis/post/post#line-breaks) الخاص.

يمكن إضافة نص منسّق، مثل حروف عريضة أو مائلة، إلى منشور Threads ببعض [عناصر html](/apis/post/overview#rich-text-posts).

## Carousel للصور والفيديوهات

يمكنك نشر عدة صور أو فيديوهات إلى Threads كـ carousel؛ حتى إجمالي مُجمَّع يصل إلى 20 صورة أو فيديو يمكن استخدامها في carousel. ما عليك سوى إضافة صورك أو فيديوهاتك الإضافية إلى مصفوفة `mediaUrls` وسيتم إنشاء carousel تلقائيًا.

```json theme={"system"}
"mediaUrls": ["https://url.com/image.jpg", "https://url.com/video.mp4" ...];  // Max 20 images or videos
```

يجب أن تنتهي عناوين URL للفيديو بامتداد معروف مثل mp4.

## حدود الأحرف

يُرجى الاطلاع على [حدود أحرف Threads](/help-center/technical-support/character_limits#threads-character-limits) لمزيد من المعلومات.

## قيود الموقع الجغرافي

يمكنك تقييد منشور لبلد أو بلدان محددة باستخدام مصفوفة `allowCountries`.

```json theme={"system"}
{
  "threadsOptions": {
    "allowCountries": ["US", "CA"]
  }
}
```

<ul class="custom-bullets">
  <li>
    `allowCountries`: مصفوفة من رموز البلدان للسماح بها. راجع [رموز البلدان](/iso-codes/country).
  </li>
</ul>

<Warning>
  قيود الموقع الجغرافي (geo-gating) على Threads متاحة فقط إذا مكّنت Meta هذه الميزة لحسابك.

  تُقرِّر Meta أي حسابات Threads مؤهلة لقيود الموقع الجغرافي بناءً على عوامل مثل التحقق من الحساب أو عدد المتابعين أو حالة منشئ المحتوى.
  إذا كان حسابك مؤهلًا، فسترى إعدادات الموقع الجغرافي (أيقونة الكرة الأرضية) في مؤلف المنشور عند إنشاء منشور Threads جديد.

  يمكنك التحقق مما إذا كان ملف مستخدم مؤهلًا لقيود الموقع الجغرافي لـ Threads بفحص خاصية `isEligibleForGeoRestrictions` في نقطة نهاية [/user](/apis/user/profile-details).
</Warning>

## إشارات Threads

اذكر حساب Threads آخر بإضافة @handle في نص المنشور. على سبيل المثال:

```json theme={"system"}
{
  "post": "The best social media API @Ayrshare ever!",
  "mediaUrls": ["https://images.com"],
  "platforms": ["threads"]
}
```

<Warning>
  سيتم إخطار المستخدم المشار إليه بـ @ بالإشارة. يُرجى مراجعة [القواعد
  المهمة](/testing/post-verification#mentions) بشأن الإشارات.
</Warning>

إذا تم الوصول إلى الحصة، ستُعاد رسالة خطأ.

## Thread

Threads thread، المعروف أيضًا بـ threadstorm، هو سلسلة متصلة من المنشورات على Threads تتيح لك مشاركة أفكار أطول تتجاوز حد أحرف المنشور الواحد، وتظهر كسرد متواصل واحد عند عرضها معًا.

### نشر Thread

يمكن نشر Threads thread عبر واجهة API. الـ thread هو منشور مُقسَّم إلى مجموعة من منشورات الرد المرتبطة معًا في Threads. يمكنك إما تقسيم المنشور تلقائيًا أو تحديد [فواصل thread](/apis/post/social-networks/threads#thread-breaks) في نص المنشور.

```json Threads Thread theme={"system"}
{
  "threadsOptions": {
    "thread": true,        // required for threadstorm
    "threadNumber": true,  // optional to add numbers to each thread
    "mediaUrls": ["https://site.com/image1.png", "https://site.com/image2.png", ...]  // optional one media object is added to a thread in order
  }
}
```

<ul class="custom-bullets">
  <li>
    `thread: true` لتقسيم نص المنشور تلقائيًا إلى threads بناءً على فواصل الأسطر.
  </li>

  <li>
    `threadNumber: true` لإضافة أرقام تلقائيًا في نهاية threads بالصيغة 1/n.
    على سبيل المثال، ستُلحَق thread الثانية من أصل 5 threads بـ: 2/5
  </li>

  <li>
    `mediaUrls: [array of urls]` لإضافة كل كائن وسائط، صورة أو فيديو، إلى thread بالترتيب.
    سيُضاف كائن وسائط واحد فقط إلى thread بالترتيب.
  </li>
</ul>

#### وسائط Thread

##### تخطي الوسائط

تخطَّ الوسائط لـ thread باستخدام `null` في المصفوفة. على سبيل المثال:

`["https://site.com/image1.png", null, "https://site.com/image2.png"]`

سيؤدي هذا إلى وضع image1 على المنشور الأول، لا صورة على المنشور الثاني، وimage2 على المنشور الثالث.

##### وسائط متعددة

يمكن إضافة كائنات وسائط متعددة إلى منشور واحد داخل thread بإضافة كائن `{}` مع عناوين URL للوسائط في مصفوفة `mediaUrls`. يمكن استخدام أي مفاتيح كائن فريدة. على سبيل المثال:

```json Threads Thread with Multiple Media URLs theme={"system"}
{
  "threadsOptions": {
    "thread": true,
    "threadNumber": true,
    "mediaUrls": [
      "https://img.ayrshare.com/random/photo-1.jpg",
      {
        "1": "https://img.ayrshare.com/random/photo-2.jpg",
        "2": "https://img.ayrshare.com/random/photo-3.jpg"
      },
      "https://img.ayrshare.com/random/photo-4.jpg"
    ]
  }
}
```

في هذا المثال، سيحتوي المنشور الأول على photo-1.jpg، والمنشور الثاني على photo-2.jpg وphoto-3.jpg، والمنشور الثالث على photo-4.jpg.

#### فواصل Thread

يقوم Ayrshare بتقسيم نص المنشور تلقائيًا إلى منشورات بطول مناسب (> 500 حرف) لـ Threads. عند إنشاء threads، نُعطي الأولوية للحفاظ على الجمل الكاملة في منشور واحد إن أمكن. إذا لم تتناسب الجملة، فإننا نقسم بين الجمل. للجمل الطويلة جدًا، نقسم بين الكلمات. في حالات نادرة تكون فيها الكلمة طويلة جدًا، نقسم الكلمة نفسها.

يمكنك أيضًا إضافة فقرات يدويًا بـ `\n\n` إلى نص المنشور للإشارة إلى ضرورة إنشاء thread فريد. إذا كان لديك `\n\n` في نص المنشور، فلن نقسم المنشور تلقائيًا إلى threads.

على سبيل المثال:

```json Example Threads Thread theme={"system"}
{
  "post": "This is post 1\n\nThis is post 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

سينتج عنه منشوران في الـ thread.

إذا كنت ترغب في إضافة فقرات دون تقسيمها إلى منشورات، فاستخدم `\u2063\n\u2063\n`.

```json Threads Thread with Paragraphs theme={"system"}
{
  "post": "This is paragraph 1\u2063\n\u2063\nThis is paragraph 2.",
  "platforms": ["threads"],
  "threadsOptions": {
    "thread": true
  }
}
```

سينتج عنه منشور واحد بفقرتين نظرًا لأن المنشور أقل من 500 حرف.

### حذف Thread

لا يدعم Threads الحذف عبر واجهة API. يجب أن يتم الحذف يدويًا باستخدام تطبيق Threads.