Chuyển đến nội dung chính

Đă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 GuidelinesPinterest Authorization để biết thêm thông tin.
Pinterest Post

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.
Pinterest Post
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.
altText
array of strings
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 để biết thêm thông tin.
boardId
string
Đă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 để 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 để 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 để biết thêm thông tin.
note
string
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 để biết thêm thông tin.
thumbNail
string
Đặ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) để biết thêm thông tin.
title
string
Tiêu đề của pin để hiển thị trong phần “Add your title”. Tối đa 100 ký tự.Xem 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 để 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.
Pinterest Alt Text
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. 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.
Pinterest Board ID

Giới hạn ký tự

Vui lòng xem Giới hạn ký tự Pinterest để biết thêm thông tin. 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.
Pin Link

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.
Pin Note
Đă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.
Pinterest Carousel Post
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.
  • title: Tiêu đề hình ảnh.
  • link: Liên kết đích bên ngoài cho hình ảnh.
  • description: Mô tả hình ảnh.

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.
Pin Title

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. 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.
Video Pin with Thumbnail
Thông tin bổ sung về đăng Pin bằng API. 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 để biết chi tiết.