跳转到主要内容
PATCH
更新貼文的 scheduleDateapproval 審核狀態、notes,或已發布 YouTube 影片的 visibility
  • 貼文原本必須有 scheduleDatestatus 為 “pending”。你可以透過 /history 或 GET /post 端點來查詢 status
  • YouTube 影片必須已成功發布,才能變更其可見性。
  • 審核流程要求貼文目前的狀態為 “awaiting approval”。
其他參數無法更新。如需修改,必須先刪除該貼文再重新發布。

Header 參數

Body 參數

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