Skip to content

Google: Lists the labels on a file For more information, see List labels on a file (https: developers google com workspace drive api guides list-labels) — response body — labels item fields value

Lists the labels on a file. For more information, see [List labels on a file](https://developers.google.com/workspace/drive/api/guides/list-labels).: response body, field labels / item / fields / value. Complete fields and constraints for contract 2026-10-27.

API reference · Contract 2026-10-27

SDK schema: Lists the labels on a file For more information, see List labels on a file (https: developers google com workspace drive api guides list-labels) — response body — labels item fields value

FieldTypePresenceDescription and constraints
$objectRootRepresentation of field, which is a typed key-value pair.
dateStringarrayOptionalOnly present if valueType is dateString. RFC 3339 formatted date: YYYY-MM-DD.
dateString[]stringEach itemFormat: date
idstringOptionalThe identifier of this label field.
integerarrayOptionalOnly present if `valueType` is `integer`.
integer[]stringEach itemFormat: int64
kindstringOptionalThis is always drive#labelField.
selectionarrayOptionalOnly present if `valueType` is `selection`
selection[]stringEach item
textarrayOptionalOnly present if `valueType` is `text`.
text[]stringEach item
userarrayOptionalOnly present if `valueType` is `user`.
user[]ModelEach itemExpand Gets information about the user, the user’s Drive, and system capabilities. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info). Required: The `fields` parameter must be set To return the exact fields you need, see Return specific fields (https: developers google com workspace drive api guides fields-parameter) — response body — user
valueTypestringOptionalThe field type. While new values may be supported in the future, the following are currently allowed: * `dateString` * `integer` * `selection` * `text` * `user`

Referenced models: Gets information about the user, the user’s Drive, and system capabilities. For more information, see [Return user info](https://developers.google.com/workspace/drive/api/guides/user-info). Required: The `fields` parameter must be set To return the exact fields you need, see Return specific fields (https: developers google com workspace drive api guides fields-parameter) — response body — user

Report an issue with this page

Necessary

Required for sign-in, security, authorization, and remembering your choices.

Always active

Analytics

Helps us understand which product and documentation features are useful.

Performance diagnostics

Uses performance tracing and privacy-masked session replay to diagnose problems.

You can change these choices at any time from Cookie settings.