Erstellt eine YouTube Analytics-Gruppe. Verwenden Sie die Methode groupItems.insert
, um der Gruppe Elemente hinzuzufügen.
Anfragen
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).
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 Gruppenressource an. Für diese Ressource müssen Sie einen Wert für die folgenden Attribute angeben.
snippet.title
contentDetails.itemType
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Gruppenressource im Antworttext zurückgegeben.
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.