create
Creates a new Label.
Synopsis
Implements the API documented at https://developers.google.com/drive/labels/reference/rest/v2/labels/create
gsm driveLabels create [flags]
Options
--description string The description of the label.
--field strings Defines a field that has a display name, data type, and other configuration options.
This field defines the kind of metadata that may be set on a Drive item.
Can be used multiple times in the format: "displayName=...;valueType=...;[required=[true|false];insertBeforeField=...;minLength=]"
The following options are available:
- displayName - (string) Required. The display text to show in the UI identifying this field.
- required - (bool) Whether the field should be marked as required.
- insertBeforeField - (string) Input only. Insert or move this field before the indicated field. If empty, the field is placed at the end of the list.
- valueType - The type of the field
Where valueType may be one of the following, with different options available for each type:
- textString - A text field
- integer - An integer field
- user - A field that allows the selection of one or more user(s)
- maxEntries - The maximum number of entries for the field as a whole number
- selection - A field that allows the user to select on or more choices from a predefined set
- maxEntries - The maximum number of entries for the field as a whole number
- choices - A list of choices in the format "choices=choice1|choice2|choice3"
- dateString - A date field
- dateFormatType - Localized date format options. Possible values are:
- LONG_DATE - Includes full month name. For example, January 12, 1999 (MMMM d, y)
- SHORT_DATE - Short, numeric, representation. For example, 12/13/99 (M/d/yy)
--fields string Fields allows partial responses to be retrieved.
See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
-h, --help help for create
--labelType string The type of this label.
Defaults to SHARED.
[SHARED|ADMIN]
SHARED - Shared labels may be shared with users to apply to Drive items.
ADMIN - Admin-owned label. Only creatable and editable by admins. Supports some additional admin-only features. (default "SHARED")
--languageCode string The BCP-47 language code to use for evaluating localized field labels.
When not specified, values in the default configured language are used.
--learnMoreUri string Custom URL to present to users to allow them to learn more about this label and how it should be used.
--title string Title of the label.
--useAdminAccess Set to true in order to use the user's admin credentials.
The server verifies that the user is an admin for the label before allowing access.
Options inherited from parent commands
--compressOutput By default, GSM outputs "pretty" (indented) objects. By setting this flag, GSM's output will be compressed. This may or may not improve performance in scripts.
--config string config file (default is $HOME/.config/gsm/.gsm.yaml)
--delay int This delay (plus a random jitter between 0 and 50) will be applied after every command to avoid reaching quota and rate limits. Set to 0 to disable.
--dwdSubject string Specify a subject used for DWD impersonation (overrides value in config file)
--log string Set the path of the log file. Default is either ~/gsm.log or defined in your config file
--maxElapsedTime int This is the maximum total time that will be spent retrying a request in minutes. (default 15)
--maxRetryInterval int This is the maximum interval that will be used between retry attempts in seconds. (default 320)
--redirectPort int This is the TCP port on which GSM will create web server if you authenticate with a user account for the first time. This is necessary for the OAuth flow. See https://developers.google.com/identity/protocols/oauth2/native-app#redirect-uri_loopback (default 8081)
--retryOn ints Specify the HTTP error code(s) that GSM should retry on. Note that GSM will always retry on HTTP 403 errors that indicate a quota / rate limit error
--streamOutput Setting this flag will cause GSM to output slice values to stdout one by one, instead of one large object
SEE ALSO
- gsm driveLabels - Managed driveLabels (Part of Drive Labels API)