publish

Publishes a Label

Synopsis

Publish all draft changes to the Label. Once published, the Label may not return to its draft state. See google.apps.drive.labels.v2.Lifecycle for more information.

Publishing a Label will result in a new published revision. All previous draft revisions will be deleted. Previous published revisions will be kept but are subject to automated deletion as needed.

Once published, some changes are no longer permitted. Generally, any change that would invalidate or cause new restrictions on existing metadata related to the Label will be rejected. For example, the following changes to a Label will be rejected after the Label is published:

• The label cannot be directly deleted. It must be disabled first, then deleted.
• Field.FieldType cannot be changed.
• Changes to Field validation options cannot reject something that was previously accepted.
• Reducing the max entries.

Implements the API documented at https://developers.google.com/drive/labels/reference/rest/v2/labels/publish

gsm driveLabels publish [flags]

Options

      --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 publish
      --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.
      --name string                 Label resource name.
                                    May be any of:
                                      - labels/{id} (equivalent to labels/{id}@latest)
                                      - labels/{id}@latest
                                      - labels/{id}@published
                                      - labels/{id}@{revisionId}
                                    If you don't specify the "labels/" prefix, GSM will automatically prepend it to the request.
      --requiredRevisionId string   The [revisionId][google.apps.drive.labels.v1.Label.revision_id] of the label that the write request will be applied to.
                                    If this is not the latest revision of the label, the request will not be processed and will return a 400 Bad Request error.
      --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.
      --view string                 When specified, only certain fields belonging to the indicated view are returned.
                                    [LABEL_VIEW_BASIC|LABEL_VIEW_FULL]
                                    LABEL_VIEW_BASIC - Implies the field mask: name,id,revisionId,labelType,properties.*
                                    LABEL_VIEW_FULL  - All possible fields.

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)