CommentThreads: insert

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

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

Anfragetext

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

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

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

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

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

Antwort

Wenn der Vorgang erfolgreich ist, wird mit dieser Methode eine commentThread-Ressource 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) channelOrVideoIdMissing Jeder Kommentarthread muss mit einem Kanal oder Video verknüpft sein.
  • Wenn der Kommentar für einen Kanal gilt, muss die im Anfragetext angegebene Ressource einen Wert für das Attribut snippet.channelId enthalten. Kommentare zu einem Kanal werden auf dem Tab Diskussion angezeigt.
  • Wenn der Kommentar auf ein Video zutrifft, achte darauf, dass die Ressource sowohl für die snippet.channelId- als auch für die snippet.videoId-Property Werte enthält. Ein Kommentar, der für ein Video gilt, wird auf der Wiedergabeseite des Videos angezeigt.
badRequest (400) commentTextRequired Die Ressource comment, die eingefügt wird, muss einen Wert für das Attribut snippet.topLevelComment.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.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 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 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, 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) channelNotFound Der angegebene Kanal wurde nicht gefunden. Prüfe, ob der Wert der Property snippet.channelId korrekt ist.
notFound (404) videoNotFound Das angegebene Video wurde nicht gefunden. Prüfe, ob der Wert der Property snippet.videoId korrekt ist.

Testen!

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