跳转到主要内容

发布图片 Pin 到 Pinterest

Pinterest API 要求帖子中必须包含图片。其他参数是可选的。 更多信息请参见 Pinterest 媒体指南Pinterest 授权
Pinterest Post

Pinterest 选项

你可以使用 pinterestOptions 参数为帖子设置额外选项。
Pinterest Post
Pinterest 选项是可选字段,可用于控制帖子。
altText
array of strings
用于无障碍和屏幕阅读器的图片和视频替代文本。最多 500 个字符。更多信息请参见 Pinterest 替代文本
boardId
string
通过指定 /user/details 端点获取的 ID,发布到用户的其他 Pinterest 看板。如果未指定,将发布到默认关联的看板。更多信息请参见 Pinterest 看板 ID
将最多 5 张图片作为 Pinterest 轮播添加,可选包含标题、链接和描述。每个对象可以包含:titlelinkdescription更多信息请参见 Pinterest 图片轮播
用户点击 Pin 图片时将被引导到的目标 URL。最多 2048 个字符。在你的 Pin 上创建一个可点击的链接。更多信息请参见 Pin 链接
note
string
为单个 Pin 添加私人备注,只有你和看板协作者可以查看。最多 1000 个字符。更多信息请参见 Pin 备注
thumbNail
string
为视频 Pin 设置缩略图。必须为 PNG 或 JPG,与视频尺寸相同,大小不超过 10MB。视频 Pin 必填。更多信息请参见 视频 Pin(缩略图)
title
string
Pin 的标题,显示在 “Add your title” 部分。最多 100 个字符。更多信息请参见 Pin 标题
*post 字段中的链接不可点击。请使用 link 字段为 Pin 添加 可点击的链接。 更多信息请参见 Pinterest 媒体指南

替代文本

为 Pinterest 图片或视频添加替代文本(也称为 alt text)。Pinterest 替代文本是一项无障碍功能,用于提供附加的用户信息并支持屏幕阅读器。 pinterestOptions 对象中使用 altText
Pinterest Alt Text
替代文本限制为 500 个字符。

看板 ID

通过指定从 /user/details 端点获取的 ID,发布到用户的其他 Pinterest 看板。否则发布到默认关联的看板。 pinterestOptions 对象中使用 boardId
Pinterest Board ID

字符限制

更多信息请参见 Pinterest 字符限制

Pin 链接

用户点击你的 Pin 图片时将被引导到的目标 URL。这会在你的 Pin 上创建一个可点击的链接。最大长度为 2048 个字符。 pinterestOptions 对象中使用 link
Pin Link

Pin 备注

你可以为你看板上的单个 Pin 添加私人备注。只有你和看板协作者可以看到它们。 pinterestOptions 对象中使用 note
Pin Note

Pinterest 图片轮播

将最多五张图片作为 Pinterest 轮播发布。通过添加多个媒体 URL,会自动创建轮播。你还可以添加可选的轮播参数。请见下方。
Pinterest Carousel Post
可选的 carouselOptions 字段接受一个对象数组。每个轮播对象对应等效的媒体 URL 字符串,例如,第一个轮播对象引用第一个 mediaUrl 字符串。
  • title:图片标题。
  • link:图片的外部目标链接。
  • description:图片描述。

Pinterest 提及

虽然你可以在 Pinterest 帖子中添加 @handle,但 Pinterest 不支持在帖子文本中解析提及。 @handle 将保留为纯文本。

Pin 标题

要显示的 Pin 标题。它出现在新 Pin 的 “Add your title” 部分。最多 100 个字符。 pinterestOptions 对象中使用 title
Pin Title

视频 Pin(缩略图)

可以使用 /post 端点 中的标准 mediaUrls 字段将视频作为 Pin 发布。此外,视频必须包含缩略图图片 URL,并具有有效的媒体 Content-Type,例如 image/jpeg。 请参见要求
Video Pin with Thumbnail
关于使用 API 发布 Pin 的更多信息。 如果你的视频不是以已知的视频扩展名(如 mp4)结尾,请使用 isVideo 参数。详情请参见 /post 端点