发布图片 Pin 到 Pinterest
Pinterest API 要求帖子中必须包含图片。其他参数是可选的。 更多信息请参见 Pinterest 媒体指南 和 Pinterest 授权。Pinterest Post
Pinterest 选项
你可以使用pinterestOptions 参数为帖子设置额外选项。
Pinterest Post
用于无障碍和屏幕阅读器的图片和视频替代文本。最多 500 个字符。更多信息请参见 Pinterest 替代文本。
post 字段中的链接不可点击。请使用 link 字段为 Pin 添加
可点击的链接。
更多信息请参见 Pinterest 媒体指南。
替代文本
为 Pinterest 图片或视频添加替代文本(也称为 alt text)。Pinterest 替代文本是一项无障碍功能,用于提供附加的用户信息并支持屏幕阅读器。 在pinterestOptions 对象中使用 altText。
Pinterest Alt Text
看板 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
isVideo 参数。详情请参见 /post 端点。