Activities: insert

YouTube hat die Funktion für Kanalbulletins eingestellt. Diese Methode wird nicht mehr unterstützt.

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:
  • contentDetails
  • id
  • snippet

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.