Method: files.generateIds
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Génère un ensemble d'ID de fichiers qui peuvent être fournis dans les requêtes de création ou de copie. Pour en savoir plus, consultez Créer et gérer des fichiers.
Requête HTTP
GET https://www.googleapis.com/drive/v3/files/generateIds
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de requête
| Paramètres |
count |
integer
Nombre d'ID à renvoyer.
|
space |
string
Espace dans lequel les ID peuvent être utilisés pour créer des fichiers. Les valeurs acceptées sont drive et appDataFolder. (Par défaut : drive.) Pour en savoir plus, consultez Organisation des fichiers.
|
type |
string
Type d'éléments pour lesquels les ID peuvent être utilisés. Les valeurs acceptées sont files et shortcuts. Notez que les shortcuts ne sont compatibles qu'avec le space drive. (Par défaut : files.) Pour en savoir plus, consultez Organisation des fichiers.
|
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Liste des ID de fichiers générés pouvant être fournis dans les requêtes de création.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"ids": [
string
],
"space": string,
"kind": string
} |
| Champs |
ids[] |
string
ID générés pour l'utilisateur demandeur dans l'espace spécifié.
|
space |
string
Type de fichier pouvant être créé avec ces ID.
|
kind |
string
Identifie le type de ressource. Valeur : chaîne fixe "drive#generatedIds".
|
Niveaux d'accès des autorisations
Nécessite l'un des champs d'application OAuth suivants :
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.appdata
https://www.googleapis.com/auth/drive.file
Certains sont soumis à des restrictions et nécessitent une évaluation de sécurité pour que votre application puisse les utiliser. Pour en savoir plus, consultez le guide d'autorisation.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/27 (UTC).
[null,null,["Dernière mise à jour le 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)."]]
