group 資源代表 YouTube 數據分析群組,這是最多可加入 500 個頻道、影片、播放清單或資產的自訂集合。
群組中的所有項目都必須代表相同的資源類型。舉例來說,你無法建立包含 100 部影片和 100 個播放清單的群組。
數據分析群組只能包含您上傳或聲明擁有權的資源,或是已連結至您管理的頻道。因此,頻道擁有者可以建立影片和播放清單群組。內容擁有者可以建立影片、播放清單、頻道或資產群組。
方法
API 支援下列 groups 資源方法:
- list
- 傳回符合 API 要求參數的群組清單。舉例來說,您可以擷取已驗證使用者擁有的所有群組,也可以根據一或多個群組的專屬 ID 擷取這些群組。立即試用。
- 插入
- 建立 YouTube 數據分析群組。建立群組後,請使用 groupItems.insert方法將項目新增至群組。立即試用。
- update
- 修改群組的中繼資料。目前,您只能更新群組的名稱。(使用 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 | stringYouTube 用來識別群組的 ID。 | 
| snippet | objectsnippet物件包含群組的基本資訊,包括群組的建立日期和名稱。 | 
| snippet.publishedAt | datetime群組的建立日期和時間。這個值採用 ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ) 格式指定。 | 
| snippet.title | string群組名稱。這個值必須是非空白字串。 | 
| contentDetails | objectcontentDetails物件包含群組的其他相關資訊,例如群組內含項目的數量和類型。 | 
| contentDetails.itemCount | unsigned long群組中的項目數量。 | 
| contentDetails.itemType | string群組包含的資源類型。 這個屬性的有效值如下: 
 |