Comments: insert

Erstellt eine Antwort auf einen vorhandenen Kommentar. Hinweis:Wenn Sie einen Kommentar auf oberster Ebene erstellen möchten, verwenden Sie die Methode commentThreads.insert.

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

Gängige Anwendungsfälle

Anfragen

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
Der Parameter part gibt die Attribute an, die die API-Antwort enthalten soll. Legen Sie den Parameterwert auf snippet fest. Für den snippet-Teil fallen Kontingentkosten von 2 Einheiten an.

Die folgende Liste enthält die part-Namen, die Sie in den Parameterwert aufnehmen können:
  • id
  • snippet

Anfragetext

Geben Sie im Anfragetext eine Kommentarressource an. Für diese Ressource:

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

    • snippet.textOriginal
    • snippet.parentId

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

    • snippet.textOriginal

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Kommentarressource im Antworttext zurückgegeben.

Fehler

In der folgenden Tabelle finden Sie Fehlermeldungen, die die API als Antwort auf einen Aufruf dieser Methode zurückgeben könnte. Weitere Informationen finden Sie in der Dokumentation zu Fehlermeldungen.

Fehlertyp Fehlerdetails Beschreibung
badRequest (400) commentTextRequired Die eingefügte Ressource comment muss einen Wert für das Attribut snippet.textOriginal angeben. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die eingefügte Ressource comment enthält zu viele Zeichen im Attribut snippet.textOriginal.
badRequest (400) invalidCustomEmoji Die eingefügte Ressource comment 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 der obersten Ebene einfügen, der durch das Attribut snippet.parentId angegeben wird. In einer commentThread-Ressource gibt das Attribut snippet.canReply an, ob der aktuelle Betrachter auf den Thread antworten kann.
badRequest (400) parentCommentIsPrivate Der angegebene übergeordnete Kommentar ist privat. Antworten auf private Kommentare werden von der API nicht unterstützt.
badRequest (400) parentIdMissing Der eingefügte Kommentar muss mit einem übergeordneten Kommentar verknüpft sein. Die Ressource comment im Text der API-Anfrage enthielt jedoch keinen Wert für das Attribut snippet.parentId.
badRequest (400) processingFailure Die Anfrage konnte vom API-Server nicht verarbeitet werden. Dies kann zwar ein vorübergehender Fehler sein, weist aber in der Regel darauf hin, dass die Eingabe der Anfrage ungültig ist. Prüfen Sie 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 zum Autorisieren der API-Anfrage verwendete YouTube-Konto muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentarthread einfügen zu können.
notFound (404) parentCommentNotFound Der angegebene übergeordnete Kommentar wurde nicht gefunden. Prüfen Sie, ob der Wert des Attributs snippet.parentId im Anfragetext korrekt ist.

Jetzt testen

Verwenden Sie APIs Explorer, um diese API aufzurufen und die API-Anfrage und -Antwort anzusehen.