Skip to main content
PATCH
更新貼文的 scheduleDate、approval 審核狀態、notes,或已發布 YouTube 影片的 visibility。
  • 貼文原本必須有 scheduleDate 且 status 為 “pending”。你可以透過 /history 或 GET /post 端點來查詢 status。
  • YouTube 影片必須已成功發布,才能變更其可見性。請將 visibility 放在 youTubeOptions 內傳送,而不是放在請求主體的最上層。
  • 除了 id 之外,請求還必須包含下列至少一個參數。只包含 id 的請求會傳回 code: 101。
  • 審核流程要求貼文目前的狀態為 “awaiting approval”。
其他參數無法更新。如需修改,必須先刪除該貼文再重新發布。

Header 參數

Body 參數

string
必填
要更新的貼文的 Ayrshare Post ID。此 ID 為 /post 所回傳。
boolean
預設值:false
若原始貼文需要審核,且狀態為 “awaiting approval”,將此參數設為 true 即可核准並發布該貼文。
boolean
預設值:false
啟用或停用貼文的留言功能。設為 true 會停用留言;設為 false 則會啟用留言。支援的平台:Instagram 與 LinkedIn。
  • 不論是排程貼文或已發布的貼文,都可以啟用或停用留言。
  • 對已發布的貼文停用留言,不會刪除既有的留言。
  • 停用 LinkedIn 留言會刪除該討論串上的所有既有留言。
  • Instagram 的留言不會被刪除。
  • TikTok 的留言在發布後就無法變更。
string
設定貼文的備註,可透過 /history 端點取得。備註僅供參考, 不會影響貼文本身。
string
排程未來貼文的 datetime。接受 UTC 日期時間。例如使用 YYYY-MM-DDThh:mm:ssZ 格式,並以 2026-07-08T12:30:00Z 的形式傳送。 更多範例請參閱 utctime。
如果 datetime 為過去時間,該貼文會立即發送。
boolean
預設值:false
暫停或取消暫停一則排程貼文。若貼文被取消暫停時,scheduleDate 已是過去時間, 該貼文會立即發布。建議在取消暫停前先更新 scheduleDate。
object
透過 visibility 欄位更新 YouTube 影片的可見性,可用的值有 unlisted、private 或 public。也可以更新 description、title 或 categoryId。若原本未設定 description 或 categoryId,預設值分別為 "" 與 24(Entertainment)。