Comments: insert

Erstellt eine Antwort auf einen vorhandenen Kommentar. Hinweis:Wenn du einen Kommentar auf oberster Ebene erstellen möchtest, verwende die Methode commentThreads.insert.

Auswirkungen auf das Kontingent:Ein Aufruf dieser Methode kostet 50 Kontingenteinheiten.

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

POST https://www.googleapis.com/youtube/v3/comments

Autorisierung

Diese Anfrage benötigt eine Autorisierung mit mindestens einem der folgenden Bereiche (weitere Informationen zu Authentifizierung und Autorisierung).

Bereich
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
Mit dem Parameter part werden die Eigenschaften angegeben, die in der API-Antwort enthalten sein sollen. Setze den Parameterwert auf snippet. Der snippet Teil kostet 2 Kontingenteinheiten.

Die folgende Liste enthält die part Namen, die du in den Parameterwert aufnehmen kannst:
  • id
  • snippet

Anfragetext

Gib im Anfragetext eine Kommentarressource an. Für diese Ressource gilt Folgendes:

  • Du musst einen Wert für diese Eigenschaften angeben:

    • snippet.textOriginal
    • snippet.parentId

  • Du kannst Werte für diese Eigenschaften festlegen:

    • snippet.textOriginal

Antwort

Bei Erfolg gibt diese Methode eine Kommentarressource 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 findest du in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextRequired Für die einzufügende comment-Ressource muss ein Wert für die Eigenschaft snippet.textOriginal angegeben werden. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die einzufügende comment-Ressource enthält zu viele Zeichen in der Eigenschaft snippet.textOriginal.
badRequest (400) invalidCustomEmoji Die einzufügende comment-Ressource enthält ungültige benutzerdefinierte Emojis.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Der API-Nutzer kann keinen Kommentar als Antwort auf den Kommentar auf oberster Ebene einfügen, der durch die Eigenschaft snippet.parentId angegeben wird. In einer commentThread-Ressource gibt die Eigenschaft snippet.canReply an, ob der aktuelle Betrachter auf den Thread antworten kann.
badRequest (400) parentCommentIsPrivate Der angegebene übergeordnete Kommentar ist privat. Die API unterstützt keine Antworten auf private Kommentare.
badRequest (400) parentIdMissing Der einzufügende Kommentar muss mit einem übergeordneten Kommentar verknüpft sein. In der comment-Ressource im Text der API-Anfrage wurde jedoch kein Wert für die Eigenschaft snippet.parentId angegeben.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann ein vorübergehender Fehler sein, deutet aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfe die Struktur der comment-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.
forbidden (403) forbidden Der Kommentar kann aufgrund unzureichender Berechtigungen nicht erstellt werden. Die Anfrage ist möglicherweise nicht ordnungsgemäß autorisiert.
forbidden (403) ineligibleAccount Das YouTube-Konto, das zur Autorisierung der API-Anfrage verwendet wird, muss mit dem Google-Konto des Nutzers verknüpft sein, um einen Kommentar oder Kommentar-Thread einzufügen.
notFound (404) parentCommentNotFound Der angegebene übergeordnete Kommentar wurde nicht gefunden. Prüfe den Wert der Eigenschaft snippet.parentId im Anfragetext, um sicherzustellen, dass er korrekt ist.

Testen!

Mit dem APIs Explorer kannst du diese API aufrufen und die API-Anfrage und -Antwort ansehen.