LiveChatMessages: delete

刪除即時通訊訊息。API 要求必須獲得頻道擁有者或與停權有關的聊天室管理員授權。

常見用途

要求

HTTP 要求

DELETE https://www.googleapis.com/youtube/v3/liveChat/messages

授權

這項要求需要至少下列其中一個範圍的授權 (進一步瞭解驗證和授權)。

內容範圍
https://www.googleapis.com/auth/youtube
https://www.googleapis.com/auth/youtube.force-ssl

參數

下表列出此查詢支援的參數。這裡列出的參數全都是查詢參數。

參數
必要參數
id string
id 參數會指定要刪除的資源的 YouTube 即時通訊訊息 ID。

要求主體

呼叫此方法時,不要提供要求主體。

回應

如果成功,這個方法會傳回 HTTP 204 回應代碼 (No Content)。

錯誤

下表列出 API 回應此方法時可能傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。

錯誤類型 錯誤詳細資料 說明
forbidden (403) forbidden 您沒有刪除指定訊息所需的權限。
forbidden (403) modificationNotAllowed 無法刪除指定的 liveChatMessage 資源。id 參數可識別由管理員或其他使用者建立的訊息,但這些訊息無法刪除。
notFound (404) liveChatMessageNotFound 找不到您嘗試刪除的訊息。檢查 id 參數的值,確認值正確無誤。

試試看!

使用 APIs Explorer 呼叫這個 API 並查看 API 要求和回應。