github taers232c/GAMADV-XTD3 v6.31.05
GAM 6.31.05
on GitHub

latest releases: v7.00.04, v7.00.03, v7.00.02...
19 months ago

Scroll to bottom of page for installation/downloads

Latest updates

6.31.05

Google can return an error Internal error on API calls; by default, GAM retries these API calls an additional 9 times
for a total of 10 tries. In some cases, determined by experience, the additional retries are unlikely to succeed and
GAM performs 1 additional retry rather than 9 for a total of 2 tries.

Added bail_on_internal_error_tries variable to gam.cfg that is used by GAM to control
the total number of tries for these API calls; Google seems to be sending this error when it is very busy.
The default value is 2 and values from 1 to 10 are allowed.
This is a rare event, this is an experiment to see if retrying these errors more times leads to success.

6.31.04

Added commands to display Chrome Devices Needing Attention counts. 

gam print chromeneedsattn [todrive <ToDriveAttribute>*]
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [formatjson [quotechar <Character>]]
gam show chromeneedsattn
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [formatjson]

6.31.03

Added commands to display Chrome Auto Update Expiration counts. 

gam print chromeaues [todrive <ToDriveAttribute>*]
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [minauedate <Date>] [maxauedate <Date>]
        [formatjson [quotechar <Character>]]
gam show chromeaues
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [minauedate <Date>] [maxauedate <Date>]
        [formatjson]

6.31.02

Updated gam <UserTypeEntity> vacation to process (replace <Tag> <String>)* in the subject.

6.31.01

Added option nofile to gam <UserTypeEntity> get photo|profilephoto that causes GAM to suppress
writing the photo data to a file. This would typicically be used when you are capturing the photo data
written to stdout.

6.31.00

Added retry_api_service_not_available variable to gam.cfg that is used to have GAM retry
Service not applicable errors on API calls; Google seems to be sending this error when it is very busy.
This is a rare event, this is an experiment to see if GAM can identify these errors and retry them.

6.30.18

Fixed bug in gam <UserTypeEntity> move drivefile where the modified time of files was inappropriately being changed.

6.30.17

Updated code for gam <UserTypeEntity> get profilephoto size <Integer> to account for API documentation error.

6.30.16

Added option nodefault to gam <UserTypeEntity> get profilephoto that causes GAM to display an
error message and set the return code to 50 if the user has a default profile photo.

6.30.15

Added option gphoto <EmailAddress> <DriveFileIDEntity>|<DriveFileNameEntity> to gam <UserTypeEntity> update photo
that specifies an owner and file to be used as the source of the photo.

6.30.14

Fixed bug in gam <UserTypeEntity> print|show peopleprofile fields ... where metadata was being displayed
even when showmetadata was not specified.

6.30.13

Fixed bug in gam <UserTypeEntity> show fileinfo <DriveFileEntity> fields shortcutdetails.targetid that caused a trap.

Added option size <Integer> to gam <UserTypeEntity> get profilephoto that specifies the size in pixels of the file to download.

6.30.12

Updated gam update group <GroupEntity> update [<GroupRole>] [[delivery] <DeliverySetting>] <UserTypeEntity>
to handle the following error when <UserTypeEntity> is an external member. 

ERROR: 404: resourceNotFound - Does not exist

This is a Google bug where some external members can't be updated by email address.

6.30.11

Added option emailmatchpattern [not] <RegularExpression> to gam <UserTypeEntity> delete group|groups
that allows deleting a user from all groups of which they are a member based on (not) matching the group email address.

6.30.10

Added the ability to specify fields when displaying calendars.

6.30.09

Added the following shortcuts to <DriveFileQueryShortcut>: 

* my_top_files - "'me' in owners and mimeType != application/vnd.google-apps.folder and 'root' in parents"
* my_top_folders - "'me' in owners and mimeType = application/vnd.google-apps.folder and 'root' in parents"
* my_top_items - "'me' in owners and 'root' in parents"

6.30.08

Following Jay's lead, added the following License SKUs: 

1010390001 - Assured Controls
1010400001 - Beyond Corp Enterprise

6.30.07

Added option sheetsfields <SpreadsheetSheetsFieldList> to gam <UserTypeEntity> print|show sheet <DriveFileEntity>
that lets you specfiy the desired subfields from the sheets field of a spreadsheet that should be displayed.
By default, all sheets subfields are displayed. 

<SpreadsheetSheetsField> ::=
        bandedranges|
        basicfilter|
        charts|
        columngroups|
        conditionalformats|
        data|
        developermetadata|
        filterviews|
        merges|
        properties|
        protectedranges|
        rowgroups|
        slicers
<SpreadsheetSheetsFieldList> ::= "<SpreadsheetSheetsField>(,<SpreadsheetSheetsField>)*"

6.30.06

Fixed bug in gam <UserTypeEntity> create|update|delete drivefileacl <DriveFileEntity> ... updatesheetprotectedranges
that caused a trap.

6.30.05

Cleaned up code for option updatesheetprotectedranges in gam <UserTypeEntity> create|update|delete drivefileacl <DriveFileEntity>.

6.30.04

Improved output formatting for field sheets in gam <UserTypeEntity> info sheet <DriveFileEntity>.

6.30.03

Updated gam <UserTypeEntity> create|update drivefileacl <DriveFileEntity> commands to handle the following error. 

ERROR: 403: fileOrganizerOnFoldersInSharedDriveOnly - FileOrganizer role is only allowed on folders.

Added option updatesheetprotectedranges to gam create|update|delete drivefileacl commands that causes GAM to update Sheet Protected Ranges if` is a Google Sheet.

6.30.02

Fixed error message in gam print cigroups when an invalid field was specified.

6.30.01

Fixed bug in gam create cigroup <EmailAddress> name <String> <GroupAttribute>+ where the group name was set to <EmailAddress> rather than <String>.

6.30.00

Added option returnidonly to gam <UserTypeEntity> show fileinfo <DriveFileEntity>
that causes GAM to return just the file ID of the files in <DriveFileEntity> file as output. 

$ gam user user@domain.com show fileinfo root returnidonly
0AHYenC8f12ALUk9xyz

$ gam user testsimple show fileinfo name "Test File" returnidonly
0B3YenC8f12ALflhUTmtNS3E2Vk9LSUpBVXRSUG5lQ29GWkRtWHM1VzU1blc4ZW1pb2FnNTA

Changed the display format of file paths for files on Shared Drives.

  • Old format - SharedDrive(TS Shared Drive 6)/TS SD6 Folder/TS TD6 Doc
  • New format -SharedDrives/TS Shared Drive 6/TS SD6 Folder/TS TD6 Doc

Added option returnpathonly to gam <UserTypeEntity> show filepath <DriveFileEntity>
that causes GAM to return just the file path of the files in <DriveFileEntity> file as output. 

$ gam user user@domain.com show filepath name "Test File" returnpathonly
My Drive/Classroom/Test File

$ gam user user@domain.com show filepath 0AJ6mqwXP9wHxUk9xyz returnpathonly
TS Shared Drive 6

$ gam user testsimple show filepath 0AJ6mqwXP9wHxUk9xyz returnpathonly fullpath
SharedDrives/TS Shared Drive 6

$ gam user user@domain.com show filepath teamdriveid 0AJ6mqwXP9wHxUk9xyz teamdrivefilename "TS TD6 Doc" returnpathonly
SharedDrives/TS Shared Drive 6//TS SD6 Folder/TS TD6 Doc

Added command gam comment <String>* that displays the comment data on stdout.
This can be used to validate csv_input_row_filters and column value extraction. 

$ more Comment.csv
col1,col2
aaa,111
bbb,222
ccc,333
$ gam config csv_input_row_drop_filter "col1:regex:bbb" csv Comment.csv gam comment "Col1:~~col1~~" "Col2:~~col2~~"
2022-12-16T12:41:50.045-08:00,0/2,Using 2 processes...
Col1:aaa Col2:111
Col1:ccc Col2:333

Updated gam <UserTypeEntity> create|delete license <SKUIDList> to take a list of SKUs.

Updated gam create user <EmailAddress> ... license <SKUIDList> to take a list of SKUs.

Updated gam <UserTypeEntity> sync license <SKUIDList> to take a list of SKUs and
added option allskus|onesku that is required when multiple SKUs are specified.

  • allskus indicates that users in <UserTypeEntity> will be updated to have all of the SKUs in <SKUIDList>.
    • This is typically used when assigning different types of licenses, such as an Enterprise license and a Voice license.
  • onesku indicates that users in <UserTypeEntity> with none of the licenses in<SKUIDList> will be updated to have the first available license SKU in <SKUIDList>.
    • This is typically used with Google Education Plus or Google Education Standard licenses, which are split across multiple SKUs.

Added option basic to gam print cigroups that causes GAM to display the basic
Cloud Identity Group fields, i.e., those fields that do not require an additional API call per group.

Following Jay's lead, added option query <String> to gam print cigroups.

Installation

If you are a first time Gam user:

If you are updating your GAMADV-XTD3 version:

If you are upgrading from standard Gam

If you are upgrading from GAMADV-X or GAMADV-XTD

sha256 hashes

4f7151dc37328b363b01cc3cfb99d2efcc6f94dd1317702af702d26b09bd0aa7  gamadv-xtd3-6.31.05-linux-arm64-glibc2.23.tar.xz
ffc945f8f68687d1d41604b0d3c20a2439173c63f4b311b5124b937ca07409b7  gamadv-xtd3-6.31.05-linux-arm64-glibc2.27.tar.xz
bb6f8f88f119ffcd14d9bbc0f6009cb51e8c0742e2428a4725399079572272a3  gamadv-xtd3-6.31.05-linux-arm64-glibc2.31.tar.xz
68229bbdd626419fcebdb00db4f2d48d0b47d3d06a85836c4c200fa121d5d0d2  gamadv-xtd3-6.31.05-linux-x86_64-glibc2.19.tar.xz
cf87d6cac9ab8c6460e372868f3c858cfbd0d6901822d99d4ea3f54128bd6d01  gamadv-xtd3-6.31.05-linux-x86_64-glibc2.23.tar.xz
2f862ce625a811ebe0309c407933a81562045e721eb4a3eeed393d348cae3adc  gamadv-xtd3-6.31.05-linux-x86_64-glibc2.27.tar.xz
df568a83e119548bf88d2160797d33b89ecd35b9c76e44f854c2e1083597e445  gamadv-xtd3-6.31.05-linux-x86_64-glibc2.31.tar.xz
9edf01cead46ac533d4c8f7d35b34d501d798283070da8fcd19eb45f17bf1c1e  gamadv-xtd3-6.31.05-linux-x86_64-glibc2.35.tar.xz
54b8a9e85964a64c3957010a9f89b0150cf673ee31ead95e9adcdcfafa40634c  gamadv-xtd3-6.31.05-linux-x86_64-legacy.tar.xz
537e910b0c2fddd391e03052dbd39f5df07df042e55d2e6b9f7981e74b3c199c  gamadv-xtd3-6.31.05-macos-arm64.tar.xz
d83eb9704b462707a20dd6cbec9fca09a81943188d37e875684cd2cffcf15aab  gamadv-xtd3-6.31.05-macos-x86_64-legacy.tar
66695059070735570f8c73d7eedfc29e3067079480e49b48899cd2a5500d49a7  gamadv-xtd3-6.31.05-macos-x86_64.tar.xz
5779dc9ce0b0b8e3c53b718d0efaee63c5fc5975d69146e826aad878a62d51ec  gamadv-xtd3-6.31.05-windows-x86.msi
17719134978c46b302776bd3c0cee8f364064d4b7b6d1649e3405d4bc7d40784  gamadv-xtd3-6.31.05-windows-x86.zip
5601a6a410a33f11f7a2d663f1db8ed02a5038718f04effabda26f71af6423b8  gamadv-xtd3-6.31.05-windows-x86_64.msi
8132b1e7748f1671f54074ebac90e8f087f15acac1f66a8862470bb3164abaa2  gamadv-xtd3-6.31.05-windows-x86_64.zip
Check out latest releases or
releases around taers232c/GAMADV-XTD3 v6.31.05

Don't miss a new GAMADV-XTD3 release

NewReleases is sending notifications on new releases.

Get notifications