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