GroupItems: insert

Erstellt ein Gruppenelement.

Anfragen

HTTP-Anfrage

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

  • groupId
  • resource.id

Antwort

Wenn das Element erfolgreich eingefügt wurde, gibt diese Methode eine groupItem-Ressource im Antworttext zurück.

Wenn das in der Anfrage angegebene Element bereits in der Gruppe enthalten war, bevor die Anfrage gestellt wurde, gibt diese Methode den HTTP-Antwortcode 204 (No Content) zurück.

Fehler

Die folgende Tabelle enthält Fehlermeldungen, die von der API möglicherweise als Antwort auf einen Aufruf dieser Methode zurückgegeben werden. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
forbidden (403) groupContainsMaximumNumberOfItems Die Gruppe enthält bereits die maximal zulässige Anzahl von Elementen.

Testen!

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