Scroll to bottom of page for installation/downloads
Latest updates
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.
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/Calendars
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/Users-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
7f9f17e34916625613265b38d3acf280f677c6913197879c6ca29234b11bde81 gamadv-xtd3-6.31.00-linux-arm64-glibc2.23.tar.xz
0d0a4bf24d5990ace7293db107657c4527311661a5e020b338212d9f0ffb9a8f gamadv-xtd3-6.31.00-linux-arm64-glibc2.27.tar.xz
7e90b880783a097bacac5a2fd7a114f430664a6f08834a915204272f406010e3 gamadv-xtd3-6.31.00-linux-arm64-glibc2.31.tar.xz
9d81d196e28b4832935da8b1c4f8f627fc5f18dd22355990d484bcb15d19dc7e gamadv-xtd3-6.31.00-linux-x86_64-glibc2.19.tar.xz
6ab2fb156c8b9043530ebee6c35b671022a6e6b71cda02eaf2ca1c8c112fb6b0 gamadv-xtd3-6.31.00-linux-x86_64-glibc2.23.tar.xz
7deb9cbfa7c7f5bfd2394a5f2228da986bd384339bd1c4040aebc317fa92677e gamadv-xtd3-6.31.00-linux-x86_64-glibc2.27.tar.xz
5dbf42fc40eb7aa788de7744c96d8ba893ee2d907ec2167be8bab5cf4852c2b0 gamadv-xtd3-6.31.00-linux-x86_64-glibc2.31.tar.xz
e4db91eff5bc46d2cb41e29ffcc66cb76e0983d0ac4d77113d2a51b6d01596b7 gamadv-xtd3-6.31.00-linux-x86_64-glibc2.35.tar.xz
5c9dc4b35b1ff255f9a88d81407bf642f83069a117ddb90fd4493a890649de67 gamadv-xtd3-6.31.00-linux-x86_64-legacy.tar.xz
a755b8e8a1c209f0c40d12ce1e1a45067efa3fce6699d3a257c6636922a3889c gamadv-xtd3-6.31.00-macos-arm64.tar.xz
3e401ec3d5e5efdb2791ec431b5e83a7f94d2753a8c325b12c03905f7039158a gamadv-xtd3-6.31.00-macos-x86_64-legacy.tar
83a8e26b7bb4b8cc64d0be1adc72e5ef3c50aa81ba4fb314777d2070c57e9824 gamadv-xtd3-6.31.00-macos-x86_64.tar.xz
6a9cf4d4d35d7ac93d2cfe3460692375443ca256b55fd94dc8a59b0d6e686364 gamadv-xtd3-6.31.00-windows-x86.msi
fc94e77892bb24b39610b695fbe1c399e59f2a9fbf24399e99326f5d1e24bf06 gamadv-xtd3-6.31.00-windows-x86.zip
2cc6ffc7744e59d290c054f9910bfcea167769e3997dac7b2a31f91eb5544417 gamadv-xtd3-6.31.00-windows-x86_64.msi
08e3adec4934f66ac5d5162b2fc0f248f77cf0e0687d31740b2439486f69a689 gamadv-xtd3-6.31.00-windows-x86_64.zip