Groups

Eine group-Ressource steht für eine YouTube Analytics-Gruppe, eine benutzerdefinierte Sammlung von bis zu 500 Kanälen, Videos, Playlists oder Assets.

Alle Elemente in einer Gruppe müssen denselben Ressourcentyp haben. Sie können beispielsweise keine Gruppe mit 100 Videos und 100 Playlists erstellen.

Eine Analytics-Gruppe kann nur Ressourcen enthalten, die du hochgeladen oder auf die du Anspruch erhoben hast oder die mit einem Kanal verknüpft sind, den du administrierst. Kanalinhaber können also Videos und Playlists in Gruppen zusammenfassen. Rechteinhaber können Gruppen von Videos, Playlists, Kanälen oder Assets erstellen.

Methoden

Die API unterstützt die folgenden Methoden für groups-Ressourcen:

list

Gibt eine Liste von Gruppen zurück, die den API-Anfrageparametern entsprechen. Sie können beispielsweise alle Gruppen abrufen, die dem authentifizierten Nutzer gehören, oder Sie können eine oder mehrere Gruppen anhand ihrer eindeutigen ID abrufen. Hier kannst du die Funktion ausprobieren.

insert

Erstellt eine YouTube Analytics-Gruppe. Verwenden Sie nach dem Erstellen einer Gruppe die Methode groupItems.insert, um der Gruppe Elemente hinzuzufügen. Jetzt testen

aktualisieren

Ändert die Metadaten für eine Gruppe. Derzeit kann nur der Titel der Gruppe aktualisiert werden. Verwenden Sie die groupItems.insert und groupItems.delete, um Gruppenelemente hinzuzufügen oder zu entfernen. Jetzt testen

Delete

Löst eine Gruppe. Hier kannst du die Funktion ausprobieren.

Ressourcendarstellung

Die folgende JSON-Struktur zeigt das Format einer groups-Ressource:

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

Attribute

In der folgenden Tabelle werden die Attribute definiert, die in dieser Ressource angezeigt werden:

Attribute
kind	string Identifiziert den Typ der API-Ressource. Der Wert ist youtube#group.
etag	etag Das ETag dieser Ressource.
id	string Die ID, mit der YouTube die Gruppe eindeutig identifiziert.
snippet	object Das snippet-Objekt enthält grundlegende Informationen zur Gruppe, einschließlich Erstellungsdatum und Name.
snippet.publishedAt	datetime Datum und Uhrzeit der Erstellung der Gruppe. Der Wert wird im ISO 8601-Format (YYYY-MM-DDThh:mm:ss.sZ) angegeben.
snippet.title	string Der Gruppenname. Der Wert muss ein nicht leerer String sein.
contentDetails	object Das contentDetails-Objekt enthält zusätzliche Informationen zur Gruppe, z. B. die Anzahl und den Typ der enthaltenen Elemente.
contentDetails.itemCount	unsigned long Die Anzahl der Elemente in der Gruppe.
contentDetails.itemType	string Der Typ der Ressourcen, die die Gruppe enthält. Gültige Werte für diese Property sind: youtube#channel youtube#playlist youtube#video youtubePartner#asset