recursive

Recursively modifies the labels on a folder and all of its children.

Synopsis

Implements the API documented at https://developers.google.com/drive/api/v3/reference/files/modifyLabels

gsm files modifyLabels recursive [flags]

Options

      --batchThreads int         Specify the number of threads that should be used for recursive commands (overrides value in config file. Max 16)
      --excludeFolders strings   Ids of folders to exclude.
                                 Note that due to the way permissions are automatically inherited in Drive, this may not have the desired result for permission commands!
      --fields string            Fields allows partial responses to be retrieved.
                                 See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
      --folderId string          File id of the folder.
  -h, --help                     help for recursive
      --includeRoot              If set to true, the root (specified parent) is included in the results
      --labelField strings       A single label field that should be updated on a file.
                                 Can be used multiple times in the form of "--labelField "labelId=...;fieldId=...;valueType=...,values=...", etc.
                                 GSM will consolidate all instances into a single request.
                                 You can use the following properties:
                                 labelId              The ID of the label.
                                 fieldId              The identifier of this field.
                                 valueType            The field type. While new values may be supported in the future, the following are currently allowed:
                                                      - dateString
                                                      - integer
                                                      - selection
                                                      - text
                                                      - user
                                 values				The value that should be set.
                                                     Must be compatible with the specified valueType.
                                                     When specifying multiple values use the pipe character ('|') to separate them.
                                 index               The index of the value if the field is multi-value

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 files modifyLabels - Modifies the set of labels on a file.