Latest updates
6.22.17
Added quick_cros_move variable to gam.cfg that is used to provide the default value for quickcrosmove [<Boolean>] in:
gam update cros <CrOSEntity> <CrOSAttribute>+ [quickcrosmove [<Boolean>]] [nobatchupdate]
gam <CrOSTypeEntity> update <CrOSAttribute>+ [quickcrosmove [<Boolean>]] [nobatchupdate]
gam update org|ou <OrgUnitItem> add|move <CrOSTypeEntity> [quickcrosmove [<Boolean>]]
gam update org|ou <OrgUnitItem> sync <CrOSTypeEntity> [removetoou <OrgUnitItem>] [quickcrosmove [<Boolean>]]
Added use_projectid_as_name variable to gam.cfg that modifies gam create project to set
the default project name to the project ID instead of 'GAM Project' and to set the
default app name to the project ID instead of 'GAM'.
Improved error handling for the following error that occurs when the Customer ID is invalid.
ERROR: 400: invalidInput - Invalid Input
6.22.16
Corrected spelling of spreadcheetid to spreadsheetid and spreadcheeturl to spreadsheeturl
in <SpreadsheetField> used by gam <UserTypeEntity> info|print|show sheet <DriveFileEntity>.
<SpreadsheetField> ::=
developermetadata|
namedranges|
properties|
sheets|
spreadsheetid|
spreadsheeturl
6.22.15
Updated code to handle the following Oauth2 error:
ERROR: Authentication Token Error - access_denied: Account restricted
6.22.14
Added option stripcrsfromname to gam <UserTypeEntity> print|show filepath that causes carriage returns,
linefeeds and nulls to be stripped from file names.
Added option fullpath to gam <UserTypeEntity> print|show filepath and gam <UserTypeEntity> show fileinfo
that adds additional path information indicating that a file is an Orphan or Shared with me.
Added keywords mydriveid and rootid to <DriveFileEntity> as synonyms for mydrive and root in all
commands except gam <UserTypeEntity> print filelist|filetree. In those commands, select mydrive|root
is used to select a class of files; select mydriveid|rootid is used to select a folder starting point.
6.22.13
Updated code to handle another Google API problem when updating the OU of a Chromebook.
6.22.12
Updated code to handle a Google API problem when updating the OU of a Chromebook.
6.22.11
Updated gam download vaultexport|export to avoid a trap when the
usenewexport true option was used on the gam create vaultexport|export command
that created the matter.
6.22.10
Dropped deprecated argument enforcesingleparent <Boolean> from these commands:
gam <UserTypeEntity> create|add|update drivefile
gam <UserTypeEntity> create|add drivefileacl
gam <UserTypeEntity> create|add permissions
gam <UserTypeEntity> create|add sheet
6.22.09
Fixed bug in gam print cros ...showdvrsfp that caused a 'ZeroDivisionError: division by zero' trap.
6.22.08
Fixed bug where gam info people was not recognized as a valid command.
6.22.07
Fixed bug in gam <UserTypeEntity> print|show filetree select <DriveFileEntity> where the stripcrsfromname
option was not applied.
6.22.06
Updated code to handle Enterprise Licensing API issue with SKU 1010060001 (Google Workspace Essentials).
6.22.05
Fixed bug introduced in 6.22.04 in gam print users that caused a trap.
6.22.04
Fixed bug in gam update drivefile <DriveFileEntity> ... parentid <DriveFolderID> newfilename <DriveFileName>
where the file was not renamed.
The Enterprise License Manager API doesn't provide an option to get a list of the licenses a user holds.
For gam info user, GAM makes a batch API call with 47 product/SKU pairs querying whether the user holds
a license for the product/SKU. An error is returned (and suppressed) for each product/SKU pair for which
the user does not hold a license.
Currently, when you specify the license option with gam print users, GAM downloads all licenses for the domain
and from that data determines which licenses a user holds. For large numbers of users this works reasonably well;
for a small number of users the all license download might be overly expensive. The following options (synonyms)
licensebyuser|licensesbyuser|licencebyuser|licencesbyuser were added to gam print users that cause it
to use the batch API call method to retrieve the licenses for each user.
Additionally, these options (products <ProductIDList>)|(skus <SKUIDList>) can be used with both gam info user
and gam print users to limit the licenses retrieved.
Added license_skus variable to gam.cfg that defines the SKUs that will be processed when getting licenses.
Each item in the list can be a <SKUID> which will be validated or <ProductID>/<SKUID> which will not.
The default, an empty string, means that all SKUs will be processed when getting licenses.
6.22.03
Fixed bug in gam report customers|users ... date <Date> nodatechange where previous
bug fix in 6.20.10 changed the format of the output.
6.22.02
Google has updated the Directory API to explicitly allow updating the OU of a Chromebook
with the OU ID rather than the OU path. The update_cros_ou_with_id variable in gam.cfg specifies
whether to use the OU ID or path to update the OU of a Chromebook.
The Directory API now supports displaying the OU ID of a Chromebook; added orgunitid to <CrOSFieldName>
to allow display of this attribute in gam info|print cros.
Added display of the OU ID of a Chromebook to gam print crosactivity.
6.22.01
Fixed bug in code introduced in 6.22.00 that caused a trap.
6.22.00
Extended csv_input_row_filter, csv_input_row_drop_filter, csv_output_row_filter and csv_output_row_filter
to allow specification of filter values from a list, flat file or CSV file.
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/CSV-Input-Filtering
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/CSV-Output-Filtering
6.21.07
When setting a multivalued custom schema field for a user, if type home|other|work|(custom <String>) is not specified,
work will be assigned. Previously, if type was not specified, Google would accept the field without a type
but would eventually set type to work itself in the background.
Added ProuctID 101036: Google Meet Global Dialing and SKUID meetdialing|googlemeetglobaldialing;
thanks to @jay-eleven.
Added option formatjson to gam info resoldcustomer <CustomerID>.
6.21.06
Fixed bug in gam update|use project that caused the command to fail on Windows.
6.21.05
Fixed bug in gam print|show projects|svcaccts that caused a trap.
Added support for new calendar event read-only field eventType; thanks to @josemdv.
6.21.04
Updated handling of multivalued custom schema fields that are specified without a type;
the type will be shown as work as Google eventually sets the type to work itself.
6.21.03
Fixed bug in gam info|show schema that caused a trap.
6.21.02
Updated gam update chromepolicy to allow specification of policy data with JSON.
For complex policies, this is the only way to enter the policy data.
gam update chromepolicy
(<SchemaName>
(<Field> <Value>)+ |
(json [charset <Charset>] <JSONData>) |
(json file <FileName> [charset <Charset>])
)+
ou|org|orgunit <OrgUnitItem> [(printerid <PrinterID>)|(appid <AppID>)]
6.21.01
Added clock_skew_in_seconds variable to gam.cfg that defines the number of seconds
of clock skew allowed between local time and Google time. The default value is 10 seconds
which was the previous hard-coded value.
Updated GAM spreadsheet commands to handle the following error:
ERROR: 400: failedPrecondition - This operation is not supported for this document
6.21.00
Added option allowitemdeletion to gam [<UserTypeEntity>] delete shareddrive <SharedDriveEntity>
that allows deletion of non-empty Shared Drives. This option requires a Super Admin user.
Installation
If you are a first time Gam user:
If you are upgrading from standard Gam
If you are upgrading from GAMADV-X or GAMADV-XTD