Method: labels.delete

Permanently deletes a Label and related metadata on Drive Items.

Once deleted, the Label and related Drive item metadata will be deleted. Only draft Labels, and disabled Labels may be deleted.

HTTP request

DELETE https://drivelabels.googleapis.com/v2/{name=labels/*}

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

Required. Label resource name.

Query parameters

Parameters
useAdminAccess

boolean

Set to true in order to use the user's admin credentials. The server will verify the user is an admin for the Label before allowing access.

writeControl

object (WriteControl)

Provides control over how write requests are executed. Defaults to unset, which means last write wins.

Request body

The request body must be empty.

Response body

If successful, the response body is empty.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/drive.labels
  • https://www.googleapis.com/auth/drive.admin.labels

For more information, see the Authorization guide.