Skip to main content

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

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

خيارات Pinterest

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

النص البديل

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

إفصاحات AI في Pinterest

استخدم pinterestOptions.aiDisclosures لإرسال تصريحات إفصاح الذكاء الاصطناعي (AI) الخاصة بـ Pinterest عند إنشاء Pin. تنطبق الإفصاحات على الـ Pin بأكمله، بما في ذلك صور Carousel، وهي مدعومة في Pins الصور وPins الـ Carousel وPins الفيديو.
Pinterest AI Disclosure
يمكنك إرسال القيمتين المقبولتين معًا:
Pinterest AI Disclosure
القيم المقبولة:
  • AI_MODIFIED: يحتوي الـ Pin على محتوى معدَّل بالذكاء الاصطناعي.
  • SYNTHETIC_PERFORMER: يحتوي الـ Pin على مؤدٍّ اصطناعي.
إذا أُغفل aiDisclosures أو كان مصفوفة فارغة، فلن ترسل Ayrshare إلى Pinterest أي حقل إفصاح عن الذكاء الاصطناعي. تُرسل القيم المكررة مرة واحدة. القيم حساسة لحالة الأحرف ولا يتم تحويلها. إذا كان الخيار غير صالح، على سبيل المثال قيمة غير معروفة، أو حالة أحرف خاطئة، أو قيمة ليست مصفوفة، أو مصفوفة تحتوي على عنصر ليس نصيًا، فلا يزال من الممكن نشر الـ Pin بنجاح، لكن Ayrshare تُسقط خيار الإفصاح بالكامل وتُعيد تحذيرًا غير فادح في نتيجة Pinterest. صحّح الطلب وأرسل قيمة مقبولة واحدة أو كلتيهما إذا كان الـ Pin يحتاج إلى إفصاح صريح عن الذكاء الاصطناعي. قد يطبّق Pinterest مع ذلك ملصقاته الخاصة بشكل مستقل. يتحقق خادم MCP وGraphQL API من أنواع القيم أولًا. على هاتين الواجهتين، تُرفض القيمة غير الصحيحة البنية، مثل قائمة تحتوي على رقم، قبل النشر بدلًا من النشر مع تحذير. أما النصوص غير المعروفة أو ذات حالة الأحرف الخاطئة فلا تزال تُنشر مع التحذير.

معرف اللوحة

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

حدود الأحرف

يُرجى مراجعة حدود أحرف Pinterest لمزيد من المعلومات. عنوان 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 للحصول على التفاصيل.