Method: files.generateIds
Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Generiert eine Reihe von Datei-IDs, die in Erstellungs- oder Kopieranfragen angegeben werden können. Weitere Informationen finden Sie unter Dateien erstellen und verwalten.
HTTP-Anfrage
GET https://www.googleapis.com/drive/v3/files/generateIds
Die URL verwendet die Syntax der gRPC-Transcodierung.
Abfrageparameter
Parameter |
count |
integer
Die Anzahl der zurückzugebenden IDs.
|
space |
string
Der Speicherplatz, in dem die IDs zum Erstellen von Dateien verwendet werden können. Unterstützte Werte sind drive und appDataFolder . Standard: drive . Weitere Informationen finden Sie unter Dateiorganisation.
|
type |
string
Der Typ der Elemente, für die die IDs verwendet werden können. Unterstützte Werte sind files und shortcuts . shortcuts werden nur im drive space unterstützt. Standard: files . Weitere Informationen finden Sie unter Dateiorganisation.
|
Anfragetext
Der Anfragetext muss leer sein.
Antworttext
Eine Liste der generierten Datei-IDs, die in Erstellungsanfragen angegeben werden können.
Wenn der Vorgang erfolgreich abgeschlossen wurde, enthält der Antworttext Daten mit der folgenden Struktur:
JSON-Darstellung |
{
"ids": [
string
],
"space": string,
"kind": string
} |
Felder |
ids[] |
string
Die IDs, die für den anfragenden Nutzer im angegebenen Bereich generiert wurden.
|
space |
string
Der Dateityp, der mit diesen IDs erstellt werden kann.
|
kind |
string
Kennzeichnet, welche Art von Ressource dies ist. Wert: der feste String "drive#generatedIds" .
|
Autorisierungsbereiche
Erfordert einen der folgenden OAuth-Bereiche:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
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.generateIds\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.GeneratedIds.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nGenerates a set of file IDs which can be provided in create or copy requests.\n\n### HTTP request\n\n`GET https://www.googleapis.com/drive/v3/files/generateIds`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Query parameters\n\n| Parameters ||\n|---------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `count` | `integer` The number of IDs to return. |\n| `space` | `string` The space in which the IDs can be used to create new files. Supported values are 'drive' and 'appDataFolder'. (Default: 'drive') |\n| `type` | `string` The type of items which the IDs can be used for. Supported values are 'files' and 'shortcuts'. Note that 'shortcuts' are only supported in the `drive` 'space'. (Default: 'files') |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nA list of generated file IDs which can be provided in create requests.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------|\n| ``` { \"ids\": [ string ], \"space\": string, \"kind\": string } ``` |\n\n| Fields ||\n|---------|----------------------------------------------------------------------------------------------------|\n| `ids[]` | `string` The IDs generated for the requesting user in the specified space. |\n| `space` | `string` The type of file that can be created with these IDs. |\n| `kind` | `string` Identifies what kind of resource this is. Value: the fixed string `\"drive#generatedIds\"`. |\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.appdata`\n- `\n https://www.googleapis.com/auth/drive.file`\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)."]]