Properties

Stay organized with collections Save and categorize content based on your preferences.

For a list of methods for this resource, see the end of this page.

Resource representations

A key-value pair attached to a file that is either public or private to an application.

The following limits apply to file properties:

  • Maximum of 100 properties total per file
  • Maximum of 30 private properties per app
  • Maximum of 30 public properties
  • Maximum of 124 bytes size limit on (key + value) string in UTF-8 encoding for a single property.

{
  "kind": "drive#property",
  "etag": etag,
  "selfLink": string,
  "key": string,
  "visibility": string,
  "value": string
}
Property name Value Description Notes
kind string This is always drive#property.
etag etag ETag of the property.
key string The key of this property. writable
visibility string The visibility of this property. Allowed values are PRIVATE and PUBLIC. (Default: PRIVATE). Private properties can only be retrieved using an authenticated request. An authenticated request uses an access token obtained with a OAuth 2 client ID. You cannot use an API key to retrieve private properties. writable
value string The value of this property. writable

Methods

delete
Deletes a property.
get
Gets a property by its key.
insert
Adds a property to a file, or updates it if it already exists.
list
Lists a file's properties.
patch
Updates a property.
update
Updates a property.