Groups: insert

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

Anfrage

HTTP-Anfrage

POST https://youtubeanalytics.googleapis.com/v2/groups

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
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 im Anfragetext eine Gruppenressource an. Für diese Ressource müssen Sie einen Wert für die folgenden Eigenschaften angeben.

  • snippet.title
  • contentDetails.itemType

Antwort

Bei Erfolg gibt diese Methode eine Gruppenressource im Antworttext zurück.

Fehler

Die API definiert keine Fehlermeldungen, die nur für diese API-Methode gelten. 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.