taers232c/GAMADV-XTD3 v6.25.08 on GitHub

Latest updates

6.25.08

Added error checking to gam create datatransfer to avoid a trap.

6.25.07

Fixed bug introduced in 6.25.06 where only one row of a CSV file/Google Sheet was read by default.

6.25.06

Updated option maxrows <Integer> for gam csv|loop to be applied after input row filtering;
this allows limiting the number of filtered rows processed as opposed to the number of rows read.

maxrows 0 - All rows are processed, this is the default
maxrows N - N filtered rows are processed

6.25.05

Added option maxrows <Integer> to gam csv|loop that allows you to limit the number of rows
read from the CSV file/Google Sheet. This can be used during testing in order to verify the functioning
of the command on a few rows before committing to all of the rows.

gam csv|loop <FileName>|-|(gsheet <UserGoogleSheet>) [charset <Charset>] [warnifnodata]
        [columndelimiter <Character>] [quotechar <Character>] [fields <FieldNameList>]
        (matchfield|skipfield <FieldName> <RegularExpression>)* [showcmds [<Boolean>]]
        [maxrows <Integer>]
        gam <GAMArgumentList>

maxrows -1 - All rows are read, this is the default
maxrows 0 - No rows are read
maxrows N - N rows are read

6.25.04

Updated gam create|update course ... copyfrom <CourseID> ... copytopics true to preserve the topics order.

6.25.03

Updated gam print users to properly display the languages attribute based on the output format:

default - languages column has the value en+
formatjson - JSON column contains "languages": [{"languageCode": "en", "preference": "preferred"}]

6.25.02

Added option missingtextvalue <String> to gam <UserTypeEntity> create note json ... that causes GAM
to supply a value for JSON list and text items that are missing text fields. This option must appear
before the json option. If not specified and a text field is missing, you'll get the following error:
Request contains an invalid argument.

6.25.01

Updated license commands to retry the following error:

ERROR: 503: serviceNotAvailable - The service is currently unavailable.

Updated https://apps.google.com/user/hub to https://workspace.google.com/dashboard in the new user email message; thanks to @jay-eleven.

6.25.00

Added initial support for the Drive Labels API. GAM can display drive labels and it can apply them to files
and display drive labels on files. Please test/experiment and report any issues.

To use these commands you must add the 'Drive Labels API' to your project and update your service account authorization.

gam update project
gam user user@domain.com check serviceaccount

Supported editions for this feature: Business Standard and Business Plus; Enterprise; Education Standard and Education Plus; G Suite Business; Essentials.

6.24.27

Following Jay's lead, updated Cloud Identity API from v1beta1 to v1 for userinvitations commands.

6.24.26

Updated handling of shortcuts in gam <UserTypeEntity> claim|transfer ownership.

6.24.25

Corrected progress messages for gam print groups showownedby.

6.24.24

Added gradebooksettings to <CourseFieldName>.

6.24.23

Increase wait time in gam create project as Google is taking much longer to create projects.

6.24.22

Added option license <SKUID> [product|productid <ProductID>] to gam create user that assigns a
license to a user at the time of creation.

6.24.21

Fixed bug in gam <UserTypeEntity> move drivefile ... createshortcutsfornonmovablefiles that caused the following error:

ERROR: 403: shortcutTargetInvalid - The specified file is not an allowed shortcut target type.

6.24.20

Fixed bug in gam <UserTypeEntity> claim ownership that caused a trap.

6.24.19

Upgraded to OpenSSL 1.1.1q

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.