Comments: insert

Erstellt eine Antwort auf einen vorhandenen Kommentar. Hinweis: Verwenden Sie zum Erstellen eines Kommentars der obersten Ebene die Methode commentThreads.insert.

Auswirkungen auf Kontingente: Bei einem Aufruf dieser Methode fallen Kontingentkosten von 50 Einheiten an.

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).

Umfang
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. Der Teil „snippet“ hat ein Kontingent von 2 Einheiten.

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:

  • Für diese Eigenschaften müssen Sie einen Wert angeben:

    • snippet.textOriginal
    • snippet.parentId

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

    • snippet.textOriginal

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine Kommentarressource 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) commentTextRequired Die Ressource comment, die eingefügt wird, muss einen Wert für das Attribut snippet.textOriginal angeben. Kommentare dürfen nicht leer sein.
badRequest (400) commentTextTooLong Die eingefügte comment-Ressource enthält zu viele Zeichen für das Attribut snippet.textOriginal.
badRequest (400) invalidCustomEmoji Die eingefügte 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 keine Kommentare als Antwort auf den Kommentar der obersten Ebene einfügen, der von der Property 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 eingefügte Kommentar muss mit einem übergeordneten Kommentar verknüpft sein. Die Ressource comment im Text der API-Anfrage hat jedoch keinen Wert für die Property snippet.parentId angegeben.
badRequest (400) processingFailure Der API-Server konnte die Anfrage nicht verarbeiten. Dies kann zwar ein vorübergehender Fehler sein, weist jedoch normalerweise 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 YouTube-Konto, mit dem die API-Anfrage autorisiert wird, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentarthread einzufügen.
notFound (404) parentCommentNotFound Der angegebene übergeordnete Kommentar wurde nicht gefunden. Prüfen Sie, ob der Wert der Eigenschaft snippet.parentId im Anfragetext korrekt ist.

Testen!

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