Passer au contenu principal

Publier une épingle image sur Pinterest

L’API Pinterest nécessite qu’une image soit incluse dans la publication. Les autres paramètres sont facultatifs. Consultez Pinterest Media Guidelines et Pinterest Authorization pour plus d’informations.
Pinterest Post

Options Pinterest

Vous pouvez définir des options supplémentaires pour une publication en utilisant le paramètre pinterestOptions.
Pinterest Post
Les options Pinterest sont des champs facultatifs qui peuvent être utilisés pour contrôler la publication.
altText
array of strings
Le texte alternatif des images et vidéos pour l’accessibilité et les lecteurs d’écran. Maximum 500 caractères.Consultez Texte alternatif Pinterest pour plus d’informations.
boardId
string
Publiez sur un autre des tableaux Pinterest de l’utilisateur en spécifiant l’ID du point de terminaison /user/details.Si non spécifié, publie sur le tableau associé par défaut.Consultez ID de tableau Pinterest pour plus d’informations.
Ajoutez jusqu’à 5 images en carrousel Pinterest avec des titres, liens et descriptions facultatifs.Chaque objet peut contenir : title, link et description.Consultez Carrousel d’images Pinterest pour plus d’informations.
L’URL de destination vers laquelle les utilisateurs seront dirigés lorsqu’ils cliqueront sur l’image de l’épingle. Maximum 2 048 caractères.Crée un lien cliquable attaché à votre épingle.Consultez Lien de l’épingle pour plus d’informations.
note
string
Ajoutez des notes privées à chaque épingle que vous et les collaborateurs du tableau sont seuls à voir. Maximum 1 000 caractères.Consultez Note de l’épingle pour plus d’informations.
thumbNail
string
Définit une miniature pour les épingles vidéo. Doit être PNG ou JPG, mêmes dimensions que la vidéo, moins de 10 Mo.Requis pour les épingles vidéo.Consultez Épingle vidéo (miniature) pour plus d’informations.
title
string
Le titre de l’épingle à afficher dans la section « Add your title ». Maximum 100 caractères.Consultez Titre de l’épingle pour plus d’informations.
*Les liens dans le champ post ne sont pas cliquables. Utilisez le champ link pour ajouter un lien cliquable à l’épingle. Consultez Pinterest Media Guidelines pour plus d’informations.

Texte alternatif

Ajoutez du texte alternatif, également appelé alt text, à une image ou une vidéo Pinterest. L’alt text Pinterest est une fonctionnalité d’accessibilité utilisée pour fournir des informations supplémentaires aux utilisateurs et aux lecteurs d’écran. Utilisez altText dans l’objet pinterestOptions.
Pinterest Alt Text
L’alt text est limité à 500 caractères.

ID de tableau

Publiez sur un autre des tableaux Pinterest de l’utilisateur en spécifiant l’ID obtenu depuis le point de terminaison /user/details. Sinon, la publication se fait sur le tableau associé par défaut. Utilisez boardId dans l’objet pinterestOptions.
Pinterest Board ID

Limites de caractères

Consultez Pinterest Character Limits pour plus d’informations.

Lien de l’épingle

L’URL de destination vers laquelle les utilisateurs seront dirigés lorsqu’ils cliqueront sur l’image de votre épingle. Cela crée un lien cliquable attaché à votre épingle. Longueur maximale : 2 048 caractères. Utilisez link dans l’objet pinterestOptions.
Pin Link

Note de l’épingle

Vous pouvez ajouter des notes privées à chaque épingle de vos tableaux. Seuls vous et les collaborateurs du tableau pourront les voir. Utilisez note dans l’objet pinterestOptions.
Pin Note

Carrousel d’images Pinterest

Publiez jusqu’à cinq images en carrousel Pinterest. En ajoutant plus d’une URL de média, un carrousel est automatiquement créé. Vous pouvez également ajouter des paramètres de carrousel facultatifs. Voir ci-dessous.
Pinterest Carousel Post
Le champ facultatif carouselOptions prend un tableau d’objets. Chaque objet carrousel correspond à la chaîne d’URL de média équivalente : par exemple, le premier objet carrousel fait référence à la première chaîne mediaUrl.
  • title : le titre de l’image.
  • link : le lien de destination externe pour l’image.
  • description : la description de l’image.

Mentions Pinterest

Bien que vous puissiez ajouter un @handle à une publication Pinterest, Pinterest ne prend pas en charge la résolution des mentions dans le texte de la publication. Le @handle restera sous forme de texte simple.

Titre de l’épingle

Le titre de l’épingle à afficher. Il apparaît dans la section « Add your title » d’une nouvelle épingle. Maximum 100 caractères. Utilisez title dans l’objet pinterestOptions.
Pin Title

Épingle vidéo (miniature)

Une vidéo peut être publiée en tant qu’épingle à l’aide du champ standard mediaUrls dans le point de terminaison /post. En outre, une URL d’image miniature doit être incluse avec la vidéo, avec un Content-Type de média valide tel que image/jpeg. Consultez les exigences.
Video Pin with Thumbnail
Informations complémentaires sur la publication d’épingles via l’API. Si votre vidéo ne se termine pas par une extension vidéo connue telle que mp4, utilisez le paramètre isVideo. Consultez le point de terminaison /post pour plus de détails.