GroupItems: list

Wichtig:API-Anfragen an diese Methode benötigen Zugriff auf Folgendes:

• für den https://www.googleapis.com/auth/youtube-Bereich
  oder
• https://www.googleapis.com/auth/youtube.readonlyUmfang
  und
  https://www.googleapis.com/auth/yt-analytics.readonly Bereich

Die erste Option verwendet einen Bereich, bei dem es sich um einen Lese-/Schreibbereich handelt, während die zweite Option zwei schreibgeschützte Bereiche umfasst.

Gibt eine Sammlung von Gruppenelementen zurück, die den API-Anfrageparametern entsprechen.

Anfragen

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).

Sucher
https://www.googleapis.com/auth/yt-analytics.readonly	Sieh dir YouTube Analytics-Berichte für deine YouTube-Inhalte an. Dieser Bereich bietet Zugriff auf Messwerte zur Nutzeraktivität, wie Anzahl der Aufrufe und Anzahl der Bewertungen.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly	Sieh dir die YouTube Analytics-Finanzberichte für deine YouTube-Inhalte an. Dieser Bereich bietet Zugriff auf Messwerte zur Nutzeraktivität sowie auf geschätzte Umsatz- und Anzeigenleistungsmesswerte.
https://www.googleapis.com/auth/youtube	YouTube-Konto verwalten In der YouTube Analytics API können Kanalinhaber mit diesem Bereich YouTube-Gruppen und ‐Gruppen verwalten.
https://www.googleapis.com/auth/youtubepartner	YouTube-Assets und zugehörige Inhalte auf YouTube ansehen und verwalten In der YouTube Analytics API können Rechteinhaber diesen Bereich verwenden, 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 Content-Partner von YouTube bestimmt, die viele verschiedene YouTube-Kanäle besitzen und verwalten. Der Parameter onBehalfOfContentOwner gibt an, dass die Autorisierungsanmeldedaten einer Anfrage einen YouTube-Nutzer identifizieren, der im Namen des in dem Parameterwert angegebenen Rechteinhabers handelt. Rechteinhaber können sich einmalig authentifizieren und auf alle ihre Video- und Kanaldaten zugreifen, ohne für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung 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 Aufrufen 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 in der Gruppe. Jedes Element in der Liste stellt eine groupItem-Ressource dar.

Fehler

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

Testen!

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.