Groups: insert

建立 YouTube 數據分析群組。建立群組後,請使用 groupItems.insert 方法將項目新增至群組。

要求

HTTP 要求

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

授權

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

範圍
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 內容擁有者。

要求主體

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

  • snippet.title
  • contentDetails.itemType

回應

如果成功,此方法會在回應主體中傳回群組資源

錯誤

API 不會定義任何專屬於此 API 方法的錯誤訊息。但這個方法仍可能傳回錯誤訊息文件中所列的一般 API 錯誤。

試試看!

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