Scroll to bottom of page for installation/downloads
Latest updates
6.28.09
Updated `gam print filelist "query:mimeType='application/vnd.google-apps.folder'" to prevent the
following error.
ERROR: Invalid choice (query:mimetype='application/vnd): Expected <capabilities|contentrestrictions|labelinfo|labels|lastmodifyinguser|owners|parents|permissions|sharinguser|shortcutdetails|trashinguser>
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
0c9fc88f21bbc55475292631f0ead3fca46ff50d444737be7ee9757b0a8ff5e6 gamadv-xtd3-6.28.09-linux-arm64-glibc2.23.tar.xz
f0bb0552af31c35a03d73e1237952416473a50a02b10e2f92bc89fed23823e1f gamadv-xtd3-6.28.09-linux-arm64-glibc2.27.tar.xz
45a577b10e2b9264f8ad68c1901c12d5b67fdd357ed54b13300efcd43c1bfa79 gamadv-xtd3-6.28.09-linux-arm64-glibc2.31.tar.xz
8852d3e956d29ac67ba6a6868ade3cf44039b906ffa5238e4b3cde1c56370928 gamadv-xtd3-6.28.09-linux-x86_64-glibc2.19.tar.xz
0c85495c513429ba9b94b14600648b0033635225951eb9d728d6be775ae64646 gamadv-xtd3-6.28.09-linux-x86_64-glibc2.23.tar.xz
c5c96cd24942818088c406bfb6a217e3b9585f3748fb9eca63b33a6daf0a4f2f gamadv-xtd3-6.28.09-linux-x86_64-glibc2.27.tar.xz
56b84b0296fcfb4c1e95bf34067606e5a5c511bc97d6310c89af25ece38cf0ce gamadv-xtd3-6.28.09-linux-x86_64-glibc2.31.tar.xz
7f010e8dabfd286b62398b41a0b8ddf1eaa564cbb23d33475963667f9b66a82b gamadv-xtd3-6.28.09-linux-x86_64-glibc2.35.tar.xz
994c333e0bfe1fee3974a4157df12579adefad26162cd727e0c5c4221e56153b gamadv-xtd3-6.28.09-linux-x86_64-legacy.tar.xz
3a6739e2b4f328a65458d777bc2790bde3cf7afc03118d19604d2e200d19d3ea gamadv-xtd3-6.28.09-macos-arm64.tar.xz
83d1bafb72b3201ccdf858efde1345c80572dc43e8cc6934e1390772e0b0c8b8 gamadv-xtd3-6.28.09-macos-x86_64-legacy.tar
f487e8f63d2e9b34f451271d0d2e34dbc04589a25499a34a8c32c178255758d3 gamadv-xtd3-6.28.09-macos-x86_64.tar.xz
0975d548b5dd434be8609562a3bd2056cca9c4c49b1b220cc2bb284d8259f5c1 gamadv-xtd3-6.28.09-windows-x86.msi
115a63ac9e3de4b5b59da12c41bc9922ae57670a33aaad86af695cacdb356076 gamadv-xtd3-6.28.09-windows-x86.zip
4700abb06058258987fc51e1ea46508381128782a17da4c7c580a92bbdb67755 gamadv-xtd3-6.28.09-windows-x86_64.msi
960ff22d4f96d4abdc87a6fb7cf66f7b223eb75a8ebbcf0da094505f33902fa0 gamadv-xtd3-6.28.09-windows-x86_64.zip