Scroll to bottom of page for installation/downloads
Latest updates
6.42.03
Updated gam <UserTypeEntity> get drivefile <DriveFileEntity> ... csvsheet <SheetEntity>
to allow
selection of the output format with format <FileFormat>
. Previously, csv
was always selected and
it is still the default. Valid formats are: csv,tsv,ods,pdf,xlsx
.
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
9742523b028bfd06dc5411094a17adcf6085c435c3a17815e1991eb85989bbf2 gamadv-xtd3-6.42.03-linux-arm64-glibc2.23.tar.xz
02924eb7e97bef0151fc4af94d78a1722123d59498ca2ab5905e744d0416ce57 gamadv-xtd3-6.42.03-linux-arm64-glibc2.27.tar.xz
db56971b50a902fc1577526741ff17d75da68c11bd2f3f1ebd4624620a983870 gamadv-xtd3-6.42.03-linux-arm64-glibc2.31.tar.xz
cdfac299969a186ff7d090216aa77f538ac7b4760f050b78d28ed5fa8d03e43e gamadv-xtd3-6.42.03-linux-x86_64-glibc2.19.tar.xz
7ff5a470d8d7f30b97e965320ef7c8dfbf0d1d43cef70623501a4e192a747060 gamadv-xtd3-6.42.03-linux-x86_64-glibc2.23.tar.xz
0ac5f519f1e4bdb0d9a6d39de0560a0a8ae45992de44fcf5b3adbbd6dec193d8 gamadv-xtd3-6.42.03-linux-x86_64-glibc2.27.tar.xz
65f2f5194c014f6ee99d9d74c57ff8de7378b2aee67c3f2f4b393996feff9a23 gamadv-xtd3-6.42.03-linux-x86_64-glibc2.31.tar.xz
be701a437576a13e926dff0d0309aa7899edc50f29064af367b601d92b7eb1fb gamadv-xtd3-6.42.03-linux-x86_64-glibc2.35.tar.xz
d90192ae6028085aca786ffe7a10d5c493b66bbfca815444ba51cc127cf5cf79 gamadv-xtd3-6.42.03-linux-x86_64-legacy.tar.xz
e0b75e224f3340bdd4862f02fb3f0776aeb366cce5afd222715a9b876df51449 gamadv-xtd3-6.42.03-macos-arm64.tar.xz
abea2775c615f957724ef65d932add8efce098b93a51a80c426f6fbbca8898d1 gamadv-xtd3-6.42.03-macos-x86_64-legacy.tar
c3df80b50855bf1540b01c23ef7ebb4f7fc3c50eadd6760804cda588772085a8 gamadv-xtd3-6.42.03-macos-x86_64.tar.xz
290070d4b1aaff733e01900be358a5bb5f57921a5eb45528e9a54de8fa0cc07d gamadv-xtd3-6.42.03-windows-x86.msi
fe5f18b84c41120fbb10e312f5c21108aafeefe196f2a2ac50bce5248f4385bf gamadv-xtd3-6.42.03-windows-x86.zip
bd2a970a8567e4f82fa50dae7284ae0a7a6b17939f2f9b7a34b40f94a103e92e gamadv-xtd3-6.42.03-windows-x86_64.msi
af7d7b96b35aaeddf8c5cee5b89a02800d9e874f4009ea4aae29a8b952c4f13f gamadv-xtd3-6.42.03-windows-x86_64.zip