Groups

group 資源代表 YouTube 數據分析群組，自訂群組包含最多 500 個頻道、影片、播放清單或資產。

群組中的所有項目都必須代表相同類型的資源。舉例來說，您所建立的群組不能包含 100 部影片和 100 個播放清單。

Analytics (分析) 群組只能包含您上傳或聲明的資源，或是已連結至您所管理頻道的資源。因此頻道擁有者可以建立一組影片和播放清單。內容擁有者可以建立影片、播放清單、頻道或資產群組。

方法

這個 API 支援下列 groups 資源的方法：

list

傳回符合 API 要求參數的群組清單。舉例來說，您可以擷取已驗證使用者擁有的所有群組，也可以使用專屬 ID 擷取一或多個群組。 立即試用。

插入

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

更新

修改群組的中繼資料。目前只能更新群組標題。(使用 groupItems.insert 和 groupItems.delete 新增及移除群組項目)。 立即試用。

刪除

刪除群組。 立即試用。

資源表示法

以下 JSON 結構顯示 groups 資源的格式：

{
  "kind": "youtube#group",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "title": string
  },
  "contentDetails": {
    "itemCount": unsigned long,
    "itemType": string
  }
}

屬性

下表定義此資源中顯示的屬性：

屬性
kind	string 識別 API 資源類型。這個值會是 youtube#group。
etag	etag 這項資源的 Etag。
id	string YouTube 在識別群組時使用的 ID。
snippet	object snippet 物件包含群組的基本資訊，包括建立日期和名稱。
snippet.publishedAt	datetime 建立群組的日期和時間。這個值以 ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) 格式指定。
snippet.title	string 群組名稱。此值必須是非空白字串。
contentDetails	object contentDetails 物件包含群組的其他相關資訊，例如群組包含的項目數量和類型。
contentDetails.itemCount	unsigned long 群組中的項目數量。
contentDetails.itemType	string 這個群組包含的資源類型。 這項屬性的有效值如下： youtube#channel youtube#playlist youtube#video youtubePartner#asset