Groups

Eine group-Ressource repräsentiert eine YouTube Analytics-Gruppe. Das ist eine benutzerdefinierte Sammlung von bis zu 500 Kanälen, Videos, Playlists oder Assets.

Alle Elemente in einer Gruppe müssen denselben Ressourcentyp repräsentieren. Du kannst beispielsweise keine Gruppe erstellen, die 100 Videos und 100 Playlists enthält.

Eine Analytics-Gruppe kann nur Ressourcen enthalten, die Sie hochgeladen oder beansprucht haben oder die mit einem von Ihnen verwalteten Kanal verknüpft sind. Dadurch können Kanalinhaber Gruppen von Videos und Playlists erstellen. 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, deren Inhaber der authentifizierte Nutzer ist, oder eine oder mehrere Gruppen anhand ihrer eindeutigen IDs abrufen. Hier kannst du die Funktion ausprobieren.
Einfügen
Eine YouTube Analytics-Gruppe wird erstellt. Verwenden Sie die Methode groupItems.insert, um der Gruppe Elemente hinzuzufügen. Jetzt ausprobieren.
Aktualisieren
Die Metadaten einer Gruppe ändern. Derzeit ist die einzige Eigenschaft, die aktualisiert werden kann, der Titel der Gruppe. Verwenden Sie groupItems.insert und groupItems.delete, um Gruppenelemente hinzuzufügen oder zu entfernen. Jetzt ausprobieren.
Delete
Löscht 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 Objekt snippet enthält grundlegende Informationen zur Gruppe, einschließlich Erstellungsdatum und -namen.
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 String sein, der nicht leer ist.
contentDetails object
Das Objekt contentDetails enthält zusätzliche Informationen zur Gruppe, z. B. die Anzahl und den Typ der darin enthaltenen Elemente.
contentDetails.itemCount unsigned long
Die Anzahl der Elemente in der Gruppe.
contentDetails.itemType string
Der Ressourcentyp der Gruppe.

Gültige Werte für dieses Attribut sind:
  • youtube#channel
  • youtube#playlist
  • youtube#video
  • youtubePartner#asset