Scroll to bottom of page for installation/downloads
Latest updates
6.57.11
Fixed bug where the csv_output_header_force variable in gam.cfg was being interpreted as
a list of <RegularExpressions> rather than a list of <Strings> as documented.
6.57.10
When doing commands similar to these:
gam redirect csv - multiprocess todrive csv Users.csv gam user "~primaryEmail" print filelist ...
gam config auto_batch_min 1 redirect csv - multiprocess todrive <UserTypeEntity> print filelist ...
GAM was including the name of the last user processed in the title of the uploaded Google Sheet;
as this is not accurate, it has been eliminated.
6.57.09
Added emailaddresslist <EmailAddressList> to <PermissionMatch> that allows matching any email address in a list.
6.57.08
Updated gam <UserTypeEntity> print|show contacts|othercontacts to retry the following error:
serviceNotAvailable - The service is currently unavailable.
6.57.07
Updated code to recognize the following Google Drive API error that is issued when Google
doesn't recognize an email address as valid.
$ gam user user@domain.com print filelist query "'j@ab.net' in writers" fields id,name
Getting all Drive Files/Folders that match query ('me' in owners and ('j@ab.net' in writers)) for user@domain.com
ERROR: 400: badRequest - Bad Request
$ gam user user@domain.com print filelist query "'j@ab.com' in writers" fields id,name
Getting all Drive Files/Folders that match query ('me' in owners and ('j@ab.com' in writers)) for user@domain.com
Got 0 Drive Files/Folders that matched query ('me' in owners and ('j@ab.com' in writers)) for user@domain.com...
Owner,id,name
6.57.06
Added inherited <Boolean> to <PermissionMatch> that applies only to Shared Drive files/folders;
this makes it easy to identify files/folders on Shared Drive with non-inherited permissions.
gam user organizer@domain.com print filelist select teamdriveid <TeamDriveID> fields id,name,mimetype pm inherited false em pmfilter oneitemperrow
This clause will always cause a permission match failure on My Drive files/folders.
6.57.05
Updated gam batch <BatchContent> and gam tbatch <BatchContent> commands to accept lines with the following form:
clear keyword
This can improve performance as subsequent lines in <BatchContent> will not be scanned for %keyword%.
6.57.04
Updated gam batch <BatchContent> and gam tbatch <BatchContent> commands to accept lines with the following form:
set keyword value
Subsequent lines in <BatchContent> will have %keyword% replaced with value.
6.57.03
Updated gam <UserTypeEntity> info|print|show contacts|othercontacts and
gam info|print|show peoplecontacts|peopleprofiles to default to displaying the fields names,emailaddresses,phonenumbers
as documented rather than all fields.
6.57.02
Following Jay's lead, removed Google bug (237397223) workaround code in
gam print devices|deviceusers|crostelemetry as the bug is now fixed.
6.57.01
Updated gam <UserTypeEntity> vacation to handle the following error:
ERROR: 400: failedPrecondition - Precondition check failed.
What the error means is unknown to me at the moment.
Updated GAM so that when the current project ID is required, it will first try to get it from oauth2service.json and
if not successful, try to get it from client_secrets.json. There are cases, e.g., when DASA is enabled,
that client_secrets.json is not present.
Previously, GAM checked for the existence of client_secrets.json on every command; this check has been
eliminated as the file is only required by gam oauth create.
6.57.00
Following Jay's lead, updated gam create admin to allow assignment of a delegated admin role to a group.
Updated gam print admins to display whether a role is assigned to a user or a group.
Updated version number to align with Standard GAM.
6.54.06
Added options users <EmailAddressList> and groups <EmailAddressList> to gam print aliases that is more
efficient for getting aliases for specific users and groups.
Added option select <UserTypeEntity> to gam print aliases that allows specification of a list users by <UserTypeEntity>;
e.g., a group or an org unit.
Added option delimiter <Character> to gam print aliases that is applicable when option onerowpertarget is specified.
Previously, multiple aliases were separated by a space character. Now, by default, the aliases are separated by the csv_output_field_delimiter' from gam.cfg. The option delimiter ` overrides that value.
6.54.05
Added option addcsvdata <FieldName> <String> to gam print aliases. This adds additional columns of data to the CSV file output.
This can be used when printing aliases for departed employees to indicate the new target for the user's alises. Subsequent
commands using the CSV file can reassign the aliases to the new target.
6.54.04
Updated gam print|show channelcustomerentitlements to handle the following error when
none of gam.cfg/channel_customer_id or command line arguments channelcustomerid or name are set.
ERROR: Parameter "parent" value "accounts/C03kt1789/customers/" does not match the pattern "^accounts/[^/]+/customers/[^/]+$"
6.54.03
By special request, British spelling of various keywords/arguments is now available.
backgroundcolor backgroundcolour
color colour
colorindex colourindex
costcenter costcentre
fileorganizer fileorganiser
foregroundcolor foregroundcolour
license licence
licenses licences
nolicenses nolicences
organization organisation
organizationname organisationname
organizations organisations
organizer organiser
organizeremail organiseremail
organizername organisername
textcolor textcolour
6.54.02
Updated gam <UserTypeEntity> get photo and gam <UserTypeEntity> get profilephoto to inspect the
photo data and add the appropriate extension: jpg, png, gif. If the type of the photo can't be
determined, img is used as the extenstion. If you use [filename <FileNamePattern>], #ext# will be replaced
with the extension.
Updated gam <UserTypeEntity> [create|add] sendas <EmailAddress> [name] <String> to allow the
optional argument name before <String> to make clear that <String> is the sendas display name.
6.54.01
Added commands to export messages/threads in EML/raw format.
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/Users-Gmail-Messages-Threads#export-messagesthreads
6.54.00
Following Jay's lead, updated gam delete inboundssoassignment <SSOAssignmentSelector> to allow
more flexibility in selecting assignments to delete.
Fixed bug in gam <UserTypeEntity> print|show filesharecounts that would cause a trap.
Updated gam <UserTypeEntity> print filelist ... fullpath showparent and gam <UserTypeEntity> print filepath
to properly display the file path of My Drive.
Upgraded to Python 3.11.3 where possible.
Added commands to create and delete Chrome networks.
gam create chromenetwork
<OrgUnitItem> <String> <JSONData>
gam delete chromenetwork
<OrgUnitItem> <NetworkID>
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
7fcfee503aa00eda1f5f385917adac0af587215f88dcb01ee1cc0dbbf0587c93 gamadv-xtd3-6.57.11-linux-arm64-glibc2.23.tar.xz
8cf61603fbfadde0a2453c399fae422055fac576a70ab9680a1de071c93c75b5 gamadv-xtd3-6.57.11-linux-arm64-glibc2.27.tar.xz
89e26a5b39a01fe5f22a5855ec62ed2b5c19ee8b7a3b33f5dba7e14fe4e033b1 gamadv-xtd3-6.57.11-linux-arm64-glibc2.31.tar.xz
8c5deda190a251ab293b58386d09eda1c4b27412b9443e1c0b71609c3d6a64bb gamadv-xtd3-6.57.11-linux-x86_64-glibc2.19.tar.xz
c8e0c612bdf24807cf8beaae9cc873a6cfeba7d87297e1d6f951404dbba9c130 gamadv-xtd3-6.57.11-linux-x86_64-glibc2.23.tar.xz
ff199046edac52f37aeb71ed5081dc229dad47b399807680dbb1b065f04a62c3 gamadv-xtd3-6.57.11-linux-x86_64-glibc2.27.tar.xz
dea2921c3acfae0e2486238d5ddca72451df833af701eb867843b367560cf6a6 gamadv-xtd3-6.57.11-linux-x86_64-glibc2.31.tar.xz
b9668bf45576e037dde4aa952b418b66d1ec25a1ddd2d79f803e3fd45d5f653e gamadv-xtd3-6.57.11-linux-x86_64-glibc2.35.tar.xz
a30b0284cb991703b0bb8bcb4f52c7279eebb223031f87313bfbb933feb95f05 gamadv-xtd3-6.57.11-linux-x86_64-legacy.tar.xz
2fecc3564d2a89677088de9068621aa6e6b053d910f7749988b1d7da597a256c gamadv-xtd3-6.57.11-macos-arm64.tar.xz
419106ff491501a7274b8220650db80baacc0ca2fd5edec8de47aa14ebea03a2 gamadv-xtd3-6.57.11-macos-x86_64-legacy.tar
a28cb866a0a1ef632a0760bc4a47712903db314d9ad647a87b281a3a3d002388 gamadv-xtd3-6.57.11-macos-x86_64.tar.xz
a982630d6bc94c0dba089281a5abb2831661d4be0d51b2464afe7246336a630b gamadv-xtd3-6.57.11-windows-x86.msi
f327f0af48df03a95d1513ba0fcf524f56ba9853ba05da778d9fd614ffd0412b gamadv-xtd3-6.57.11-windows-x86.zip
93bce0e37fd3d894422d018031998ce935438060b55407eff812dfe48b40d5a1 gamadv-xtd3-6.57.11-windows-x86_64.msi
e4fd8cc92e4f7706e69da2ca9e8cef6231fc4952f1fa4d5892b71cab68bbca74 gamadv-xtd3-6.57.11-windows-x86_64.zip