Listet die Kommentare einer Datei auf.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v2/files/{fileId}/comments
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
Parameter | |
---|---|
fileId |
Die ID der Datei. |
Abfrageparameter
Parameter | |
---|---|
includeDeleted |
Wenn festgelegt, werden alle Kommentare und Antworten zurückgegeben, einschließlich gelöschter Kommentare und Antworten (ohne Inhalte). |
maxResults |
Die maximale Anzahl von Diskussionen, die in die Antwort aufgenommen werden können; wird für die Seitenordnung verwendet. |
pageToken |
Das Fortsetzungstoken, das zum Durchsuchen großer Ergebnissätze verwendet wird. Um zur nächsten Ergebnisseite zu gelangen, legen Sie diesen Parameter auf den Wert von "nextPageToken" aus der vorherigen Antwort fest. |
updatedMin |
Es werden nur Diskussionen zurückgegeben, die nach diesem Zeitstempel aktualisiert wurden. Formatiert als RFC 3339-Zeitstempel. |
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der Kommentare zu einer Datei in Google Drive.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
---|
{
"kind": string,
"selfLink": string,
"nextLink": string,
"items": [
{
object ( |
Felder | |
---|---|
kind |
Dies ist immer |
selfLink |
Ein Link zurück zu dieser Liste. |
nextLink |
Ein Link zur nächsten Kommentarseite. |
items[] |
Die Liste der Kommentare. Wenn „nextPageToken“ ausgefüllt ist, ist diese Liste möglicherweise unvollständig und es sollte eine zusätzliche Ergebnisseite abgerufen werden. |
nextPageToken |
Das Seitentoken für die nächste Kommentarseite. Dieses Element fehlt, wenn das Ende der Kommentarliste erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung von der ersten Ergebnisseite aus neu gestartet werden. |
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/docs
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.readonly
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.