Перейти до основного вмісту

Публікація Image Pin у Pinterest

Pinterest API вимагає включення зображення в допис. Інші параметри є опціональними. Для отримання додаткової інформації див. Pinterest Media Guidelines та Pinterest Authorization.
Pinterest Post

Параметри Pinterest

Ви можете встановити додаткові параметри для допису, використовуючи параметр pinterestOptions.
Pinterest Post
Параметри Pinterest — це опціональні поля, які можна використовувати для керування дописом.
altText
array of strings
Альтернативний текст для зображень і відео для доступності та програм зчитування з екрана. Максимум 500 символів.Для отримання додаткової інформації див. Pinterest Alternative Text.
boardId
string
Публікація на іншій дошці Pinterest користувача, вказавши ID з кінцевої точки /user/details.Якщо не вказано, публікує на пов’язаній за замовчуванням дошці.Для отримання додаткової інформації див. Pinterest Board ID.
Додайте до 5 зображень як карусель Pinterest з опціональними заголовками, посиланнями та описами.Кожен об’єкт може містити: title, link та description.Для отримання додаткової інформації див. Pinterest Image Carousel.
URL призначення, куди перенаправляються користувачі, коли клацають зображення pin. Максимум 2048 символів.Створює клікабельне посилання, прикріплене до Вашого pin.Для отримання додаткової інформації див. Pin Link.
note
string
Додайте приватні нотатки до окремих Pins, які можуть бачити лише Ви та співавтори дошки. Максимум 1000 символів.Для отримання додаткової інформації див. Pin Note.
thumbNail
string
Встановіть мініатюру для video pins. Має бути PNG або JPG, ті ж розміри, що й відео, менше 10 МБ.Обов’язково для video pins.Для отримання додаткової інформації див. Video Pin (Thumbnail).
title
string
Заголовок pin для відображення в розділі “Add your title”. Максимум 100 символів.Для отримання додаткової інформації див. Pin Title.
*Посилання в полі post не є клікабельними. Будь ласка, використовуйте поле link, щоб додати клікабельне посилання до Pin. Для отримання додаткової інформації див. Pinterest Media Guidelines.

Alternative Text

Додайте альтернативний текст, також відомий як alt text, до зображення або відео Pinterest. Alt text Pinterest — це функція доступності, що використовується для додаткової інформації користувача та програм зчитування з екрана. Використовуйте altText в об’єкті pinterestOptions.
Pinterest Alt Text
Alt text обмежено 500 символами.

Board ID

Публікація на іншій дошці Pinterest користувача, вказавши ID, отриманий з кінцевої точки /user/details. В іншому випадку публікація на пов’язаній за замовчуванням дошці. Використовуйте boardId в об’єкті pinterestOptions.
Pinterest Board ID

Обмеження символів

Для отримання додаткової інформації див. Обмеження символів Pinterest. URL призначення, куди перенаправляються користувачі, коли клацають на зображення pin. Це створює клікабельне посилання, прикріплене до Вашого pin. Максимальна довжина — 2048 символів. Використовуйте link в об’єкті pinterestOptions.
Pin Link

Pin Note

Ви можете додати приватні нотатки до окремих Pins на своїх дошках. Тільки Ви та співавтори дошки зможете їх побачити. Використовуйте note в об’єкті pinterestOptions.
Pin Note
Опублікуйте до п’яти зображень як карусель Pinterest. Додаючи більше одного URL медіа, карусель створюється автоматично. Ви також можете додати опціональний параметр carousel. Див. нижче.
Pinterest Carousel Post
Опціональне поле carouselOptions приймає масив об’єктів. Кожен об’єкт карусель відповідає еквівалентному рядку URL медіа, тобто перший об’єкт карусель відноситься до першого рядка mediaUrl.
  • title: Заголовок зображення.
  • link: Зовнішнє посилання призначення для зображення.
  • description: Опис зображення.

Згадування Pinterest

Хоча Ви можете додати @handle до допису Pinterest, Pinterest не підтримує розкриття згадувань у тексті допису. @handle залишається як звичайний текст.

Pin Title

Заголовок pin для відображення. З’являється в розділі “Add your title” нового pin. Максимум 100 символів. Використовуйте title в об’єкті pinterestOptions.
Pin Title

Video Pin (Thumbnail)

Відео можна опублікувати як Pin, використовуючи стандартне поле mediaUrls у кінцевій точці /post. Крім того, URL мініатюри має бути включено з відео з дійсним медіа Content-Type, наприклад image/jpeg. Див. вимоги.
Video Pin with Thumbnail
Додаткова інформація про публікацію Pins за допомогою API. Якщо Ваше відео не закінчується відомим розширенням відео, як mp4, будь ласка, використовуйте параметр isVideo. Для деталей див. кінцеву точку /post.