Scroll to bottom of page for installation/downloads
Latest updates
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
291e4a81dbeace97b56cf1cba00b70b347f9402e44abfebf68262967f90b4b01 gamadv-xtd3-6.42.01-linux-arm64-glibc2.23.tar.xz
3a373fd4a2de59fbe8aea34a22b5e26f478a5d14fdb5cab20130b5e56d11143b gamadv-xtd3-6.42.01-linux-arm64-glibc2.27.tar.xz
a054420dc8f74da125bcc5e8e955288c22cbe29787d58b4c3304796d2a24f87c gamadv-xtd3-6.42.01-linux-arm64-glibc2.31.tar.xz
bcc967c00a867e1d0d08ba9ea4a4b883c56732a6a890de575a5783c637bb95f0 gamadv-xtd3-6.42.01-linux-x86_64-glibc2.19.tar.xz
bdd860ef791fd843a21af408c4bcb4de7299b4afd9613b5289b2086519fb2f27 gamadv-xtd3-6.42.01-linux-x86_64-glibc2.23.tar.xz
c43509e6a99c4c299764553844bc9f7103413651b06427bf07ef97160356a47f gamadv-xtd3-6.42.01-linux-x86_64-glibc2.27.tar.xz
99ae3ed2aa2552f70ce3d624aa721cd767d483c74afbbde6b4cb78eb4f12fc11 gamadv-xtd3-6.42.01-linux-x86_64-glibc2.31.tar.xz
4c8681fd709e7f65118e5c8d15e46acbba1ab3eb03c30c4523ace3728a0c2330 gamadv-xtd3-6.42.01-linux-x86_64-glibc2.35.tar.xz
42fe1a81a57746a7995882f9dfe6c9fd454e76dfc7db6cd5c5301778c9d21e15 gamadv-xtd3-6.42.01-linux-x86_64-legacy.tar.xz
99442382d91b365e03791d93137b541598607c9248e78a95afbe9d4aa678b71e gamadv-xtd3-6.42.01-macos-arm64.tar.xz
557568ca3809e8a1c1c89fff89af188408ddb2f3039767f866e0792d5990af6a gamadv-xtd3-6.42.01-macos-x86_64-legacy.tar
7b04ce4df81a5841ee8ffc17a4f6e0c74fdcbff6c859454432ed8e05d931df7e gamadv-xtd3-6.42.01-macos-x86_64.tar.xz
1dafbb3826d6e2cb262ae32d0506caa3329a7aa0c076431ec635899ce2fff76a gamadv-xtd3-6.42.01-windows-x86.msi
3fec5c1daed9c702c5f04107b30ce99b45a0c8a0be824a14d24422018cfaad8f gamadv-xtd3-6.42.01-windows-x86.zip
152fdc04567eb8b973248ccdc31ddaa31f264d5901b6fdccbe9adb33ce24443c gamadv-xtd3-6.42.01-windows-x86_64.msi
b2fb16844b5fcbba0f09a84c9a4ee101898d8a84eae6952e6c27b80e6348f529 gamadv-xtd3-6.42.01-windows-x86_64.zip