Comments: update

Ändert einen Kommentar.

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

Gängige Anwendungsfälle

Anfrage

HTTP-Anfrage

PUT 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).

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. Sie müssen mindestens den Teil snippet in den Parameterwert einfügen, da dieser Teil alle Eigenschaften enthält, die von der API-Anfrage aktualisiert werden können.

Die folgende Liste enthält die part Namen, die Sie in den Parameterwert einfügen können:
  • id
  • snippet

Anfragetext

Geben Sie im Anfragetext eine Kommentarressource an. Für diese Ressource gilt:

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

    • snippet.textOriginal

Antwort

Bei Erfolg gibt diese Methode eine Kommentarressource im Antworttext 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) commentTextTooLong Die comment-Ressource, die aktualisiert wird, enthält zu viele Zeichen in der Eigenschaft snippet.textOriginal.
badRequest (400) invalidCommentMetadata Die Metadaten der Anfrage sind ungültig.
badRequest (400) operationNotSupported Nur Google+ basierte Kommentare können aktualisiert werden.
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 comment-Ressource im Anfragetext, um sicherzustellen, dass sie gültig ist.
forbidden (403) forbidden Der Kommentar konnte aufgrund unzureichender Berechtigungen nicht aktualisiert 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 verknüpft sein, um einen Kommentar oder Kommentar-Thread zu aktualisieren.
notFound (404) commentNotFound Der angegebene Kommentar konnte nicht gefunden werden. Prüfen Sie den Wert der Eigenschaft id im Anfragetext, um sicherzustellen, dass er korrekt ist.

Testen!

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