發布圖片 Pin 到 Pinterest
Pinterest API 要求貼文中必須包含圖片,其他參數則為選填。 更多資訊請參閱 Pinterest 媒體指南 與 Pinterest 授權。Pinterest Post
Pinterest 選項
你可以透過pinterestOptions 參數為貼文設定額外的選項。
Pinterest Post
圖片與影片的替代文字(alt text),為無障礙功能,可協助螢幕閱讀器讀取內容。最多 500 個字元。更多資訊請參閱 Pinterest 替代文字。
透過指定 /user/details 端點回傳的 ID,將貼文發布到使用者另一個 Pinterest Board。若未指定,會發布到預設連結的 board。更多資訊請參閱 Pinterest Board ID。
以 Pinterest 輪播 Pin 的形式最多發布 5 張圖片,並可為每張圖片加上選填的標題、連結與描述。每個物件可包含:
title、link 與 description。更多資訊請參閱 Pinterest 圖片輪播。post 欄位中的連結無法點擊,請使用 link 欄位為 Pin 加上可點擊的連結。
更多資訊請參閱 Pinterest 媒體指南。
替代文字
為 Pinterest 圖片或影片加上替代文字(alt text)。Pinterest 的 alt text 是一項無障礙功能,可提供額外的使用者資訊,並協助螢幕閱讀器讀取內容。 請在pinterestOptions 物件中使用 altText。
Pinterest Alt Text
Board ID
透過指定從 /user/details 端點取得的 ID,將貼文發布到使用者另一個 Pinterest Board。否則會發布到預設連結的 board。 請在pinterestOptions 物件中使用 boardId。
Pinterest Board ID
字元限制
更多資訊請參閱 Pinterest 字元限制。Pin 連結
使用者點擊你的 Pin 圖片時會被導向的目的網址。這會為你的 Pin 加上一個可點擊的連結。長度上限為 2048 個字元。 請在pinterestOptions 物件中使用 link。
Pin Link
Pin 備註
你可以在 board 上的個別 Pin 加上私密備註,只有你和 board 的協作者能看到。 請在pinterestOptions 物件中使用 note。
Pin Note
Pinterest 圖片輪播
以 Pinterest 輪播 Pin 的形式發布最多五張圖片。當你加入多個媒體 URL 時,系統會自動建立輪播。你也可以加入選填的 carousel 參數(如下所示)。Pinterest Carousel Post
carouselOptions 欄位接受一個物件陣列。每個 carousel 物件會對應到相同順序的媒體 URL,例如第一個 carousel 物件對應第一個 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 端點。