GroupItems: list

Wichtig:API-Anfragen an diese Methode erfordern Zugriff auf Folgendes:
  • den https://www.googleapis.com/auth/youtube-Umfang
    oder
  • den https://www.googleapis.com/auth/youtube.readonly-Umfang
    und
    den https://www.googleapis.com/auth/yt-analytics.readonly-Umfang

Bei der ersten Option wird ein Bereich mit Schreib-/Lesezugriff verwendet, bei der zweiten Option zwei Bereiche mit Lesezugriff.

Gibt eine Sammlung von Gruppenelementen zurück, die mit den Parametern der API-Anfrage übereinstimmen.

Anfrage

HTTP-Anfrage

GET https://youtubeanalytics.googleapis.com/v2/groupItems

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Ebenen
https://www.googleapis.com/auth/yt-analytics.readonly YouTube Analytics-Berichte für deine YouTube-Inhalte abrufen Dieser Bereich bietet Zugriff auf Messwerte zur Nutzeraktivität, z. B. die Anzahl der Aufrufe und Bewertungen.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly YouTube Analytics-Finanzberichte für deine YouTube-Inhalte abrufen Diese Zugriffsebene bietet Zugriff auf Messwerte zu Nutzeraktivitäten sowie auf geschätzte Umsatz- und Anzeigenleistungsmesswerte.
https://www.googleapis.com/auth/youtube YouTube-Konto verwalten In der YouTube Analytics API verwenden Kanalinhaber diesen Bereich zum Verwalten von YouTube Analytics-Gruppen und -Gruppenelementen.
https://www.googleapis.com/auth/youtubepartner YouTube-Assets und zugehörige Inhalte auf YouTube abrufen und verwalten In der YouTube Analytics API verwenden Rechteinhaber diesen Umfang, um YouTube Analytics-Gruppen und -Gruppenelemente zu verwalten.

Parameter

In der folgenden Tabelle sind die Parameter aufgeführt, die von dieser Abfrage unterstützt werden. Alle aufgeführten Parameter sind Abfrageparameter.

Parameter
Erforderliche Parameter
groupId string
Der Parameter id gibt die eindeutige ID der Gruppe an, für die Sie Gruppenelemente abrufen möchten.
Optionale Parameter
onBehalfOfContentOwner string
Dieser Parameter kann nur in einer ordnungsgemäß autorisierten Anfrage verwendet werden. Hinweis:Dieser Parameter ist ausschließlich für YouTube-Inhaltspartner gedacht, die Inhaber und Administrator vieler verschiedener YouTube-Kanäle sind.

Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsdaten der Anfrage einen YouTube-Nutzer identifizieren, der im Namen des im Parameterwert angegebenen Rechteinhabers handelt. So können Rechteinhaber sich einmal authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten angeben zu müssen. Das Konto, mit dem sich der Nutzer authentifiziert, muss mit dem angegebenen YouTube-Rechteinhaber verknüpft sein.

Anfragetext

Geben Sie beim Aufruf dieser Methode keinen Anfragetext an.

Antwort

Bei Erfolg gibt diese Methode einen Antworttext mit der folgenden Struktur zurück:

{
  "kind": "youtube#groupItemListResponse",
  "etag": etag,
  "items": [
    groupItem Resource
  ]
}

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#groupItemListResponse.
etag etag
Das Etag dieser Ressource.
items[] list
Eine Liste der Elemente, die die Gruppe enthält. Jedes Element in der Liste stellt eine groupItem-Ressource dar.

Fehler

Die API definiert keine Fehlermeldungen, die einzigartig für diese API-Methode sind. Mit dieser Methode können jedoch weiterhin allgemeine API-Fehler zurückgegeben werden, die in der Dokumentation der Fehlermeldung aufgeführt sind.

Testen!

Verwenden Sie die APIs Explorer, um diese API aufzurufen und die API-Anfrage und ‑Antwort zu sehen.