GoSpace Manager

Version v0.11.0

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

batch

Batch creates new shared drives using a CSV file as input.

Synopsis

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

gsm drives create batch [flags]

Options

      --batchThreads int           Specify the number of threads that should be used for batch commands (overrides value in config file. Max 16)
      --delimiter string           Delimiter to use for CSV columns. Must be exactly one character. Default is ';'
      --fields int                 Fields allows partial responses to be retrieved.
                                   See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
      --fields_ALL string          Same as fields but value is applied to all lines in the CSV file
  -h, --help                       help for batch
      --name int                   The name of this shared drive
      --name_ALL string            Same as name but value is applied to all lines in the CSV file
      --path string                Path of the import file (CSV)
      --returnWhenReady int        The Google Drive API returns the drive after creation immediately, but usually before it can be used in subsequent requests.
                                   Setting this flag will cause GSM to try and do the follwing on the newly created drive to make sure that it is available before returning it:
                                   1. Get the Drive by its driveId
                                   2. Get the user's permissionId from the about method
                                   3. Get the user's permission on the newly created Drive using the Drive's driveId and the user's permissionId
                                   4. Update the drive's DomainUsersOnly restriction to 'true'
                                   5. Update the drive's DomainUsersOnly restriction to 'false' (default)
                                   Note that this will cause additional API requests that may be subject to your quota.
                                   The API requests are made with useDomainAdminAccess set to 'false'
      --returnWhenReady_ALL        Same as returnWhenReady but value is applied to all lines in the CSV file
      --skipHeader                 Whether to skip the first row (header)
      --themeId int                The ID of the theme from which the background image and color will be set.
                                   The set of possible driveThemes can be retrieved from a drive.about.get response.
                                   When not specified on a drive.drives.create request, a random theme is chosen from which the background image and color are set.
                                   This is a write-only field; it can only be set on requests that don't set colorRgb or backgroundImageFile.
      --themeId_ALL string         Same as themeId but value is applied to all lines in the CSV file
      --useDomainAdminAccess int   Issue the request as a domain administrator
      --useDomainAdminAccess_ALL   Same as useDomainAdminAccess but value is applied to all lines in the CSV file

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