Method: files.listLabels
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v3/files/{fileId}/listLabels
Die URL verwendet die Syntax der gRPC-Transcodierung.
Pfadparameter
| Parameter |
fileId |
string
Die ID der Datei.
|
Abfrageparameter
| Parameter |
maxResults |
integer
Die maximale Anzahl der Labels, die pro Seite zurückgegeben werden sollen. Wenn nichts anderes festgelegt ist, beträgt der Standardwert 100.
|
pageToken |
string
Das Token zum Fortsetzen einer vorherigen Listenanfrage auf der nächsten Seite. Dieser Wert sollte auf den Wert von nextPageToken aus der vorherigen Antwort festgelegt werden.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der auf eine Datei angewendeten Labels.
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"labels": [
{
object (Label)
}
],
"nextPageToken": string,
"kind": string
} |
| Felder |
labels[] |
object (Label)
Die Liste der Labels.
|
nextPageToken |
string
Das Seitentoken für die nächste Seite mit Labels. Dieses Feld ist nicht vorhanden, wenn das Ende der Liste erreicht wurde. Wenn das Token aus irgendeinem Grund abgelehnt wird, sollte es verworfen und die Paginierung mit der ersten Ergebnisseite neu gestartet werden. Das Seitentoken ist in der Regel mehrere Stunden lang gültig. Wenn jedoch neue Artikel hinzugefügt oder entfernt werden, können sich die erwarteten Ergebnisse ändern.
|
kind |
string
Dies ist immer "drive#labelList".
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/drive.meet.readonly
https://www.googleapis.com/auth/drive.metadata
https://www.googleapis.com/auth/drive.metadata.readonly
https://www.googleapis.com/auth/drive.readonly
Einige Bereiche sind eingeschränkt und erfordern eine Sicherheitsprüfung für Ihre App, damit sie verwendet werden können. Weitere Informationen finden Sie im Autorisierungsleitfaden.
Sofern nicht anders angegeben, sind die Inhalte dieser Seite unter der Creative Commons Attribution 4.0 License und Codebeispiele unter der Apache 2.0 License lizenziert. Weitere Informationen finden Sie in den Websiterichtlinien von Google Developers. Java ist eine eingetragene Marke von Oracle und/oder seinen Partnern.
Zuletzt aktualisiert: 2025-08-27 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-08-27 (UTC)."],[],[],null,["# Method: files.listLabels\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.LabelList.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nLists the labels on a file.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/{fileId}/listLabels`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|-------------------------------|\n| `fileId` | `string` The ID for the file. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` The maximum number of labels to return per page. When not set, defaults to 100. |\n| `pageToken` | `string` The token for continuing a previous list request on the next page. This should be set to the value of 'nextPageToken' from the previous response. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of labels applied to a file.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"labels\": [ { object (/workspace/drive/api/reference/rest/v3/Label) } ], \"nextPageToken\": string, \"kind\": string } ``` |\n\n| Fields ||\n|-----------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `labels[]` | `object (`[Label](/workspace/drive/api/reference/rest/v3/Label)`)` The list of labels. |\n| `nextPageToken` | `string` The page token for the next page of labels. This field will be absent if the end of the list has been reached. If the token is rejected for any reason, it should be discarded, and pagination should be restarted from the first page of results. The page token is typically valid for several hours. However, if new items are added or removed, your expected results might differ. |\n| `kind` | `string` This is always drive#labelList |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/drive`\n- `\n https://www.googleapis.com/auth/drive.file`\n- `\n https://www.googleapis.com/auth/drive.meet.readonly`\n- `\n https://www.googleapis.com/auth/drive.metadata`\n- `\n https://www.googleapis.com/auth/drive.metadata.readonly`\n- `\n https://www.googleapis.com/auth/drive.readonly`\n\nSome scopes are restricted and require a security assessment for your app to use them. For more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
