Scroll to bottom of page for installation/downloads
Latest updates
6.28.07
Added option csv [todrive <ToDriveAttribute>*] (addcsvdata <FieldName> <String>)* to gam <UserTypeEntity> copy drivefile
that causes GAM to output CSV data detailing the name, id and mimeType of the copied files and folders
rather than text messages. These are the CSV headers:
User,name,id,newName,newId,mimeType
You can add additional columns of data from the command line to the CSV data with (addcsvdata <FieldName> <String>)*.
Added option suppressnotselectedmessages [<Boolean>] to gam <UserTypeEntity> copy drivefile
that causes GAM to suppress text messages referencing files and folders not selected for copying by the following options:
copysubfiles false [filenamematchpattern <RegularExpression>] [filemimetype [not] <MimeTypeList>]
copysubfolders false [foldernamematchpattern <RegularExpression>
copysubshortcuts false [shortcutnamematchpattern <RegularExpression>
6.28.06
Fixed bug in gam <UserTypeEntity> print|show messages ... showbody that caused a trap.
Added code to handle the following error that occurs when copying permissions:
ERROR: 400: shareInNotPermitted - Bad Request. User message: "An item can't be shared with user@domain.com because of domain.com sharing policy"
6.28.05
Added the following items to <UserMultiAttribute>:
employeeid <String>as a synonym forexternalids organization <String>manager <String>as a synonym forrelations manager <String>
Added the following items to <UserFieldName>:
employeeidas a synonym forexternalidsmanageras a synonym forrelations
6.28.04
Added filtercontactgroup <PeopleContactGroupItem> to <PeoplePrintShowUserContactSelection>
that is used by gam <UserTypeEntity> print|show contacts. When selectcontactgroup <PeopleContactGroupItem>
is used in these commands, GAM makes an API call to get the list of contacts in <PeopleContactGroupItem>
and then makes an API call per contact to get the details; this may exceed quota limits.
When filtercontactgroup <PeopleContactGroupItem> is used, GAM makes an API call to get all contacts and
then filters the list to only those in <PeopleContactGroupItem>; quota limits should not apply.
6.28.03
Build MacOS x86_64 and arm64 executables.
6.28.02
Fixed bug in gam forward message|thread that misformatted the message when Cc: was present.
6.28.01
Fixed bug in gam forward message|thread where subject was blanked out.
6.28.00
- Upgraded to Python 3.11.0 where possible.
- Upgraded to OpenSSL 3.0.7 where possible.
Fixed bug in gam forward message where messages originally sent to multiple recipients
were not forwarded correctly.
Added command to forward threads; all messages referenced by the thread are forwarded; this is experimental, test.
gam <UserTypeEntity> forward thread|threads recipient|to <RecipientEntity>
(((query <QueryGmail>) (matchlabel <LabelName>) [or|and])+
[quick|notquick] [doit] [max_to_forward <Number>])|(ids <MessageIDEntity>)
[subject <String>]
6.27.21
Eliminated superfluous column header labels in gam print cigroups.
Added command to forward messages; this is experimental, test.
gam <UserTypeEntity> forward message|messages recipient|to <RecipientEntity>
(((query <QueryGmail>) (matchlabel <LabelName>) [or|and])+
[quick|notquick] [doit] [max_to_forward <Number>])|(ids <MessageIDEntity>)
6.27.20
Added option url <URL> to gam <UserTypeEntity> create|update drivefile that allows
GAM to upload files referenced by URL to Google Drive.
Added csv_input_row_limit variable to gam.cfg that is used to limit the number of rows read from a CSV file.
Added csv_output_row_limit variable to gam.cfg that is used to limit the number of rows written to a CSV file.
6.27.19
Added option embedimage <FileName> <String> to the following commands that allows
embedding images in HTML email messages.
gam sendemail [recipient|to] <RecipientEntity>
gam <UserTypeEntity> sendemail recipient|to <RecipientEntity>
gam <UserTypeEntity> sendemail from <EmailAddress>
gam <UserTypeEntity> draft|import|insert message
Your HTML message will contain lines like this:
<img src="cid:image1"/>
<img src="cid:image2"/>
Your command line will have: embedimage file1.jpg image1 embedimage file2.jpg image2`
Added archive as a synonym for archived and suspend as a synonym for suspended
in <UserBasicAttribute>.
6.27.18
Added option tdshare <EmailAddress> commenter|reader|writer to <ToDriveAttribute>. When a new
todrive file is created, i.e., tdfileid <DriveFileID> is not specified, the uploaded file will
be shared as specified. <EmailAddress> must be valid within your Google Workspace.
6.27.17
Updated todrive tdfileid <DriveFileID> to display an informative error message when Google generates
an Internal Error. It appears that the file was successfully uploaded and converted to a sheet but
the conversion took longer that the API was willing to wait, so it generated the error.
6.27.16
Updated todrive tdfileid <DriveFileID> to not perform retries for Internal Error when updating an existing file
as the 6.27.15 update didn't fix the underlying problem.
6.27.15
Fixed bug in gam show chromeschemas that caused a trap due to unexpected data from Google.
Updated gam <UserTypeEntity> collect orphans to handle the error:
ERROR: 403: shortcutTargetInvalid - The specified file is not an allowed shortcut target type.
These are typically Google Backup & Sync images of laptops.
Fixed bug in gam <UserTypeEntity> sendemail from <EmailAddress> that reported:
User: user@domain.com, Send Email to 0 Recipients
Updated todrive tdfileid <DriveFileID> to perform retries for Internal Error when updating an existing file.
Added option noselfowner to all commands that print or show calendar ACls;
it suppresses the display of ACLs that reference the calendar itself as its owner.
6.27.14
Extended gam print addresses to include information about domains and resource calendars.
A new column Target was added that displays target information for user, group and domain aliases.
6.27.13
Added option showdate to gam <UserTypeEntity> print|show messages|threads that displays
the internalDate field for a message|thread.
The internal message creation timestamp (epoch ms), which determines ordering in the inbox.
For normal SMTP-received email, this represents the time the message was originally accepted by Google,
which is more reliable than the Date header.
6.27.12
Added option labellist <LabelNameEntity> to gam <UserTypeEntity> print|show labels
to allow selection of labels to display.
Added option cigrouptree to gam info user. Previously, the grouptree option used
the Cloud Identity Groups API to display the users group tree structure. This API is licensed
and the command would generate an error if you didn't have the license. Now, the grouptree option
uses the Directory API and the cigrouptree option uses the Cloud Identity Groups API.
Updated gam <UserTypeEntity> collect orphans to not use shortcuts by default.
If an orphan file can have its parent changed without affecting its access by other users, the parent is changed.
If a parent change would affect the access by other users, a shortcut is created. You can still use
the useshortcuts true option to force the use of shortcuts. If you specify the preview option,
a new column, action, shows changeParent or createShortcut to indicate what action will be taken
when preview is omitted.
6.27.11
Added options showparentsaslist [<Boolean>] and delimiter <Character> to gam print grouptree and
gam <UserTypeEntity> print grouptree that display the group parent emails and names in two columns
as delimited lists rather than multiple indexed columns.
Added options downloadattempts <Integer> and retryinterval <Integer> to gam download vaultexport
that cause GAM to wait for a vault export to be completed. By default, GAM makes only one download attempt.
If multiple attempts are specified with downloadattempts <Integer>, GAM waits retryinterval <Integer> seconds
between attempts; the default retry interval is 30 seconds.
6.27.10
Added command gam <UserTypeEntity> print|show grouptree to display a user's groups and their parent groups.
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
sha256 hashes
828edce034c2f4d078db2c8094f1005fbe79e1990327ef60a31206c1913ec764 gamadv-xtd3-6.28.07-linux-arm64-glibc2.23.tar.xz
0550509bc80954a180661ce03937e12295e41bc125be96f4abde6fbd30b7b61f gamadv-xtd3-6.28.07-linux-arm64-glibc2.27.tar.xz
82a0f11909ca32ba3263db768fa15af4e24b1a338501f7123a79a00aba9454e4 gamadv-xtd3-6.28.07-linux-arm64-glibc2.31.tar.xz
abe43e6bea3bb45332a8bae050fcb18b1e76b1c12e60f63383a2dea2a8462ba7 gamadv-xtd3-6.28.07-linux-x86_64-glibc2.19.tar.xz
8ebe76420982d4f995ad653f417141fdad15a852f8662e7038640f111781b800 gamadv-xtd3-6.28.07-linux-x86_64-glibc2.23.tar.xz
558e4a7a3035d76cdab37dca601b1c230fc8b5bd5d770f52b9123457c2cc3248 gamadv-xtd3-6.28.07-linux-x86_64-glibc2.27.tar.xz
032f1ec7c9a28f53c20b5a0fa5f10e90aba6721169cb4c93506513d3dc185542 gamadv-xtd3-6.28.07-linux-x86_64-glibc2.31.tar.xz
6b45c738f555010d4d0c660097fbb7dd00fbb8ae9b78082ae7816cbae3e71eb9 gamadv-xtd3-6.28.07-linux-x86_64-glibc2.35.tar.xz
bb845ce2801f3f4a1b42b498c2190f8a843b7788ce01a994810cb819525fa085 gamadv-xtd3-6.28.07-linux-x86_64-legacy.tar.xz
4e52e8b3fa59d6b84c585770063aeb1668c315daeefae970351b6cb68f7bcc85 gamadv-xtd3-6.28.07-macos-arm64.tar.xz
536f495c12762006900c2623e50ba1773de481ebf99b7c5d05dafa9d107969bc gamadv-xtd3-6.28.07-macos-x86_64-legacy.tar
646c18f99a2e6e56110ef0c218288ea21322941dbda8b956a4cfe0fb36bcdb53 gamadv-xtd3-6.28.07-macos-x86_64.tar.xz
6007f24c8d3a4634b9966f8bf1715d03bf7e4f755088bd2e6c6e6f737a251566 gamadv-xtd3-6.28.07-windows-x86.msi
eacff89ea82b5ba360d0ada375983e5bcfbd062aa8d074ca24824f267f1255b1 gamadv-xtd3-6.28.07-windows-x86.zip
e035af3d9505a99fb902f523c01abe0a8992e68218ae95c9300e3029d2db9b55 gamadv-xtd3-6.28.07-windows-x86_64.msi
7519790ad46cdc67c3a5f12e696f18fffa560c426e77b59ee3dc0c40d7b0cb46 gamadv-xtd3-6.28.07-windows-x86_64.zip