Latest updates
6.22.20
The following update applies to one or two GAM users, if you're not one of them, stop reading.
When GAM is processing commands with data from a CSV file, csv_input_row_drop_filter and
csv_input_row_filter are evaluated and utilized by the GAM main process and are not
evaluated or processed by the GAM sub processes.
When GAM is processing commands with data from a CSV file, csv_output_header_drop_filter,
csv_output_header_filter, csv_output_row_drop_filter and csv_output_row_filter are
evaluated by the GAM main process and utilized by the GAM sub processes.
Evaluating the row filters once in the GAM main process means that <RowValueFilter>
forms data:<DataSelector> and notdata:<DataSelector> only read the data from <DataSelector> once.
6.22.19
Updated code to handle OUs with a % in their name. OUs with a + in their name
are still handled incorrectly by the API when accessed directly.
6.22.18
Added option oneitemperrow to gam print vaultexports|exports to have each of an
exports cloudStorageSink files displayed on a separate row.
Added options bucketmatchpattern <RegularExpression> and objectmatchpattern <RegularExpression>
to gam download vaultexport|export to allow selective downloading of export files.
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
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