Skip to main content

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

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

Параметри Pinterest

Ви можете встановити додаткові параметри для допису, використовуючи параметр pinterestOptions.
Pinterest Post
Параметри Pinterest — це опціональні поля, які можна використовувати для керування дописом.
array of strings
Альтернативний текст для зображень і відео для доступності та програм зчитування з екрана. Максимум 500 символів.Для отримання додаткової інформації див. Pinterest Alternative Text.
array of strings
Оголошення розкриття використання ШІ для всього Pin. Допустимі значення: AI_MODIFIED і SYNTHETIC_PERFORMER.Для отримання додаткової інформації див. Розкриття використання ШІ в Pinterest.
string
Публікація на іншій дошці Pinterest користувача, вказавши ID з кінцевої точки /user/details.Якщо не вказано, публікує на пов’язаній за замовчуванням дошці.Для отримання додаткової інформації див. Pinterest Board ID.
Додайте до 5 зображень як карусель Pinterest з опціональними заголовками, посиланнями та описами.Кожен об’єкт може містити: title, link та description.Для отримання додаткової інформації див. Pinterest Image Carousel.
URL призначення, куди перенаправляються користувачі, коли клацають зображення pin. Максимум 2048 символів.Створює клікабельне посилання, прикріплене до Вашого pin.Для отримання додаткової інформації див. Pin Link.
string
Додайте приватні нотатки до окремих Pins, які можуть бачити лише Ви та співавтори дошки. Максимум 1000 символів.Для отримання додаткової інформації див. Pin Note.
string
Встановіть мініатюру для video pins. Має бути PNG або JPG, ті ж розміри, що й відео, менше 10 МБ.Обов’язково для video pins.Для отримання додаткової інформації див. Video Pin (Thumbnail).
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 символами.

Розкриття використання ШІ в Pinterest

Використовуйте pinterestOptions.aiDisclosures, щоб надсилати оголошення Pinterest про розкриття використання ШІ під час створення Pin. Розкриття застосовуються до всього Pin, включно з каруселями зображень, і підтримуються для Image Pin, Carousel Pin і Video Pin.
Pinterest AI Disclosure
Ви можете надіслати обидва допустимі значення разом:
Pinterest AI Disclosure
Допустимі значення:
  • AI_MODIFIED: Pin містить вміст, змінений за допомогою ШІ.
  • SYNTHETIC_PERFORMER: Pin містить синтетичного виконавця.
Якщо aiDisclosures пропущено або це порожній масив, Ayrshare не надсилає до Pinterest поле розкриття використання ШІ. Дубльовані значення надсилаються один раз. Значення чутливі до регістру й не перетворюються. Якщо параметр недійсний, наприклад невідоме значення, неправильний регістр, значення, що не є масивом, або масив із нерядковим елементом, Pin усе одно може бути успішно опублікований, але Ayrshare пропускає весь параметр розкриття й повертає нефатальне попередження в результаті Pinterest. Виправте запит і надішліть одне або обидва допустимі значення, якщо Pin потребує явного розкриття використання ШІ. Pinterest усе одно може застосовувати власні мітки незалежно. MCP-сервер і GraphQL API спершу перевіряють типи значень. У цих інтерфейсах некоректне значення, наприклад список, що містить число, відхиляється ще до публікації, а не публікується з попередженням. Невідомі рядки або рядки з неправильним регістром усе одно публікуються з попередженням.

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.