GoSpace Manager

Version v0.11.0

Manage Google Workspace resources using a developer-friendly CLI written in Go

create

Updates a Label’s permissions. If a permission for the indicated principal doesn’t exist, a new Label Permission is created, otherwise the existing permission is updated. Permissions affect the Label resource as a whole, are not revisioned, and do not require publishing.

Synopsis

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

gsm driveLabelPermissions create [flags]

Options

      --audience string   Audience to grant a role to.
                          The magic value of audiences/default may be used to apply the role to the default audience in the context of the organization that owns the Label.
      --email string      Specifies the email address for a user or group pricinpal.
                          Not populated for audience principals.
                          User and Group permissions may only be inserted using email address.
                          On update requests, if email address is specified, no principal should be specified.
      --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
      --parent string     The parent Label resource name. Format: labels/{label}
                          If you don't specify the "labels/" prefix, GSM will automatically prepend it to the request.
      --role string       The role the principal should have.
                          "[READER|APPLIER|ORGANIZER|EDITOR].
                          READER     - A reader can read the label and associated metadata applied to Drive items.
                          APPLIER    - An applier can write associated metadata on Drive items in which they also have write access to. Implies READER.
                          ORGANIZER  - An organizer can pin this label in shared drives they manage and add new appliers to the label.
                          EDITOR     - Editors can make any update including deleting the label which also deletes the associated Drive item metadata. Implies APPLIER.
      --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