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

# Pinterest API

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

## نشر Pin بصورة إلى Pinterest

يتطلب Pinterest API تضمين صورة في المنشور. المعلمات الأخرى اختيارية.
يُرجى الاطلاع على [إرشادات وسائط Pinterest](/media-guidelines/pinterest) و[تفويض Pinterest](/dashboard/connect-social-accounts/pinterest) لمزيد من المعلومات.

```json Pinterest Post theme={"system"}
{
  "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string
  "platforms": ["pinterest"],
  "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"]
}
```

## خيارات Pinterest

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

```json Pinterest Post theme={"system"}
{
  "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string
  "platforms": ["pinterest"],
  "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"],
  "pinterestOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"], // maximum 500 characters
    "boardId": "93383204522",
    "carouselOptions": [
      {
        "title": "Image 1",
        "link": "https://www.cnn.com",
        "description": "Super Image 1"
      },
      {
        "title": "Image 2",
        "link": "https://www.google.com",
        "description": "Super Image 2"
      }
    ],
    "link": "https://www.ayrshare.com", // maximum 2048 characters
    "note": "Private note", // maximum 1000 characters
    "thumbNail": "https://images.ayrshare.com/imgs/GhostBusters.jpg",
    "title": "A Pinterest Board for You" // maximum 100 characters
  }
}
```

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

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

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

<ParamField body="boardId" type="string">
  انشر على لوحة Pinterest أخرى للمستخدم عن طريق تحديد المعرف من نقطة نهاية /user/details.

  إذا لم يتم تحديده، ينشر على اللوحة الافتراضية المرتبطة.

  راجع [معرف لوحة Pinterest](/apis/post/social-networks/pinterest#board-id) لمزيد من المعلومات.
</ParamField>

<ParamField body="carouselOptions" type="array of objects">
  أضف ما يصل إلى 5 صور كـ carousel في Pinterest مع عناوين اختيارية وروابط وأوصاف.

  يمكن أن يحتوي كل كائن على: `title` و`link` و`description`.

  راجع [صور Carousel في Pinterest](/apis/post/social-networks/pinterest#pinterest-image-carousel) لمزيد من المعلومات.
</ParamField>

<ParamField body="link" type="string">
  عنوان URL الوجهة الذي سيتم توجيه المستخدمين إليه عند النقر على صورة الـ pin. الحد الأقصى 2048 حرفًا.

  ينشئ رابطًا قابلاً للنقر مرفقًا بـ pin الخاص بك.

  راجع [رابط Pin](/apis/post/social-networks/pinterest#pin-link) لمزيد من المعلومات.
</ParamField>

<ParamField body="note" type="string">
  أضف ملاحظات خاصة إلى Pins الفردية التي يمكنك أنت والمتعاونون في اللوحة فقط رؤيتها. الحد الأقصى 1000 حرف.

  راجع [ملاحظة Pin](/apis/post/social-networks/pinterest#pin-note) لمزيد من المعلومات.
</ParamField>

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

  مطلوبة لـ pins الفيديو.

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

<ParamField body="title" type="string">
  عنوان الـ pin للعرض في قسم "Add your title". الحد الأقصى 100 حرف.

  راجع [عنوان Pin](/apis/post/social-networks/pinterest#pin-title) لمزيد من المعلومات.
</ParamField>

<sup>\*</sup>الروابط في حقل `post` غير قابلة للنقر. يُرجى استخدام حقل `link` لإضافة
رابط قابل للنقر إلى Pin.

راجع [إرشادات وسائط Pinterest](/media-guidelines/pinterest) لمزيد من المعلومات.

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

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

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

```json Pinterest Alt Text theme={"system"}
{
  "pinterestOptions": {
    "altText": ["This is my best pic", "😃 here is the next one"]
  }
}
```

النص البديل محدود بـ 500 حرف.

## معرف اللوحة

انشر على لوحة Pinterest أخرى للمستخدم عن طريق تحديد المعرف الذي تم الحصول عليه من نقطة نهاية [/user/details](/apis/user/pinterest-board). خلاف ذلك، ينشر على اللوحة الافتراضية المرتبطة.

استخدم `boardId` في كائن `pinterestOptions`.

```json Pinterest Board ID theme={"system"}
{
  "pinterestOptions": {
    "boardId": "93383204522"
  }
}
```

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

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

## رابط Pin

عنوان URL الوجهة الذي سيتم توجيه المستخدمين إليه عند النقر على صورة الـ pin. يُنشئ هذا رابطًا قابلاً للنقر مرفقًا بـ pin الخاص بك. الحد الأقصى للطول 2048 حرفًا.

استخدم `link` في كائن `pinterestOptions`.

```json Pin Link theme={"system"}
{
  "pinterestOptions": {
    "link": "https://www.ayrshare.com"
  }
}
```

## ملاحظة Pin

يمكنك إضافة ملاحظات خاصة إلى Pins الفردية على لوحاتك. سيتمكن أنت والمتعاونون في اللوحة فقط من رؤيتها.

استخدم `note` في كائن `pinterestOptions`.

```json Pin Note theme={"system"}
{
  "pinterestOptions": {
    "note": "Private note for collaborators"
  }
}
```

## صور Carousel في Pinterest

انشر ما يصل إلى خمس صور كـ carousel في Pinterest. عن طريق إضافة أكثر من عنوان URL واحد للوسائط، يتم إنشاء carousel تلقائيًا. يمكنك أيضًا إضافة معلمة carousel اختيارية. يُرجى الاطلاع أدناه.

```json Pinterest Carousel Post theme={"system"}
{
  "post": "Carousel Time",
  "platforms": ["pinterest"],
  "mediaUrls": [
    "https://img.ayrshare.com/random/photo-1.jpg",
    "https://img.ayrshare.com/random/photo-2.jpg"
  ],
  "pinterestOptions": {
    "carouselOptions": [
      // optional
      {
        "title": "Image 1",
        "link": "https://www.cnn.com",
        "description": "Super Image 1"
      },
      {
        "title": "Image 2",
        "link": "https://www.google.com",
        "description": "Super Image 2"
      }
    ]
  }
}
```

يأخذ حقل `carouselOptions` الاختياري مصفوفة من الكائنات. يتوافق كل كائن carousel مع سلسلة عنوان URL للوسائط المكافئة، مثلاً كائن carousel الأول يشير إلى سلسلة `mediaUrl` الأولى.

<ul class="custom-bullets">
  <li>`title`: عنوان الصورة.</li>
  <li>`link`: رابط الوجهة الخارجي للصورة.</li>
  <li>`description`: وصف الصورة.</li>
</ul>

## إشارات Pinterest

في حين أنه يمكنك إضافة @handle إلى منشور Pinterest، إلا أن Pinterest لا يدعم حل الإشارات في نص المنشور.
سيبقى @handle كنص عادي.

## عنوان Pin

عنوان الـ pin للعرض. يظهر هذا في قسم "Add your title" من pin جديد. الحد الأقصى 100 حرف.

استخدم `title` في كائن `pinterestOptions`.

```json Pin Title theme={"system"}
{
  "pinterestOptions": {
    "title": "A Pinterest Board for You"
  }
}
```

## Pin فيديو (صورة مصغرة)

يمكن نشر فيديو كـ Pin باستخدام حقل `mediaUrls` القياسي في [نقطة نهاية /post](/apis/post/post). بالإضافة إلى ذلك، **يجب تضمين** عنوان URL لصورة مصغرة مع الفيديو بنوع محتوى وسائط صالح مثل `image/jpeg`.
يُرجى الاطلاع على [المتطلبات](/media-guidelines/pinterest).

```json Video Pin with Thumbnail theme={"system"}
{
  "pinterestOptions": {
    // required
    "thumbNail": "https://images.unsplash.com/photo-1513093496871-0a81425386e5?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=MnwxNjQ1ODN8MHwxfHJhbmRvbXx8fHx8fHx8fDE2Mzg0ODAzNDA&ixlib=rb-1.2.1&q=80&w=400"
  }
}
```

معلومات إضافية حول [نشر Pins باستخدام واجهة برمجة التطبيقات](https://www.ayrshare.com/blog/pinterest-api-integration-on-ayrshare/).

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