> ## Documentation Index > Fetch the complete documentation index at: https://www.ayrshare.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # API Pinterest > Options de publication à l'aide de l'API Pinterest ## 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](/media-guidelines/pinterest) et [Pinterest Authorization](/dashboard/connect-social-accounts/pinterest) pour plus d'informations. ```json Pinterest Post theme={"system"} { "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string "platforms": ["pinterest"], "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"] } ``` ## Options Pinterest Vous pouvez définir des options supplémentaires pour une publication en utilisant le paramètre `pinterestOptions`. ```json Pinterest Post theme={"system"} { "post": "The best Pinterest API ever!", // Maximum 500 characters or empty string "platforms": ["pinterest"], "mediaUrls": ["https://images.ayrshare.com/imgs/GhostBusters.jpg"], "pinterestOptions": { "altText": ["This is my best pic", "😃 here is the next one"], // maximum 500 characters "boardId": "93383204522", "carouselOptions": [ { "title": "Image 1", "link": "https://www.cnn.com", "description": "Super Image 1" }, { "title": "Image 2", "link": "https://www.google.com", "description": "Super Image 2" } ], "link": "https://www.ayrshare.com", // maximum 2048 characters "note": "Private note", // maximum 1000 characters "thumbNail": "https://images.ayrshare.com/imgs/GhostBusters.jpg", "title": "A Pinterest Board for You" // maximum 100 characters } } ``` Les options Pinterest sont des champs facultatifs qui peuvent être utilisés pour contrôler la publication. Le texte alternatif des images et vidéos pour l'accessibilité et les lecteurs d'écran. Maximum 500 caractères. Consultez [Texte alternatif Pinterest](/apis/post/social-networks/pinterest#alternative-text) pour plus d'informations. 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](/apis/post/social-networks/pinterest#board-id) 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](/apis/post/social-networks/pinterest#pinterest-image-carousel) 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](/apis/post/social-networks/pinterest#pin-link) pour plus d'informations. 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](/apis/post/social-networks/pinterest#pin-note) pour plus d'informations. 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)](/apis/post/social-networks/pinterest#video-pin-thumbnail) pour plus d'informations. Le titre de l'épingle à afficher dans la section « Add your title ». Maximum 100 caractères. Consultez [Titre de l'épingle](/apis/post/social-networks/pinterest#pin-title) 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](/media-guidelines/pinterest) 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`. ```json Pinterest Alt Text theme={"system"} { "pinterestOptions": { "altText": ["This is my best pic", "😃 here is the next one"] } } ``` 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](/apis/user/pinterest-board). Sinon, la publication se fait sur le tableau associé par défaut. Utilisez `boardId` dans l'objet `pinterestOptions`. ```json Pinterest Board ID theme={"system"} { "pinterestOptions": { "boardId": "93383204522" } } ``` ## Limites de caractères Consultez [Pinterest Character Limits](/help-center/technical-support/character_limits#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`. ```json Pin Link theme={"system"} { "pinterestOptions": { "link": "https://www.ayrshare.com" } } ``` ## 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`. ```json Pin Note theme={"system"} { "pinterestOptions": { "note": "Private note for collaborators" } } ``` ## 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. ```json Pinterest Carousel Post theme={"system"} { "post": "Carousel Time", "platforms": ["pinterest"], "mediaUrls": [ "https://img.ayrshare.com/random/photo-1.jpg", "https://img.ayrshare.com/random/photo-2.jpg" ], "pinterestOptions": { "carouselOptions": [ // optional { "title": "Image 1", "link": "https://www.cnn.com", "description": "Super Image 1" }, { "title": "Image 2", "link": "https://www.google.com", "description": "Super Image 2" } ] } } ``` 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`. ## 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`. ```json Pin Title theme={"system"} { "pinterestOptions": { "title": "A Pinterest Board for You" } } ``` ## É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](/apis/post/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](/media-guidelines/pinterest). ```json Video Pin with Thumbnail theme={"system"} { "pinterestOptions": { // required "thumbNail": "https://images.unsplash.com/photo-1513093496871-0a81425386e5?crop=entropy&cs=tinysrgb&fit=max&fm=jpg&ixid=MnwxNjQ1ODN8MHwxfHJhbmRvbXx8fHx8fHx8fDE2Mzg0ODAzNDA&ixlib=rb-1.2.1&q=80&w=400" } } ``` Informations complémentaires sur la [publication d'épingles via l'API](https://www.ayrshare.com/blog/pinterest-api-integration-on-ayrshare/). 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](/apis/post/post) pour plus de détails.