Groups: update

Ändert die Metadaten für eine Gruppe. Derzeit kann nur der Titel der Gruppe aktualisiert werden. Mit groupItems.insert und groupItems.delete können Sie Gruppenelemente hinzufügen und entfernen.

Anfrage

HTTP-Anfrage

PUT 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 können Kanalinhaber mit diesem Umfang YouTube Analytics-Gruppen und -Gruppenelemente verwalten.
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. Rechteinhaber können sich nur einmal authentifizieren und erhalten Zugriff auf alle ihre Video- und Kanaldaten, ohne dass sie für jeden einzelnen Kanal Anmeldedaten zur Authentifizierung angeben 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. Durch die Anfrage wird der Wert des Felds snippet.title aktualisiert.

  • id
  • snippet.title

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Gruppenressource im Antworttext zurückgegeben.

Fehler

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

Testen!

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