> ## 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. # Pinterest API > Các tùy chọn để đăng bài bằng Pinterest API ## Đăng Pin hình ảnh lên Pinterest Pinterest API yêu cầu một hình ảnh phải được bao gồm trong bài đăng. Các tham số khác là tùy chọn. Vui lòng xem [Pinterest Media Guidelines](/media-guidelines/pinterest) và [Pinterest Authorization](/dashboard/connect-social-accounts/pinterest) để biết thêm thông tin. ```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"] } ``` ## Tùy chọn Pinterest Bạn có thể đặt các tùy chọn bổ sung cho bài đăng bằng cách sử dụng tham số `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 } } ``` Các tùy chọn Pinterest là các trường tùy chọn có thể được dùng để kiểm soát bài đăng. Văn bản thay thế cho hình ảnh và video để hỗ trợ khả năng tiếp cận và trình đọc màn hình. Tối đa 500 ký tự. Xem [Văn bản thay thế Pinterest](/apis/post/social-networks/pinterest#alternative-text) để biết thêm thông tin. Đăng lên một Pinterest Board khác của người dùng bằng cách chỉ định ID từ endpoint /user/details. Nếu không chỉ định, đăng lên board được liên kết mặc định. Xem [Pinterest Board ID](/apis/post/social-networks/pinterest#board-id) để biết thêm thông tin. Thêm tối đa 5 hình ảnh dưới dạng carousel Pinterest với các tiêu đề, liên kết, và mô tả tùy chọn. Mỗi đối tượng có thể chứa: `title`, `link`, và `description`. Xem [Pinterest Image Carousel](/apis/post/social-networks/pinterest#pinterest-image-carousel) để biết thêm thông tin. URL đích mà người dùng sẽ được chuyển hướng đến khi nhấp vào hình ảnh pin. Tối đa 2048 ký tự. Tạo một liên kết có thể nhấp gắn với pin của bạn. Xem [Pin Link](/apis/post/social-networks/pinterest#pin-link) để biết thêm thông tin. Thêm ghi chú riêng tư cho từng Pin mà chỉ bạn và các cộng tác viên của board có thể xem. Tối đa 1000 ký tự. Xem [Pin Note](/apis/post/social-networks/pinterest#pin-note) để biết thêm thông tin. Đặt thumbnail cho video pin. Phải là PNG hoặc JPG, cùng kích thước với video, dưới 10MB. Bắt buộc đối với video pin. Xem [Video Pin (Thumbnail)](/apis/post/social-networks/pinterest#video-pin-thumbnail) để biết thêm thông tin. Tiêu đề của pin để hiển thị trong phần "Add your title". Tối đa 100 ký tự. Xem [Pin Title](/apis/post/social-networks/pinterest#pin-title) để biết thêm thông tin. \*Các liên kết trong trường `post` không thể nhấp được. Vui lòng dùng trường `link` để thêm liên kết có thể nhấp vào Pin. Xem [Pinterest Media Guidelines](/media-guidelines/pinterest) để biết thêm thông tin. ## Văn bản thay thế (Alt Text) Thêm văn bản thay thế, còn được gọi là alt text, vào hình ảnh hoặc video Pinterest. Alt text Pinterest là một tính năng trợ năng được sử dụng cho thông tin bổ sung của người dùng và trình đọc màn hình. Sử dụng `altText` trong đối tượng `pinterestOptions`. ```json Pinterest Alt Text theme={"system"} { "pinterestOptions": { "altText": ["This is my best pic", "😃 here is the next one"] } } ``` Alt text được giới hạn ở 500 ký tự. ## Board ID Đăng lên một Pinterest Board khác của người dùng bằng cách chỉ định ID lấy từ endpoint [/user/details](/apis/user/pinterest-board). Nếu không, đăng lên board được liên kết mặc định. Sử dụng `boardId` trong đối tượng `pinterestOptions`. ```json Pinterest Board ID theme={"system"} { "pinterestOptions": { "boardId": "93383204522" } } ``` ## Giới hạn ký tự Vui lòng xem [Giới hạn ký tự Pinterest](/help-center/technical-support/character_limits#pinterest-character-limits) để biết thêm thông tin. ## Pin Link URL đích mà người dùng sẽ được chuyển hướng đến khi họ nhấp vào hình ảnh pin. Điều này tạo ra một liên kết có thể nhấp gắn với pin của bạn. Độ dài tối đa là 2048 ký tự. Sử dụng `link` trong đối tượng `pinterestOptions`. ```json Pin Link theme={"system"} { "pinterestOptions": { "link": "https://www.ayrshare.com" } } ``` ## Pin Note Bạn có thể thêm ghi chú riêng tư cho từng Pin trên các board. Chỉ bạn và các cộng tác viên của board mới có thể xem. Sử dụng `note` trong đối tượng `pinterestOptions`. ```json Pin Note theme={"system"} { "pinterestOptions": { "note": "Private note for collaborators" } } ``` ## Carousel hình ảnh Pinterest Đăng tối đa năm hình ảnh dưới dạng carousel Pinterest. Bằng cách thêm nhiều hơn một URL phương tiện, một carousel sẽ được tạo tự động. Bạn cũng có thể thêm tham số carousel tùy chọn. Vui lòng xem bên dưới. ```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" } ] } } ``` Trường `carouselOptions` tùy chọn nhận một mảng các đối tượng. Mỗi đối tượng carousel tương ứng với chuỗi URL phương tiện tương đương, ví dụ, đối tượng carousel đầu tiên tham chiếu đến chuỗi `mediaUrl` đầu tiên. ## Nhắc tên (Mention) trên Pinterest Trong khi bạn có thể thêm @handle vào một bài đăng Pinterest, Pinterest không hỗ trợ giải quyết nhắc tên trong nội dung bài đăng. @handle sẽ vẫn là văn bản thuần túy. ## Pin Title Tiêu đề của pin để hiển thị. Điều này xuất hiện trong phần "Add your title" của một pin mới. Tối đa 100 ký tự. Sử dụng `title` trong đối tượng `pinterestOptions`. ```json Pin Title theme={"system"} { "pinterestOptions": { "title": "A Pinterest Board for You" } } ``` ## Video Pin (Thumbnail) Một video có thể được đăng dưới dạng Pin bằng trường `mediaUrls` tiêu chuẩn trong [endpoint /post](/apis/post/post). Ngoài ra, một URL hình ảnh thumbnail **phải được bao gồm** với video có Content-Type phương tiện hợp lệ như `image/jpeg`. Vui lòng xem [yêu cầu](/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" } } ``` Thông tin bổ sung về [đăng Pin bằng API](https://www.ayrshare.com/blog/pinterest-api-integration-on-ayrshare/). Nếu video của bạn không kết thúc bằng phần mở rộng video đã biết như mp4, vui lòng sử dụng tham số `isVideo`. Xem [endpoint /post](/apis/post/post) để biết chi tiết.