batchUpdate
Updates Label 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/batchUpdate
gsm driveLabelPermissions batchUpdate [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 batchUpdate
--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.
--permission strings A permission.
In order to update an existing permission use the following format:
"name=...;role=..."
In order to create a new permissions use one of the following depending on your use case:
"email=...;role=..."
"group=...;role=..."
"person=...;role=..."
"audience=...;role=..."
May be used multiple times to update multiple permissions at once.
If you don't specify the "labels/" prefix, GSM will automatically prepend it to the request.
--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 driveLabelPermissions - Manages Drive Label Permissions (Part of Drive Labels API)