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