CommentThreads: insert

Erstellt einen neuen Kommentar auf oberster Ebene. Wenn Sie eine Antwort zu einem vorhandenen Kommentar hinzufügen möchten, verwenden Sie stattdessen die Methode comments.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/commentThreads

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
  • replies
  • snippet

Anfragetext

Geben Sie im Anfragetext eine commentThread-Ressource an.

Für diese Ressource müssen Sie einen Wert für die folgenden Attribute angeben:

  • snippet.channelId
  • snippet.videoId
  • snippet.topLevelComment.snippet.textOriginal

Antwort

Bei Erfolg gibt diese Methode eine commentThread-Ressource im Antworttext zurück.

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) channelOrVideoIdMissing Jeder Kommentarthread muss mit einem Video verknüpft sein. Die Ressource muss Werte für die Attribute snippet.channelId und snippet.videoId angeben. Ein Kommentar zu einem Video wird auf der Wiedergabeseite des Videos angezeigt.
badRequest (400) commentTextRequired Die eingefügte Ressource comment muss einen Wert für das Attribut snippet.topLevelComment.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.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Die Metadaten der Anfrage sind ungültig.
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 commentThread-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.
forbidden (403) forbidden Der Kommentarthread konnte 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) channelNotFound Der angegebene Kanal wurde nicht gefunden. Prüfen Sie, ob der Wert des Attributs snippet.channelId korrekt ist.
notFound (404) videoNotFound Das angegebene Video wurde nicht gefunden. Prüfen Sie, ob der Wert des Attributs snippet.videoId korrekt ist.

Jetzt testen

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