Scroll to bottom of page for installation/downloads
Latest updates
6.28.08
Added option today to gam report to look for events on the current day. This will be most useful
with gam report <ActivityApplictionName> as gam report users|customers rarely has data for the current day.
Added option today to gam <UserTypeEntity> print|show driveactivity to look for events on the current day.
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
e51f733206433f7d66ba35a4345f55ba5b1d7d63a6b5178219ad9ca8f634212e gamadv-xtd3-6.28.08-linux-arm64-glibc2.23.tar.xz
7c805d250918c777ef027ce69f61cc29c38d876c835285515e29c4210f9f4889 gamadv-xtd3-6.28.08-linux-arm64-glibc2.27.tar.xz
001a7910c089cde00731811fe2b8ad7097e439b7e1088fe08580aed48ad0ba8f gamadv-xtd3-6.28.08-linux-arm64-glibc2.31.tar.xz
fbff20c174de7fd6fd69fcb23d17ce1a479d88a2087e319392b255b38e30da94 gamadv-xtd3-6.28.08-linux-x86_64-glibc2.19.tar.xz
29afc67c5958cc85472d80495f9c5a9578637ece9d98c6d10af540245f0beee7 gamadv-xtd3-6.28.08-linux-x86_64-glibc2.23.tar.xz
4f112e210233f22923a466185ac8a07759dc75594560be2f7d4840cac44ab60d gamadv-xtd3-6.28.08-linux-x86_64-glibc2.27.tar.xz
9e4fd33bbc55305868bddb2169fbc4078ec3f377fe490902c848d258c1da47f4 gamadv-xtd3-6.28.08-linux-x86_64-glibc2.31.tar.xz
a782d528a04d4458841f842cd593ab2538360690b30514aa331e807ae697d48b gamadv-xtd3-6.28.08-linux-x86_64-glibc2.35.tar.xz
851ea9feedefbaf8d1215b5563d3ab1c71eadf7fb52db387b8448f47db552649 gamadv-xtd3-6.28.08-linux-x86_64-legacy.tar.xz
715a1a1b23d3090e227ae2b4080603b095011b4fdc655677483716bc2e3fe60f gamadv-xtd3-6.28.08-macos-arm64.tar.xz
165c0748840af3c316a87ef022695ba188d8c0600ad244ecf25cc9a99259138e gamadv-xtd3-6.28.08-macos-x86_64-legacy.tar
e4041405e4bbe87567f41a5d266a44ae44a86f79d064240e0afd090359938319 gamadv-xtd3-6.28.08-macos-x86_64.tar.xz
06ff3e9ba2c97b47519c2d7e78158bf959c224c32841a4f1355aab7cb3f6bda5 gamadv-xtd3-6.28.08-windows-x86.msi
6bd0aaa31fccf6ef0d352abd0c58870e80227bbc5341eae6bd4b18780881b2cc gamadv-xtd3-6.28.08-windows-x86.zip
7e9e4cd1c2e05ddbb3d16f33cdce58c0ad9ef2f71a2211ff83ff183e3265a531 gamadv-xtd3-6.28.08-windows-x86_64.msi
d70cc8506c9385664053f51644c2f54f656a69820a4b3655f1ca1b6990a5a855 gamadv-xtd3-6.28.08-windows-x86_64.zip