الانتقال إلى المحتوى الرئيسي

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

يتطلب Pinterest API تضمين صورة في المنشور. المعلمات الأخرى اختيارية. يُرجى الاطلاع على إرشادات وسائط Pinterest وتفويض Pinterest لمزيد من المعلومات.
Pinterest Post

خيارات Pinterest

يمكنك تعيين خيارات إضافية للمنشور باستخدام معلمة pinterestOptions.
Pinterest Post
خيارات Pinterest هي حقول اختيارية يمكن استخدامها للتحكم في المنشور.
altText
array of strings
النص البديل للصور ومقاطع الفيديو من أجل الوصول وقارئات الشاشة. الحد الأقصى 500 حرف.راجع النص البديل في Pinterest لمزيد من المعلومات.
boardId
string
انشر على لوحة Pinterest أخرى للمستخدم عن طريق تحديد المعرف من نقطة نهاية /user/details.إذا لم يتم تحديده، ينشر على اللوحة الافتراضية المرتبطة.راجع معرف لوحة Pinterest لمزيد من المعلومات.
أضف ما يصل إلى 5 صور كـ carousel في Pinterest مع عناوين اختيارية وروابط وأوصاف.يمكن أن يحتوي كل كائن على: title وlink وdescription.راجع صور Carousel في Pinterest لمزيد من المعلومات.
عنوان URL الوجهة الذي سيتم توجيه المستخدمين إليه عند النقر على صورة الـ pin. الحد الأقصى 2048 حرفًا.ينشئ رابطًا قابلاً للنقر مرفقًا بـ pin الخاص بك.راجع رابط Pin لمزيد من المعلومات.
note
string
أضف ملاحظات خاصة إلى Pins الفردية التي يمكنك أنت والمتعاونون في اللوحة فقط رؤيتها. الحد الأقصى 1000 حرف.راجع ملاحظة Pin لمزيد من المعلومات.
thumbNail
string
قم بتعيين صورة مصغرة لـ pins الفيديو. يجب أن تكون PNG أو JPG، بنفس أبعاد الفيديو، أقل من 10 ميجابايت.مطلوبة لـ pins الفيديو.راجع Pin فيديو (صورة مصغرة) لمزيد من المعلومات.
title
string
عنوان الـ pin للعرض في قسم “Add your title”. الحد الأقصى 100 حرف.راجع عنوان Pin لمزيد من المعلومات.
*الروابط في حقل post غير قابلة للنقر. يُرجى استخدام حقل link لإضافة رابط قابل للنقر إلى Pin. راجع إرشادات وسائط Pinterest لمزيد من المعلومات.

النص البديل

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

معرف اللوحة

انشر على لوحة Pinterest أخرى للمستخدم عن طريق تحديد المعرف الذي تم الحصول عليه من نقطة نهاية /user/details. خلاف ذلك، ينشر على اللوحة الافتراضية المرتبطة. استخدم boardId في كائن pinterestOptions.
Pinterest Board ID

حدود الأحرف

يُرجى مراجعة حدود أحرف Pinterest لمزيد من المعلومات.

رابط Pin

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

ملاحظة Pin

يمكنك إضافة ملاحظات خاصة إلى Pins الفردية على لوحاتك. سيتمكن أنت والمتعاونون في اللوحة فقط من رؤيتها. استخدم note في كائن pinterestOptions.
Pin Note
انشر ما يصل إلى خمس صور كـ carousel في Pinterest. عن طريق إضافة أكثر من عنوان URL واحد للوسائط، يتم إنشاء carousel تلقائيًا. يمكنك أيضًا إضافة معلمة carousel اختيارية. يُرجى الاطلاع أدناه.
Pinterest Carousel Post
يأخذ حقل carouselOptions الاختياري مصفوفة من الكائنات. يتوافق كل كائن carousel مع سلسلة عنوان URL للوسائط المكافئة، مثلاً كائن carousel الأول يشير إلى سلسلة mediaUrl الأولى.
  • title: عنوان الصورة.
  • link: رابط الوجهة الخارجي للصورة.
  • description: وصف الصورة.

إشارات Pinterest

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

عنوان Pin

عنوان الـ pin للعرض. يظهر هذا في قسم “Add your title” من pin جديد. الحد الأقصى 100 حرف. استخدم title في كائن pinterestOptions.
Pin Title

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

يمكن نشر فيديو كـ Pin باستخدام حقل mediaUrls القياسي في نقطة نهاية /post. بالإضافة إلى ذلك، يجب تضمين عنوان URL لصورة مصغرة مع الفيديو بنوع محتوى وسائط صالح مثل image/jpeg. يُرجى الاطلاع على المتطلبات.
Video Pin with Thumbnail
معلومات إضافية حول نشر Pins باستخدام واجهة برمجة التطبيقات. إذا كان الفيديو الخاص بك لا ينتهي بامتداد فيديو معروف مثل mp4، فيرجى استخدام معلمة isVideo. راجع نقطة نهاية /post للحصول على التفاصيل.