Scroll to bottom of page for installation/downloads
Latest updates
6.42.02
Added sha1checksum and sha256checksum to <DriveFieldName>.
The SHA1/SHA256 checksum associated with a file, if available.
This field is only populated for files with content stored in Google Drive;
it isn't populated for Docs Editors or shortcut files.
Added option addcsvdata <FieldName> <String> to gam <UserTypeEntity> print filelist and
gam print ownership. This adds additional columns of data to the CSV file output.
Get a list of a user's shortcuts
gam redirect csv ./TSShortcuts.csv user user@domain.com print filelist fields id,name,parents,shortcutdetails showmimetype gshortcut
Headers
Owner,id,name,parents,parents.0.id,parents.0.isRoot,shortcutDetails.targetId,shortcutDetails.targetMimeType
For each shortcut, get the target file information; add the shortcut id, name and parent to the output
gam redirect csv ./TSShortcutFiles.csv multiprocess csv ./TSShortcuts.csv gam user user@domain.com print filelist select "~shortcutDetails.targetId" norecursion showownedby any
fields id,name,mimetype,parents,owners.emailaddress addcsvdata shortcut.id "~id" addcsvdata shortcut.name "~name" addcsvdata shortcut.parents "~parents.0.id"
Headers
Owner,id,name,mimeType,owners,owners.0.emailAddress,parents,parents.0.id,parents.0.isRoot,shortcut.id,shortcut.name,shortcut.parents
6.42.01
Updated processing of option matchlabel <LabelName> to replace the following characters with a -
so that the query generated will work correctly. Previously, only (space) and / were replaced.
&()"|{}/
6.42.00
Following Jay's lead, added commands commands to copy Google Vault and Organization Takeout data to your own GCS bucket.
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/Vault-Takeout#copy-vault-exports
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/Vault-Takeout#copy-a-takeout-bucket
Updated gam <UserTypeEntity> create contact to treat the following options as errors;
previously, they were silently ignored.
addcontactgroup <ContactGroupItem>
removecontactgroup <ContactGroupItem>
Updated version number to align with Standard GAM.
6.32.05
Fixed bug in gam show chromepolicies that caused a trap.
Following Jay's lead, added sharingfoldersrequiresorganizerpermission to <SharedDriveRestrictionsFieldName> and
<SharedDriveRestrictionsSubfieldName>.
6.32.04
Fixed bug in gam <UserTypeEntity> move drivefile <DriveFileEntity> where the following
error was not retried when sendemailifrequired was specified.
User: user@domain.com, Drive Folder: Test, Permission: noninherited/writer/user/user@external.com, Copy Failed: You are trying to invite user@external.com. Since there is no Google account
associated with this email address, you must check the "Notify people" box to invite this recipient.
6.32.03
Following Jay's lead, updated gam create project to handle the following error:
ERROR: 403: Permission 'resourcemanager.projects.get' denied on resource
6.32.02
Added support for gender subfields in gam <UserTypeEntity> signature and
gam <UserTypeEntity> create|update sendas option replace <Tag> <UserReplacement>.
<GenderSubfieldName> ::=
addressmeas|
customgender|
type
<UserReplacementFieldSubfield> ::=
...
gender.<GenderSubfieldName>|
...
6.32.01
Extended csv_input_row_filter, csv_input_row_drop_filter, csv_output_row_filter and csv_output_row_drop_filter
to allow specification of filters based on text comparisons.
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/CSV-Input-Filtering
- See: https://github.com/taers232c/GAMADV-XTD3/wiki/CSV-Output-Filtering
6.32.00
Added option oneitemperrow to gam <UserTypeEntity> print filelist to have each of a
files permissions displayed on a separate row with all of the other file fields. This produces
a CSV file that can be used in subsequent commands without further script processing.
Added option pmfilter to gam <UserTypeEntity> print filelist that is used in conjunction
with permission matching. By default, permission matching simply selects which files to display,
all ACLS are displayed. With pmfilter, only the ACLs that match are displayed.
6.31.09
Updated gam gam <UserTypeEntity> create label <String>, gam <UserTypeEntity> create labellist <LabelNameEntity>
and gam <UserTypeEntity> update labelsettings <LabelName> to expand the choices for label colors.
<ColorHex> ::= "#<Hex><Hex><Hex><Hex><Hex><Hex>"
<LabelColorHex> ::=
#000000|#076239|#0b804b|#149e60|#16a766|#1a764d|#1c4587|#285bac|
#2a9c68|#3c78d8|#3dc789|#41236d|#434343|#43d692|#44b984|#4a86e8|
#653e9b|#666666|#68dfa9|#6d9eeb|#822111|#83334c|#89d3b2|#8e63ce|
#999999|#a0eac9|#a46a21|#a479e2|#a4c2f4|#aa8831|#ac2b16|#b65775|
#b694e8|#b9e4d0|#c6f3de|#c9daf8|#cc3a21|#cccccc|#cf8933|#d0bcf1|
#d5ae49|#e07798|#e4d7f5|#e66550|#eaa041|#efa093|#efefef|#f2c960|
#f3f3f3|#f691b3|#f6c5be|#f7a7c0|#fad165|#fb4c2f|#fbc8d9|#fcda83|
#fcdee8|#fce8b3|#fef1d1|#ffad47|#ffbc6b|#ffd6a2|#ffe6c7|#ffffff
<LabelBackgroundColorHex> ::=
#16a765|#2da2bb|#42d692|#4986e7|#98d7e4|#a2dcc1|
#b3efd3|#b6cff5|#b99aff|#c2c2c2|#cca6ac|#e3d7ff|
#e7e7e7|#ebdbde|#f2b2a8|#f691b2|#fb4c2f|#fbd3e0|
#fbe983|#fdedc1|#ff7537|#ffad46|#ffc8af|#ffdeb5
<LabelTextColorHex> ::=
#04502e|#094228|#0b4f30|#0d3472|#0d3b44|#3d188e|
#464646|#594c05|#662e37|#684e07|#711a36|#7a2e0b|
#7a4706|#8a1c0a|#994a64|#ffffff
backgroundcolor "<LabelColorHex>|<LabelBackgroundColorHex>|custom:<ColorHex>"
textcolor "<LabelColorHex>|<LabelTextColorHex>|custom:<ColorHex>"
6.31.08
Updated csv_output_header_force variable in gam.cfg that is a list of <Strings>
to be the exact list of headers to be included in the CSV file written by a gam print command.
This might be used when the CSV file data is to be uploaded into a database
and some headers may not be present in the output but must be included for the upload to work.
6.31.07
Added csv_output_header_force variable to gam.cfg that is a list of <Strings>
that are forced for inclusion in the CSV file written by a gam print command.
This might be used when the CSV file data is to be uploaded into a database
and some headers may not be present in the output but must be included for the upload to work.
6.31.06
Added support for new ChromeOS device fields:
<CrOSFieldName> ::=
deprovisionreason|
firstenrollmenttime|
lastdeprovisiontimestamp|
6.31.05
Google can return an error Internal error on API calls; by default, GAM retries these API calls an additional 9 times
for a total of 10 tries. In some cases, determined by experience, the additional retries are unlikely to succeed and
GAM performs 1 additional retry rather than 9 for a total of 2 tries.
Added bail_on_internal_error_tries variable to gam.cfg that is used by GAM to control
the total number of tries for these API calls; Google seems to be sending this error when it is very busy.
The default value is 2 and values from 1 to 10 are allowed.
This is a rare event, this is an experiment to see if retrying these errors more times leads to success.
6.31.04
Added commands to display Chrome Devices Needing Attention counts.
gam print chromeneedsattn [todrive <ToDriveAttribute>*]
[(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
(ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
[formatjson [quotechar <Character>]]
gam show chromeneedsattn
[(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
(ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
[formatjson]
6.31.03
Added commands to display Chrome Auto Update Expiration counts.
gam print chromeaues [todrive <ToDriveAttribute>*]
[(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
(ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
[minauedate <Date>] [maxauedate <Date>]
[formatjson [quotechar <Character>]]
gam show chromeaues
[(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
(ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
[minauedate <Date>] [maxauedate <Date>]
[formatjson]
6.31.02
Updated gam <UserTypeEntity> vacation to process (replace <Tag> <String>)* in the subject.
6.31.01
Added option nofile to gam <UserTypeEntity> get photo|profilephoto that causes GAM to suppress
writing the photo data to a file. This would typicically be used when you are capturing the photo data
written to stdout.
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.
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
9a023ee491a34c841128f9c5becb1ae4d5911a92946585c28d40be72ccf7a392 gamadv-xtd3-6.42.02-linux-arm64-glibc2.23.tar.xz
c03244770318b3876a7ca44c4a35f3b4d6f94e1b3549b742cd0d0098d020514f gamadv-xtd3-6.42.02-linux-arm64-glibc2.27.tar.xz
dc1a8326c68614d55d502426a263460a162bcd06325582f0c1cff7e7d621d029 gamadv-xtd3-6.42.02-linux-arm64-glibc2.31.tar.xz
13be219be1efdf92f912f4132bad39deaeada9959dc21b289b97ed374ffb7895 gamadv-xtd3-6.42.02-linux-x86_64-glibc2.19.tar.xz
05bc1aafe7e38e70c26324906611fa4413ae8595c478ef1e8121c87e5de7bf0b gamadv-xtd3-6.42.02-linux-x86_64-glibc2.23.tar.xz
af6461335ffa6063bf0bfb196eed0d9d3830db7fcfa30c10f6a78c5cc58646ab gamadv-xtd3-6.42.02-linux-x86_64-glibc2.27.tar.xz
43110eed9693a9ad037e79795472eda67e09abc1b0661edb052d24a8c5772406 gamadv-xtd3-6.42.02-linux-x86_64-glibc2.31.tar.xz
22e8956af3977d0e9ac4f92ee9ddd685764974fbd7a349edafdb1e264762e415 gamadv-xtd3-6.42.02-linux-x86_64-glibc2.35.tar.xz
13ffed101beea52ac1489dd76ac4a4f72e211bb651fb90af8d39023f4e29d5e9 gamadv-xtd3-6.42.02-linux-x86_64-legacy.tar.xz
e325a1759df341737cd0cfd57b8f005698f2e098a8ae4f94029798c0709700e0 gamadv-xtd3-6.42.02-macos-arm64.tar.xz
f18d9a92bae0d381d9e82b395b9b86ac4b7aa68f99bec3c546483beff1162519 gamadv-xtd3-6.42.02-macos-x86_64-legacy.tar
c699d210ad49bd573ebdfc742c853535233194a959a8d927305227d638eb9b44 gamadv-xtd3-6.42.02-macos-x86_64.tar.xz
a5b1fef92bd028678ab99087b9228e83d0925715e8a1835434f7dd4b7d2da843 gamadv-xtd3-6.42.02-windows-x86.msi
ea6bb4391e7d19e789bf3be7a71c82f57f3068c2ec37ba489db9eba67d53cc86 gamadv-xtd3-6.42.02-windows-x86.zip
2175cecd318c36ccffea36cf6bd128c01b90881ee1dc6e70564f588d1b0bc2f4 gamadv-xtd3-6.42.02-windows-x86_64.msi
0f212f007b706eb71fb65aacc2e829b1abf5e54f8499eb6ba75e356c1557fe02 gamadv-xtd3-6.42.02-windows-x86_64.zip