CommentThreads: insert

Erstellt einen neuen Kommentar der obersten Ebene. Wenn Sie auf einen vorhandenen Kommentar antworten möchten, verwenden Sie stattdessen die Methode comments.insert.

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

Gängige Anwendungsfälle

Anfrage

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 Eigenschaften an, die in der API-Antwort enthalten sein sollen. Legen Sie den Parameterwert auf snippet fest. Der snippet Teil kostet 2 Kontingenteinheiten.

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 Eigenschaften angeben:

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

Antwort

Bei Erfolg gibt diese Methode im Antworttext eine commentThread-Ressource 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 zu Fehlermeldungen.

Fehlertyp Fehlerdetail Beschreibung
badRequest (400) channelOrVideoIdMissing Jeder Kommentar-Thread muss mit einem Video verknüpft sein. Achten Sie darauf, dass in der Ressource Werte für die Eigenschaften snippet.channelId und snippet.videoId angegeben sind. Ein Kommentar zu einem Video wird auf der Wiedergabeseite des Videos angezeigt.
badRequest (400) commentTextRequired Für die einzufügende comment-Ressource muss ein Wert für die Eigenschaft snippet.topLevelComment.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.topLevelComment.snippet.textOriginal.
badRequest (400) invalidCommentThreadMetadata Die Metadaten der Anfrage sind ungültig.
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ü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 YouTube-Konto, das zur Autorisierung der API-Anfrage verwendet wird, muss mit dem Google-Konto des Nutzers zusammengeführt werden, um einen Kommentar oder Kommentar-Thread einzufügen.
notFound (404) channelNotFound Der angegebene Kanal konnte nicht gefunden werden. Prüfen Sie, ob der Wert der Eigenschaft snippet.channelId korrekt ist.
notFound (404) videoNotFound Das angegebene Video konnte nicht gefunden werden. Prüfen Sie, ob der Wert der Eigenschaft snippet.videoId korrekt ist.

Testen!

Mit dem APIs Explorer können Sie diese API aufrufen und die API-Anfrage und -Antwort ansehen.