Publicar un pin de imagen en Pinterest
La API de Pinterest requiere que se incluya una imagen en la publicación. Los demás parámetros son opcionales. Consulta las pautas de medios de Pinterest y la autorización de Pinterest para más información.Pinterest Post
Opciones de Pinterest
Puedes establecer opciones adicionales para una publicación mediante el parámetropinterestOptions.
Pinterest Post
El texto alternativo de las imágenes y videos para accesibilidad y lectores de pantalla. Máximo 500 caracteres.Consulta texto alternativo de Pinterest para más información.
Publica en otro tablero de Pinterest del usuario especificando el ID obtenido del endpoint /user/details.Si no se especifica, publica en el tablero vinculado por defecto.Consulta Pinterest Board ID para más información.
Añade hasta 5 imágenes como un carrusel de Pinterest con títulos, enlaces y descripciones opcionales.Cada objeto puede contener:
title, link y description.Consulta carrusel de imágenes de Pinterest para más información.La URL de destino a la que se dirigirá al usuario al hacer clic en la imagen del pin. Máximo 2048 caracteres.Crea un enlace clicable asociado a tu pin.Consulta Pin Link para más información.
Añade notas privadas a pines individuales que solo tú y los colaboradores del tablero podéis ver. Máximo 1000 caracteres.Consulta Pin Note para más información.
Establece una miniatura para los pines de video. Debe ser PNG o JPG, con las mismas dimensiones que el video y menos de 10MB.Obligatorio para los pines de video.Consulta Video Pin (Thumbnail) para más información.
El título del pin que se mostrará en la sección “Add your title”. Máximo 100 caracteres.Consulta Pin Title para más información.
post no son clicables. Usa el campo link para añadir un
enlace clicable al Pin.
Consulta las pautas de medios de Pinterest para más información.
Texto alternativo
Añade texto alternativo (alt text) a una imagen o video de Pinterest. El alt text de Pinterest es una función de accesibilidad utilizada para información adicional del usuario y para lectores de pantalla. UsaaltText dentro del objeto pinterestOptions.
Pinterest Alt Text
Board ID
Publica en otro tablero de Pinterest del usuario especificando el ID obtenido del endpoint /user/details. En caso contrario, publica en el tablero vinculado por defecto. UsaboardId dentro del objeto pinterestOptions.
Pinterest Board ID
Límites de caracteres
Consulta los límites de caracteres de Pinterest para más información.Pin Link
La URL de destino a la que se dirigirá a los usuarios al hacer clic en la imagen del pin. Crea un enlace clicable asociado al pin. La longitud máxima es de 2048 caracteres. Usalink dentro del objeto pinterestOptions.
Pin Link
Pin Note
Puedes añadir notas privadas a pines individuales de tus tableros. Solo tú y los colaboradores del tablero podréis verlas. Usanote dentro del objeto pinterestOptions.
Pin Note
Carrusel de imágenes de Pinterest
Publica hasta cinco imágenes como un carrusel de Pinterest. Al añadir más de una URL de medio, se crea automáticamente un carrusel. También puedes añadir parámetros opcionales del carrusel. Consulta más abajo.Pinterest Carousel Post
carouselOptions recibe un array de objetos. Cada objeto del carrusel corresponde a la URL de medio equivalente; por ejemplo, el primer objeto del carrusel se refiere a la primera cadena de mediaUrl.
title: el título de la imagen.link: el enlace de destino externo de la imagen.description: la descripción de la imagen.
Menciones en Pinterest
Aunque puedes añadir un @handle a una publicación de Pinterest, Pinterest no admite la resolución de menciones en el texto de la publicación. El @handle permanecerá como texto plano.Pin Title
El título del pin que se mostrará. Aparece en la sección “Add your title” de un pin nuevo. Máximo 100 caracteres. Usatitle dentro del objeto pinterestOptions.
Pin Title
Pin de video (miniatura)
Se puede publicar un video como Pin mediante el campo estándarmediaUrls del endpoint /post. Además, debe incluirse una URL de imagen de miniatura junto con el video con un Content-Type de medio válido, como image/jpeg.
Consulta los requisitos.
Video Pin with Thumbnail
isVideo. Consulta el endpoint /post para más detalles.