GroupItems: insert

建立群組項目。

要求

HTTP 要求

POST https://youtubeanalytics.googleapis.com/v2/groupItems

授權

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

範圍
https://www.googleapis.com/auth/yt-analytics.readonly 查看您 YouTube 內容的 YouTube 數據分析報表。這個範圍可讓您存取使用者活動指標,例如觀看次數和評分次數。
https://www.googleapis.com/auth/yt-analytics-monetary.readonly 查看您 YouTube 內容的 YouTube 數據分析金額報表。這個範圍可讓您存取使用者活動指標,以及預估收益和廣告成效指標。
https://www.googleapis.com/auth/youtube 管理您的 YouTube 帳戶。在 YouTube Analytics API 中,頻道擁有者可使用這個範圍來管理 YouTube 數據分析的群組和群組項目。
https://www.googleapis.com/auth/youtubepartner 查看及管理 YouTube 資產和 YouTube 上的相關內容。內容擁有者可以在 YouTube Analytics API 中使用這個範圍來管理 YouTube 數據分析的群組和群組項目。

參數

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

參數
選用參數
onBehalfOfContentOwner string
這個參數只能在妥善的授權要求中使用。注意:這個參數僅適用於擁有和管理多個不同 YouTube 頻道的 YouTube 內容合作夥伴。

onBehalfOfContentOwner 參數表示請求的授權憑證能代表代表參數值中所指定的內容擁有者的 YouTube 使用者。內容擁有者只要驗證一次即可,就能存取所有影片和頻道資料,而不需要為每個頻道分別提供驗證憑證。使用者驗證的帳戶必須連結至指定的 YouTube 內容擁有者。

要求主體

在要求主體中提供 groupItem 資源。 您必須指定該資源的值。

  • groupId
  • resource.id

回應

如果該項目已成功插入,這個方法會傳回回應主體中的 groupItem 資源

如果要求中指定的項目已在提出要求之前已納入群組中,這個方法會傳回 HTTP 204 回應代碼 (No Content)。

錯誤

下表列出 API 針對呼叫方法所傳回的錯誤訊息。詳情請參閱錯誤訊息說明文件。

錯誤類型 錯誤詳細資料 說明
forbidden (403) groupContainsMaximumNumberOfItems 這個群組包含的項目數量已達上限。

試試看!

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