Weitere Informationen findest du in der YouTube-Hilfe.
Ein Bulletin für einen bestimmten Kanal wird gepostet. Der Nutzer, der die Anfrage sendet, muss dazu berechtigt sein, im Namen des Kanals zu handeln.
Hinweis:Auch wenn eine Ressource vom Typ activity
Informationen zu Aktionen wie z. B. die Bewertung eines Videos oder die Kennzeichnung eines Videos als Favorit enthält, musst du zum Erstellen dieser activity
-Ressourcen andere API-Methoden verwenden. Sie können beispielsweise die Methode videos.rate()
der API verwenden, um ein Video zu bewerten, und die Methode playlistItems.insert()
, um ein Video als Favorit zu markieren.
Auswirkungen auf Kontingente: Bei einem Aufruf dieser Methode fallen Kontingentkosten von 50 Einheiten an.
Anfragen
HTTP-Anfrage
POST https://www.googleapis.com/youtube/v3/activities
Autorisierung
Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).
Umfang |
---|
https://www.googleapis.com/auth/youtube |
https://www.googleapis.com/auth/youtube.force-ssl |
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 | ||
part |
string Der Parameter part dient in diesem Vorgang zwei Zwecken. Damit werden die Attribute festgelegt, die der Schreibvorgang festlegt, sowie die Attribute, die in der API-Antwort enthalten sind.Die folgende Liste enthält die part -Namen, die Sie in den Parameterwert aufnehmen können:
|
Anfragetext
Geben Sie im Anfragetext eine Aktivitätsressource an. Für diese Ressource:
-
Für diese Eigenschaften müssen Sie einen Wert angeben:
snippet.description
-
Sie können Werte für diese Attribute festlegen:
snippet.description
contentDetails.bulletin.resourceId
Antwort
Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Aktivitätsressource im Antworttext zurückgegeben.
Fehler
In der folgenden Tabelle sind Fehlermeldungen aufgeführt, 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 |
---|---|---|
badRequest (400) |
bulletinTextRequired |
In der Anfrage muss die Eigenschaft description des snippet -Objekts verwendet werden, um den Text des Bulletins anzugeben. |
badRequest (400) |
invalidMetadata |
Die Property kind entspricht nicht dem angegebenen ID-Typ. |
forbidden (403) |
forbidden |
Die Anfrage ist nicht ordnungsgemäß autorisiert. |
notFound (404) |
playlistNotFound |
YouTube kann das Video, das du mit dem Bulletin-Post verknüpfen möchtest, nicht finden. Prüfen Sie den Wert der contentDetails.bulletinPosted.playlistId -Property. |
notFound (404) |
videoNotFound |
YouTube kann das Video, das du mit dem Bulletin-Post verknüpfen möchtest, nicht finden. Prüfen Sie den Wert der contentDetails.bulletinPosted.videoId -Property. |
userRateLimitExceeded (403) |
rateLimitExceeded |
Die Anfrage kann nicht abgeschlossen werden, weil Ihr Kontingent überschritten wurde. |