PlaylistImages: insert

在播放清單中新增圖片。

這個方法支援媒體上傳。上傳的檔案必須符合下列限制：

  • 檔案大小上限：50 MB
  • 可接受的顯示比例：1:1 (正方形)
  • 接受的媒體 MIME 類型： image/jpeg、image/png

配額影響：呼叫這個方法會產生 50 個單位的配額費用。

要求

HTTP 要求

POST https://www.googleapis.com/youtube/v3/playlistImages

授權

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

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

參數

下表列出這項查詢支援的參數。列出的所有參數都是查詢參數。

參數
必要參數
part string

part 參數會指定一或多個 playlistImage 資源屬性，並以逗號分隔的清單呈現，API 回應會包含這些屬性。

如果參數識別的屬性包含子屬性，則子屬性會包含在回應中。
選用參數
onBehalfOfContentOwner string
這個參數只能用於授權要求。注意：這個參數僅供 YouTube 內容合作夥伴使用。

onBehalfOfContentOwner 參數表示要求授權憑證識別的 YouTube CMS 使用者，是代表參數值中指定的內容擁有者行事。這項參數適用於擁有及管理多個不同 YouTube 頻道的 YouTube 內容合作夥伴。內容擁有者只需驗證一次，即可存取所有影片和頻道資料，不必為每個頻道提供驗證憑證。使用者用來驗證的 CMS 帳戶必須連結至指定的 YouTube 內容擁有者。
onBehalfOfContentOwnerChannel string
這個參數只能用於授權要求。注意：這個參數僅供 YouTube 內容合作夥伴使用。

onBehalfOfContentOwnerChannel 參數會指定要新增影片的 YouTube 頻道 ID。如果要求指定 onBehalfOfContentOwner 參數的值，就必須提供這項參數，且只能與該參數搭配使用。此外，必須使用連結至內容擁有者的 CMS 帳戶授權要求，該內容擁有者由 onBehalfOfContentOwner 參數指定。最後，onBehalfOfContentOwnerChannel 參數值指定的頻道必須連結至 onBehalfOfContentOwner 參數指定的內容擁有者。

這個參數適用於擁有及管理多個不同 YouTube 頻道的 YouTube 內容合作夥伴。內容擁有者只要驗證一次，即可代表參數值中指定的頻道執行動作，不必為每個頻道提供驗證憑證。

要求主體

在要求主體中提供 playlistImages 資源。

該資源的相關資訊：

  • 你必須為下列屬性指定值：

    • snippet.playlistId
    • snippet.type

  • 您可以為下列屬性設定值：

    • snippet.width
    • snippet.height

回應

如果成功，這個方法會在回應主體中傳回 playlistImages 資源。