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

# LinkedIn API

> خيارات النشر باستخدام LinkedIn API

يحتوي LinkedIn API على المتطلبات والقيود التالية:

<ul class="custom-bullets">
  <li>يقبل حقل `post` ما يصل إلى 3000 حرف.</li>

  <li>
    سيقوم LinkedIn تلقائيًا بمعاينة الرابط في المنشور ما لم تكن هناك صورة أو فيديو
    مضمّن. في المثال أعلاه ستظهر الصورة. إزالة الصورة ستؤدي إلى ظهور معاينة الرابط.
    إذا تعذر استرداد معاينة الرابط، فسيظل المنشور منشورًا وسيتم إرجاع
    حقل `linkPreviewFailed: true` في استجابة /post.
  </li>

  <li>يمكن النقر على الهاشتاغات في LinkedIn. استخدم رمز # لتحديد هاشتاغ LinkedIn.</li>

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

  <li>
    تستغرق معالجة فيديو LinkedIn عدة دقائق لإكمالها. يُرجى الانتظار قبل تجربة عنوان
    URL للمشاركة أو الحصول على تحليلات الفيديو.
  </li>

  <li>يحد LinkedIn من 150 منشورًا يوميًا لكل حساب LinkedIn.</li>
  <li>النشر إلى مجموعات LinkedIn غير مدعوم.</li>

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

  <li>يمكنك ربط صفحة شركة أو حساب LinkedIn شخصي.</li>

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

<Warning>
  يجب أن تكون "Super Admin" أو "Content Admin" لربط صفحة شركة LinkedIn.{" "}
</Warning>

## النشر إلى LinkedIn

JSON لمنشور أساسي يحتوي على رابط وصورة إلى LinkedIn:

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

## خيارات LinkedIn

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

```json LinkedIn Options theme={"system"}
{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"],
    "disableShare": true,
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"],
      "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"],
      "industries": ["Telecommunications Carriers", "Banking"],
      "jobFunctions": ["Information Technology", "Entrepreneurship"],
      "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"]
    },
    "thumbNail": "https://example.com/thumbnail.jpg",
    "title": "Sample PPTX",
    "titles": ["This is an amazing video", "😃 here is the next one"],
    "visibility": "public"
  }
}
```

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

<ParamField body="altText" type="array of strings">
  النص البديل للصور من أجل الوصول وقارئات الشاشة.

  راجع [النص البديل في LinkedIn](/apis/post/social-networks/linkedin#alternative-text) لمزيد من المعلومات.
</ParamField>

<ParamField body="disableShare" type="boolean" default={false}>
  تعطيل قدرة المستخدمين على إعادة مشاركة منشور LinkedIn.

  راجع [تعطيل المشاركة في LinkedIn](/apis/post/social-networks/linkedin#disable-share) لمزيد من المعلومات.
</ParamField>

<ParamField body="targeting" type="object">
  استهدف منشوراتك العضوية لمجموعات محددة حسب البلدان والصناعة والمسمى الوظيفي والمزيد.

  يتطلب ما لا يقل عن 300 متابع في الجمهور المستهدف.

  راجع [استهداف جمهور LinkedIn](/apis/post/social-networks/linkedin#audience-targeting) لمزيد من المعلومات.
</ParamField>

<ParamField body="thumbNail" type="string">
  الصورة المصغرة لفيديو. يجب أن تكون PNG أو JPG، بنفس أبعاد الفيديو، أقل من 10 ميجابايت. يجب أن ينتهي عنوان URL بـ .png أو .jpg.

  راجع [الصورة المصغرة لفيديو LinkedIn](/apis/post/social-networks/linkedin#video-thumbnail) لمزيد من المعلومات.
</ParamField>

<ParamField body="title" type="string">
  عنوان المستند عند نشر ملفات PPT أو PPTX أو DOC أو DOCX أو PDF. الحد الأقصى للطول: 400 حرف.

  إذا لم يتم تحديده، يتم استخدام اسم الملف.

  راجع [مستندات LinkedIn](/apis/post/social-networks/linkedin#documents) لمزيد من المعلومات.
</ParamField>

<ParamField body="titles" type="array of strings">
  عنوان أو تعليقات وسائط لصور أو مقاطع فيديو LinkedIn.

  كل عنوان يتوافق مع عنوان URL للوسائط بالترتيب.

  راجع [عناوين وسائط LinkedIn](/apis/post/social-networks/linkedin#media-titles) لمزيد من المعلومات.
</ParamField>

<ParamField body="visibility" type="string" default="public">
  رؤية المنشور.

  القيم: `public` أو `connections` أو `loggedin`.

  راجع [رؤية منشور LinkedIn](/apis/post/social-networks/linkedin#post-visibility) لمزيد من المعلومات.
</ParamField>

## النص البديل

أضف النص البديل لـ LinkedIn، المعروف أيضًا باسم LinkedIn alt text، إلى صورة LinkedIn. النص البديل لـ LinkedIn هو ميزة إمكانية وصول تُستخدم لمعلومات المستخدم الإضافية وقارئات الشاشة. لا يدعم LinkedIn altText على مقاطع الفيديو أو المستندات.

استخدم `altText` في كائن `linkedInOptions`.

```json LinkedIn Alt Text theme={"system"}
{
  "linkedInOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

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

## استهداف الجمهور

يتيح لك LinkedIn استهداف منشوراتك العضوية لمجموعات محددة من المستخدمين. يمكنك الاستهداف حسب البلدان والصناعة والمسمى الوظيفي والمزيد.

<Warning>
  يتطلب استهداف LinkedIn ما لا يقل عن **300 متابع في الجمهور المستهدف**. على سبيل المثال إذا
  كان لديك 400 متابع واستهدفت المستخدمين في الولايات المتحدة فقط، ولكن 200 فقط من متابعيك
  في الولايات المتحدة، فسيفشل الاستهداف لأن الجمهور صغير جدًا.
</Warning>

استخدم كائن `targeting` في كائن `linkedInOptions`:

```json LinkedIn Audience Targeting theme={"system"}
{
  "linkedInOptions": {
    "targeting": {
      "countries": ["US", "IN", "DE", "GB"],
      "seniorities": ["Senior", "VP"],
      "degrees": ["Master of Digital Design", "Bachelor of Engineering"],
      "fieldsOfStudy": ["Consumer Economics", "Computer Games and Programming Skills"],
      "industries": ["Telecommunications Carriers", "Banking"],
      "jobFunctions": ["Information Technology", "Entrepreneurship"],
      "staffCountRanges": ["size_51_to_200", "size_5001_to_10000"]
    }
  }
}
```

خيارات الاستهداف المتاحة مدرجة في ملفات JSON التالية:

<ul class="custom-bullets">
  <li>[بلدان LinkedIn](https://logo.ayrshare.com/data/linkedin/countries.json)</li>
  <li>[مستويات الأقدمية في LinkedIn](https://logo.ayrshare.com/data/linkedin/seniorities.json)</li>
  <li>[شهادات LinkedIn](https://logo.ayrshare.com/data/linkedin/degrees.json)</li>
  <li>[مجالات الدراسة في LinkedIn](https://logo.ayrshare.com/data/linkedin/fieldsOfStudy.json)</li>
  <li>[صناعات LinkedIn](https://logo.ayrshare.com/data/linkedin/industries.json)</li>
  <li>[وظائف LinkedIn](https://logo.ayrshare.com/data/linkedin/jobFunctions.json)</li>

  <li>
    [نطاقات عدد الموظفين في LinkedIn](https://logo.ayrshare.com/data/linkedin/staffCountRanges.json)
  </li>
</ul>

## تجديد التفويض

يجب إعادة تفويض LinkedIn *كل عام* عبر صفحة الحسابات الاجتماعية.

<ul class="custom-bullets">
  <li>
    سيتم إرسال إشعار بريد إلكتروني وإجراء ويب هوك اجتماعي قبل 15 يومًا من انتهاء صلاحية
    التفويض.
  </li>

  <li>
    يمكن استرجاع تاريخ التجديد المطلوب والأيام المتبقية من نقطة نهاية
    [/user](/apis/user/overview).
  </li>

  <li>
    سيرى المستخدم على صفحة ربط حسابه الاجتماعي تنبيهًا وزر تجديد قبل 30 يومًا
    من انتهاء الصلاحية.
  </li>
</ul>

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

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

## تعطيل المشاركة

يمكنك تعطيل قدرة المستخدمين على إعادة مشاركة منشور LinkedIn عن طريق ضبط حقل `disableShare` على `true` في كائن `linkedInOptions`:

```json LinkedIn Disable Share theme={"system"}
{
  "linkedInOptions": {
    "disableShare": true
  }
}
```

## المستندات

استخدم واجهة برمجة التطبيقات لنشر مستند على LinkedIn. تتضمن تنسيقات الملفات المدعومة: PPT وPPTX وDOC وDOCX وPDF. تأكد من أن المستند أقل من 100 ميجابايت وأنه لا يتجاوز 300 صفحة.

فيما يلي عينة تعليمات برمجية توضح كيفية نشر مستند PPTX بعنوان:

```json LinkedIn Document Post theme={"system"}
{
  "post": "What a great document",
  "platforms": ["linkedin"],
  "linkedInOptions": {
    "title": "Sample PPTX" // optional. If not specified, the file name used.
  },
  "mediaUrls": ["https://scholar.harvard.edu/files/torman_personal/files/samplepptx.pptx"]
}
```

يجب أن ينتهي عنوان URL للوسائط المقدم بامتداد مستند معروف: ppt أو pptx أو doc أو docx أو pdf.

## إشارات LinkedIn

يمكنك الإشارة إلى منظمات LinkedIn الأخرى، مثل صفحات الشركات، أو ملفات تعريف الأعضاء، مثل صفحات الملف الشخصي الفردية، في منشوراتك.

تحاول Ayrshare حل @الإشارة عن طريق البحث عن المعرف.
إذا لم يتم العثور على @الإشارة، فسيتم إزالة @ من المنشور لأن LinkedIn لن يقبل المنشورات مع الإشارات غير المُحلّة.
لا يمكن الإشارة إلى ملفات تعريف LinkedIn الفردية.

<Warning>
  إذا تعذر حل أي إشارة في منشور LinkedIn (بسبب إعدادات الخصوصية
  أو قيود الحساب أو قيود المنصة الأخرى)، فقد يفشل LinkedIn في
  عرض جميع الإشارات في هذا المنشور كروابط قابلة للنقر. هذا سلوك منصة LinkedIn
  وليس مشكلة في واجهة برمجة التطبيقات. لتجنب ذلك، تأكد من أن جميع المستخدمين والمنظمات المذكورة
  تسمح بالإشارات من منظمتك أو فكر في نشر الإشارات
  بشكل منفصل لعزل أي إشارات إشكالية.
</Warning>

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

### ملفات تعريف المنظمات

قم بالإشارة إلى معرف منظمة LinkedIn أخرى بإضافة `@handle` في نص المنشور. `@handle` هو اسم الشركة أو المنظمة.
يمكنك الإشارة في المنشورات والتعليقات والرد على التعليقات.

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

<ul class="custom-bullets">
  <li>
    الملف الشخصي لشركة Ayrshare على LinkedIn هو
    [https://www.linkedin.com/company/ayrshare](https://www.linkedin.com/company/ayrshare) والمعرّف
    المستخدم هو *@ayrshare*.
  </li>

  <li>
    الملف الشخصي لشركة Zara على LinkedIn هو
    [https://www.linkedin.com/company/zara-sa/](https://www.linkedin.com/company/zara-sa/) والمعرّف
    المستخدم هو *@zara-sa*.
  </li>
</ul>

```json LinkedIn Mention theme={"system"}
{
  "post": "The best social media API @ayrshare ever!",
  "platforms": ["linkedin"]
}
```

### ملفات تعريف الأعضاء

قم بالإشارة إلى ملف تعريف عضو LinkedIn آخر بإضافة `@vanity_name` أو `@[John Smith]` في نص المنشور.

1. `@vanity_name` هو الاسم المميز لملف تعريف العضو. على سبيل المثال في عنوان URL للملف الشخصي للعضو `https://www.linkedin.com/in/vanity_name/`، الاسم المميز هو `vanity_name`.
2. `@[John Smith]` هو الاسم الكامل للشخص. على سبيل المثال إذا كان الاسم الكامل للشخص `John Smith`، فستكون الإشارة `@[John Smith]`.

يمكنك الإشارة في المنشورات والتعليقات والرد على التعليقات.

```json LinkedIn Mention theme={"system"}
{
  "post": "The best social media API @[John Smith] and @ava_smith ever!",
  "platforms": ["linkedin"]
}
```

في المثال أعلاه، سيتم الإشارة إلى John Smith وAva Smith في المنشور - الأول باستخدام اسمه الكامل والثاني باستخدام اسمه المميز.

**ملاحظات مهمة:**

1. يجب أن يكون لديك صفحة شركة LinkedIn متصلة بحساب Ayrshare الخاص بك للإشارة إلى ملفات تعريف
   الأعضاء. إذا قمت بربط حساب LinkedIn الشخصي الخاص بك، فلن تتمكن من الإشارة إلى ملفات تعريف
   الأشخاص الآخرين.
2. يسمح LinkedIn فقط بالإشارة إلى الأشخاص الذين يتابعون منظمتك / صفحة الشركة.

## عناوين الوسائط

أضف عنوانًا أو تعليقات وسائط إلى صور أو مقاطع فيديو LinkedIn.

استخدم `titles` في كائن `linkedInOptions`.

```json LinkedIn Media Titles theme={"system"}
{
  "linkedInOptions": {
    "titles": ["This is an amazing video", "😃 here is the next one"] // Array of Alt Texts
  }
}
```

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

## منشورات متعددة الصور

يمكنك نشر ما يصل إلى *9 عناوين URL للصور* في `mediaUrls` إلى LinkedIn.

```json LinkedIn Multi Image Post theme={"system"}
{
  "mediaUrls": ["https://url1", ..., "https://url9"]
}
```

لا يدعم LinkedIn حاليًا صور carousel للمنشورات العضوية.

## رؤية المنشور

يتيح لك LinkedIn التحكم في رؤية منشوراتك.
يمكنك تعيين الرؤية على عام أو الاتصالات فقط أو المستخدمين المسجلين فقط.
إذا لم يتم تحديد أي رؤية، فسيكون المنشور "عام" ومرئيًا لجميع مستخدمي LinkedIn.

<ul class="custom-bullets">
  <li>
    `public`: سيكون المنشور مرئيًا لجميع مستخدمي LinkedIn. متاح لصفحات الشركة و
    حسابات LinkedIn الشخصية المرتبطة. الافتراضي إذا لم يتم تحديد رؤية.
  </li>

  <li>
    `connections`: سيكون المنشور مرئيًا للشبكة من الدرجة الأولى للمالك (ملف المستخدم).
    متاح لحسابات LinkedIn الشخصية المرتبطة فقط.
  </li>

  <li>
    `loggedin`: سيكون المنشور مرئيًا لمستخدمي LinkedIn المسجلين فقط. متاح لكل من صفحات
    الشركة وحسابات LinkedIn الشخصية المرتبطة.
  </li>
</ul>

استخدم حقل `visibility` في كائن `linkedInOptions`:

```json LinkedIn Post Visibility theme={"system"}
{
  "linkedInOptions": {
    "visibility": "public" // "public", "connections", or "loggedin"
  }
}
```

## أذونات نشر الفيديو

على LinkedIn، يمكن للمستخدمين الذين لديهم أذونات محددة فقط نشر مقاطع الفيديو على صفحات الشركة:

1. المستخدمون الذين لديهم أذونات Admin.
2. المستخدمون الذين لديهم أذونات Direct Sponsored Content (DSC).

لا يمتلك مسؤولو المحتوى القدرة على نشر مقاطع الفيديو على صفحات شركة LinkedIn.

## الصورة المصغرة للفيديو

قم بتعيين صورة مصغرة لـ LinkedIn لفيديو. أرسل عنوان URL بعيد لملف PNG أو JPG بنفس أبعاد الفيديو وأقل من 10 ميجابايت. يجب أن ينتهي عنوان URL بـ .png أو .jpg.

استخدم `thumbNail` في كائن `linkedInOptions`.

```json LinkedIn Video Thumbnail theme={"system"}
{
  "linkedInOptions": {
    "thumbNail": "https://octodex.github.com/images/Fintechtocat.png"
  }
}
```

يرجى الاطلاع هنا على المزيد من [أمثلة استخدام LinkedIn API](https://www.ayrshare.com/how-to-post-and-get-analytics-with-the-linkedin-api#linkedin-api-examples).
