Activities: insert

YouTube hat die Funktion „Kanalmitteilungen“ eingestellt. Diese Methode wird nicht mehr unterstützt.

Weitere Informationen findest du in der YouTube-Hilfe.

Postet eine Mitteilung für einen bestimmten Kanal. Der Nutzer, der den Antrag stellt, muss berechtigt sein, im Namen des Kanals zu handeln.

Hinweis:Eine activity-Ressource kann zwar Informationen zu Aktionen wie der Bewertung eines Videos durch einen Nutzer oder der Markierung eines Videos als Favorit enthalten, Sie müssen jedoch andere API-Methoden verwenden, um diese activity-Ressourcen zu generieren. Mit der Methode videos.rate() der API können Sie beispielsweise ein Video bewerten und mit der Methode playlistItems.insert() ein Video als Favorit markieren.

Kontingentauswirkung:Ein Aufruf dieser Methode hat Kontingentkosten von 50 Einheiten.

Anfrage

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 hat bei diesem Vorgang zwei Funktionen. Sie gibt die Eigenschaften an, die durch den Schreibvorgang festgelegt werden, sowie die Eigenschaften, 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 activity-Ressource an. Für diese Ressource:

  • Sie müssen einen Wert für diese Properties angeben:

    • snippet.description

  • Sie können Werte für diese Eigenschaften festlegen:

    • snippet.description
    • contentDetails.bulletin.resourceId

Antwort

Bei Erfolg gibt diese Methode eine Aktivitätsressource im Antworttext zurück.

Fehler

In der folgenden Tabelle sind die Fehlermeldungen aufgeführt, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben kann. Weitere Informationen finden Sie in der Dokumentation zur Fehlermeldung.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) bulletinTextRequired Im Request muss die Property description des Objekts snippet verwendet werden, um den Text für den Bulletin-Beitrag anzugeben.
badRequest (400) invalidMetadata Die kind-Property stimmt nicht mit dem Typ der angegebenen ID überein.
forbidden (403) forbidden Die Anfrage ist nicht richtig autorisiert.
notFound (404) playlistNotFound YouTube kann das Video, das du mit dem Communitybeitrag verknüpfen möchtest, nicht finden. Prüfen Sie den Wert des Attributs contentDetails.bulletinPosted.playlistId.
notFound (404) videoNotFound YouTube kann das Video, das du mit dem Communitybeitrag verknüpfen möchtest, nicht finden. Prüfen Sie den Wert des Attributs contentDetails.bulletinPosted.videoId.
userRateLimitExceeded (403) rateLimitExceeded Die Anfrage kann nicht abgeschlossen werden, da Sie Ihr Kontingent überschritten haben.