Method: files.listLabels
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Listet die Labels einer Datei auf.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v2/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 von Labels, die pro Seite zurückgegeben werden sollen. Wird kein Wert festgelegt, beträgt die Standardeinstellung 100.
|
pageToken |
string
Das Token, mit dem eine vorherige Listenanfrage auf der nächsten Seite fortgesetzt wird. Dieser sollte auf den Wert von nextPageToken aus der vorherigen Antwort festgelegt sein.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der Labels, die auf eine Datei angewendet wurden.
Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:
| JSON-Darstellung |
{
"items": [
{
object (Label)
}
],
"nextPageToken": string,
"kind": string
} |
| Felder |
items[] |
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 von der ersten Ergebnisseite aus neu gestartet werden.
|
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, damit Ihre App sie verwenden kann. Weitere Informationen finden Sie im Leitfaden zur Autorisierung.
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-07-25 (UTC).
[null,null,["Zuletzt aktualisiert: 2025-07-25 (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/v2/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| ``` { \"items\": [ { object (/workspace/drive/api/reference/rest/v2/Label) } ], \"nextPageToken\": string, \"kind\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `items[]` | `object (`[Label](/workspace/drive/api/reference/rest/v2/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. |\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)."]]
