Latest updates
6.24.18
Added the following items to <CrOSTypeEntity>:
cros_ou_query <OrgUnitItem> <QueryCrOS>
cros_ou_and_children_query <OrgUnitItem> <QueryCrOS>
cros_ous_query <OrgUnitList> <QueryCrOS>
cros_ous_and_children_query <OrgUnitList> <QueryCrOS>
cros_ou_queries <OrgUnitItem> <QueryCrOSList>
cros_ou_and_children_queries <OrgUnitItem> <QueryCrOSList>
cros_ous_queries <OrgUnitList> <QueryCrOSList>
cros_ous_and_children_queries <OrgUnitList> <QueryCrOSList>
These allow specifying an OU, or a list of OUs, and a query or a list of queries
that apply to those OUs.
See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-ChromeOS-Devices
Example:
gam cros_ou_query /StudentChromebooks "sync:..2019-01-01" update ou "/OldChromebooks"
6.24.17
Updated gam report user to avoid a trap due to an unexpected change in the Reports API.
6.24.16
Fixed bug in gam update cros <CrOSEntity> ... updatenotes "#notes#"abc" that caused a trap
when the ChromeOS device didn't previously have notes.
6.24.15
Added pre_provisioned_disable and pre_provisioned_reenable to <CrOSAction>.
Updated code to take advantage of an update to the directory API that simplifies getting
ChromeOS devices from an OU and its children.
Fixed bug in gam create|update adminrole where child privileges were not recognized in <PrivilegesList>.
6.24.14
Fixed bug introduced in 6.24.13 that prevented specifying a contact group by name.
6.24.13
The Customer ID value that the Cloud Channel API describes is not the Google Workspace Customer ID value; it is unique to the Cloud Channel API.
Added channel_customer_id variable to gam.cfg that is used in gam print|show channelcustomercentitlements to specify the default value for customerid
rather than customer_id from gam.cfg.
6.24.12
Changed how selectcontactgroup <ContactGroupItem> is processed in commands that process
user contacts. Previously, GAM would download all of a user's contacts and locally filter
to get only the contacts in <ContactGroupItem>. Now, the People API is used to get the
list of contacts in <ContactGroupItem> and they are are individually downloaded for processing.
6.24.11
Following Jay's lead, updated gam print devices|deviceusers to try to work around
a Google API internal bug (237397223) that generates the following error after an hour:
ERROR: 400: invalidArgument - Request contains an invalid argument.
6.24.10
Updated gam print devices to refresh the access token between listing the devices
and listing the device users to try to avoid the following error:
ERROR: 400: invalidArgument - Request contains an invalid argument.
6.24.09
Updated gam print devices|deviceusers to handle the following error:
ERROR: 503: serviceNotAvailable - The service is currently unavailable.
6.24.08
Added option adminaccess to gam [<UserTypeEntity>] delete teamdrive <SharedDriveEntity>
to allow Super Admins to delete Shared Drives even if they are not an organizer.
Added option [<DriveFileParentAttribute>] to gam <UserTypeEntity> claim ownership <DriveFileEntity>.
By default, claim ownership does not change the parents of <DriveFileEntity>; this options allows
specification of a parent folder in the My Drive of the claiming user <UserTypeEntity>.
Added option [<DriveFileParentAttribute>] to gam <UserTypeEntity> transfer ownership <DriveFileEntity> <UserItem>.
By default, transfer ownership does not change the parents of <DriveFileEntity>; this options allows
specification of a parent folder in the My Drive of the target user <UserItem>.
- Upgraded to Python 3.10.5
- Upgraded to OpenSSL 1.1.1p
6.24.07
Updated commands that process group settings to handle the following error:
ERROR: 401: authError - Authorization Failed
6.24.06
Improved gam user user@domain.com print filecounts select teamdriveid "<DriveFileID>" summary only
to display the Shared Drive ID and name on the summary line.
6.24.05
Updated option orderby completed|due|updated to gam <UserTypeEntity> print|show tasks to
display tasks in date order regardless of the hierarchy.
Fixed bug in 6.24.03 bug fix in gam <UserTypeEntity> transfer drive <UserItem> ... targetfolderid root ....
6.24.04
Updated gam update chromepolicy to allow zero-length values for TYPE_STRING policy values;
this is required to be able to clear a value from such a policy.
6.24.03
Fixed bug in gam <UserTypeEntity> transfer drive <UserItem> ... targetfolderid root ... that
transferred data to the source user's root folder, not the target user's root folder.
6.24.02
Fixed bug in gam print crostelemetry that included a spurious column header, devicdId, in the output.
6.24.01
Updated gam <UserTypeEntity> print|show tasks to display tasks in hierarchical order.
Added option orderby completed|due|updated to gam <UserTypeEntity> print|show tasks to
display tasks in date order within the hierarchy.
6.24.00
Added commands to manage and display Google Tasks.
6.23.01
Updated gam <UserTypeEntity> create|update|show|print form to give a better error message when the Forms API is not enabled.
ERROR: 403: permissionDenied - Google Forms API has not been used in project XXXXXXX before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/forms.googleapis.com/overview?project=XXXXXXX then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our sys\
tems and retry.
is replaced with
ERROR: Forms API not enabled. Please run "gam update project" and "gam user user@domain.com check serviceaccount"
6.23.00
Updated gam <UserTypeEntity> copy|move drivefile to produce more
informative progress messages. The source file name(ID) are shown
as well as the target parent folder name(ID) and target file/folder name(ID).
Deleted options copytopfileparents, copytopfolderparents copysubfileparents and copysubfolderparents
from gam <UserTypeEntity> copy drivefile as multi-parent file/folders can not be copied with multiple parents.
Updated gam <UserTypeEntity> copy drivefile to use shortcuts when the same file appears more that once in the copy.
The first time the file is processed, it is copied; if it is processed again (because of multiple parents within the source
folder structure), a shortcut is created that points to the first copy.
Added option copiedshortcutspointtocopiedfiles [<Boolean>] to gam <UserTypeEntity> copy drivefile.
In previous versions, copying shortcuts caused an error because shortcuts can't be copied, they must be re-created.
If a shortcut in the source structure points to a file/folder that is not in the source structure:
- The shortcut is re-created to point to the original file/folder.
If a shortcut in the source structure points to a file/folder that is in the source structure: copiedshortcutspointtocopiedfilesomitted orcopiedshortcutspointtocopiedfiles true- The shortcut is re-created to point to the copied file/folder.copiedshortcutspointtocopiedfiles false- The shortcut is re-created to point to the original file/folder.
Deleted options copysubfileparents and copysubfolderparents
from gam <UserTypeEntity> move drivefile as multi-parent file/folders can not be moved with multiple parents.
Added option createshortcutsfornonmovablefiles [<Boolean>] to gam <UserTypeEntity> move drivefile
to control processing of non-movable files; for example, files owned by users outside of your domain.
It causes GAM to create a shortcut in the target folders for files in the source folders that are not movable.
createshortcutsfornonmovablefilesomitted orcreateshortcutsfornonmovablefiles false- No shortcuts
are created and an error message is given explaining why the file can't be moved.createshortcutsfornonmovablefiles true- A shortcut is created that points to the non-movable file.
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