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