Method: files.generateIds

Generates a set of file IDs which can be provided in create or copy requests. For more information, see Create and manage files.

HTTP request

GET https://www.googleapis.com/drive/v3/files/generateIds

The URL uses gRPC Transcoding syntax.

Query parameters

Parameters
count

integer

The number of IDs to return.
space

string

The space in which the IDs can be used to create files. Supported values are drive and appDataFolder. (Default: drive.) For more information, see File organization.
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.) For more information, see File organization.

Request body

The request body must be empty.

Response body

A list of generated file IDs which can be provided in create requests.

If successful, the response body contains data with the following structure:

JSON representation 
{
 "ids": [
 string
 ],
 "space": string,
 "kind": string
}
Fields
ids[]

string

The IDs generated for the requesting user in the specified space.
space

string

The type of file that can be created with these IDs.
kind

string

Identifies what kind of resource this is. Value: the fixed string "drive#generatedIds".

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.appdata
  • https://www.googleapis.com/auth/drive.file

Some scopes are restricted and require a security assessment for your app to use them. For more information, see the Authorization guide.

Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025年08月26日 UTC.