Up to [cvs.NetBSD.org] / pkgsrc / sysutils / gam
Request diff between arbitrary revisions
Keyword substitution: kv
Default branch: MAIN
gam: update to 7.29.01
Changes since 7.19.02:
7.29.01
Added option oneitemperrow to gam <UserTypeEntity> print calendars ... permissions to have each of a calendar's permissions displayed on a separate row with all of the other calendar fields.
Updated gam yubikey reset_piv to handle YubiKey firmware updates that caused an error.
7.29.00
Added options mappermissionsemail <EmailAddress> <EmailAddress> and mappermissionsemailfile <CSVFileInput> endcsv to these commands:
gam [<UserTypeEntity>] copy shareddriveacls <SharedDriveEntity> to <SharedDriveEntity>
gam [<UserTypeEntity>] sync shareddriveacls <SharedDriveEntity> with <SharedDriveEntity>
gam <UserTypeEntity> copy drivefile <DriveFileEntity>
gam <UserTypeEntity> move drivefile <DriveFileEntity>
When mappermissionsemail <EmailAddress> <EmailAddress> is specifed, an ACL that references the first <EmailAddress> in the source will be modified to reference the second <EmailAddress> in the destination.
Bulk permission email address mapping can be specified with mappermissionsemailfile <CSVFileInput> endcsv. <CSVFileInput> must include these columns: sourceEmail and destinationEmail.
These options will be most useful with inter-workspace Shared Drive copies and moves.
7.28.13
Added option addcsvdata <FieldName> <String> to gam <UserTypeEntity> print messages that adds additional columns of data to the CSV file output.
7.28.12
Updated gam delete project to handle the following error:
ERROR: 400: failedPrecondition - Project not active
7.28.11
Removed all options/fields referencing inheritance from gam create|update|info|print org as this option/field is deprecated.
7.28.10
Added a command gam print course-counts that displays the count of the number of courses in which a teacher or student is a participant.
7.28.09
Fixed bug in gam print cigroups ... descriptionmatchpattern [not] <REMatchPattern> that caused a trap.
7.28.08
Updated gam <UserTypeEntity> print|show chatmessages to cache the sender UID to email address map so that each sender UID only has to be looked up once; this improves performance.
7.28.07
Fixed bug in gam report users ... aggregatebydate|aggregatebyuser where accounts:used_quota_in_percentage was incorrectly displayed.
7.28.06
Updated gam <UserTypeEntity> info|print|show calendars and gam calendars <CalendarEntity> print|show settings to display the new dataOwner field
7.28.04
Updated commands that display Chrome device counts to display the date in the output.
7.28.03
Improved commands to display Chrome device counts.
7.28.02
Added commands to display Chrome device counts.
7.28.01
Updated gam <UserTypeEntity> show fileinfo <DriveFileEntity> to display displayName as the key field of a permission not deleted.
7.28.00
Added option addcsvdata <FieldName> <String> to gam report [usage] customers|users that adds additional columns of data to the CSV file output. This will be most useful when reading a CSV of user information and you want to include some of the user information, e.g., orgUnitPath, in the output.
gam redirect csv ./Users.csv print users fields ou
gam redirect csv ./UserStorageInfo.csv multiprocess csv Users.csv gam report users user "~primaryEmail" parameters accounts:drive_used_quota_in_mb,accounts:gmail_used_quota_in_mb,accounts:gplus_photos_used_quota_in_mb,accounts:total_quota_in_mb,accounts:used_quota_in_mb,accounts:used_quota_in_percentage addcsvdata orgUnitPath "~orgUnitPath"
7.27.05
Added option addcsvdata <FieldName> <String> to gam print courses that adds additional columns of data to the CSV file output.
The following scope is no longer necessary: Cloud Identity API - Groups Beta (Enables group locking/unlocking) as this scope Cloud Identity API - Groups now provides group locking/unlocking.
7.27.04
Added options to gam <UserTypeEntity> create delegate that support sending email notifications when a user adds a delegate.
7.27.03
Updated gam <UserTypeEntity> create|update|sync chatmember role specification to role member|manager|owner. This is the mapping between the Chat UI and Chat API; GAM uses the Chat UI role names.
UI: Member, API: ROLE_MEMBER
UI: Manager, API: ROLE_ASSISTANT_MANAGER
UI: Owner, API: ROLE_MANAGER
Updated gam <UserTypeEntity> update chatspace options for permission settings.
[managemembersandgroups owners|managers|members]
[modifyspacedetails owners|managers|members]
[togglehistory owners|managers|members]
[useatmentionall owners|managers|members]
[manageapps owners|managers|members]
[managewebhooks owners|managers|members]
[replymessages owners|managers|members]
7.27.02
Added option clearattachments <String> to gam [<UserTypeMessage>] update chatmessage that clears all attachments from a Chat message. If <ChatContent> is not specified, the current message text is retained and <String> is appended; <String> must be specified but can be empty in which case the current message test is preserved as-is.
7.27.01
Fixed bug in gam <UserTypeEntity> claim ownership <DriveFileEntity> ... onlyUsers|skipusers <UserTypeEntity> where the email addresses in onlyUsers|skipusers <UserTypeEntity> were not normalized.
7.27.00
Added debug_redaction Boolean variable to gam.cfg. When True, the default, sensitive data like access/refresh tokens, client secret and authorization codes are redacted from debug output. This allows you to post debug output without compromising your account information. Even with debug redaction, anything shared publicly should be double-checked for sensitive content.
7.25.01
Fixed bug in gam config timezone <String> to handle timezone abbreviations correctly; they were incorrectly shifted to lowercase.
7.25.00
Removed a capabilty added in 7.24.00 that allowed reading command data from Google Docs and Sheets when a user's service account access to Drive and Sheets had been disabled. Jay was concerned that this change could be exploited to give access to all user's files.
This capability has been replaced by issuing the following commands. The admin specified in gam oauth create can read command data from Docs and Sheets to which it has access.
gam config commanddata_clientaccess true save
gam oauth create
Enable the following and proceed to authorization.
[*] 42) Drive API - commanddata_clientaccess
[*] 54) Sheets API - commanddata_clientaccess
Fixed in bug in gam report that caused a trap with either of the thismonth or previousmonths options were used.
Upgraded to Python 3.14.0.
7.24.01
Updated GAM to handle the following error that occurs when GAM tries to authenticate as a user that has been disabled by Google.
ERROR: Authentication Token Error - invalid_account: Forbidden
7.24.00
If you want to disable a user's service account access to Drive and Sheets but still allow reading command data from Google Docs and Sheets, issue the following command and make these settings:
gam user user@domain.com update serviceaccount
[ ] 20) Drive API (supports readonly)
[*] 21) Drive API - read command data
[ ] 42) Sheets API (supports readonly)
[*] 43) Sheets API - read command data
7.23.07
Fixed bug in gam print|show admins where all admin assignments were not displayed when types <AdminAssigneeTypeList> was not specified, i.e., all assignments should be displayed.
7.23.06
Added option types <AdminAssigneeTypeList> to gam print|show admins that allows filtering of admin assignments by the type of the assignee; by default, all assignee types are displayed.
<AdminAssigneeType> ::= group|user|serviceaccount|unknown
<AdminAssigneeTypeList> ::= "<AdminAssigneeType>(,<AdminAssigneeType>)*"
7.23.05
Added option recursive to gam print|show admins that will display assignments to the members of security groups assigned to roles; the security group membership is recursively expanded.
7.23.04
Added option addcsvdata <FieldName> <String> to gam <UserTypeEntity> print events and gam calendars <CalendarEntity> print events that adds additional columns of data to the CSV file output. An example would be to get the calendar name in addition to the calendar ID when printing events.
gam redirect csv ./Resources.csv print resources fields email,name
gam redirect csv ./ResourceEventCounts.csv multiprocess redirect stderr - multiprocess csv Resources.csv gam calendar "~resourceEmail" print events starttime -1y countsonly addcsvdata calendarName "~resourceName"
Upgraded to OpenSSL 3.6.0.
7.23.03
Upgraded to OpenSSL 3.5.4.
7.23.02
Added option oneitemperrow to 'gam print course-materials|course-work` to have each of a course's materials displayed on a separate row with all of the other course fields. This produces a CSV file that can be used in subsequent commands to process the materials without further script processing.
7.23.00
Added chat_max_results variable to gam.cfg.
chat_max_results
When retrieving lists of Chat items from API,
how many should be retrieved in each API call
Default: 100
Range: 1 - 1000
Previously, this vaule was always set to 1000 which could cause errors.
7.22.07
Added options showdetails and returnidonly to gam create|copy vaultquery.
Added option <JSONData> to gam create vaultexport|vaultquery and gam print vaultcounts``.
7.22.06
Added commands to create, copy and delete Vault saved queries.
gam create vaultquery <MatterItem> [name <String>]
corpus calendar|drive|gemini|groups|hangouts_chat|mail|voice
[scope all_data|held_data|unprocessed_data]
(accounts <EmailAddressEntity>) | (orgunit|org|ou <OrgUnitPath>) | everyone
(documentids (<DriveFileIDList>|(select <FileSelector>|<CSVFileSelector>))) |
(shareddrives|teamdrives (<SharedDriveIDList>|(select <FileSelector>|<CSVFileSelector>))) |
[(includeshareddrives <Boolean>)|(shareddrivesoption included|included_if_account_is_not_a_member|not_included)]
(sitesurl (<URLList>||(select <FileSelector>|<CSVFileSelector>)))
[driveversiondate <Date>|<Time>]
[includerooms <Boolean>]
(rooms (<ChatSpaceList>|(select <FileSelector>|<CSVFileSelector>))) |
[terms <String>] [start|starttime <Date>|<Time>] [end|endtime <Date>|<Time>] [timezone <TimeZone>]
[locationquery <StringList>] [peoplequery <StringList>] [minuswords <StringList>]
[responsestatuses <AttendeeStatus>(,<AttendeeStatus>)*] [calendarversiondate <Date>|<Time>]
(covereddata calllogs|textmessages|voicemails)*
[shownames] [formatjson]
gam copy vaultquery <MatterItem> <QueryItem> [targetmatter <MatterItem"] [name <String>]
[shownames] [formatjson]
gam delete vaultquery <QueryItem> matter <MatterItem>
gam delete vaultquery <MatterItem> <QueryItem>
Added a variant of gam print vaultcounts that gets its query parameters from a saved Vault query.
gam print vaultcounts [todrive <ToDriveAttributes>*]
matter <MatterItem> <QueryItem>
[wait <Integer>]
7.22.05
Added a variant of gam create vaultexport that gets its query parameters from a saved Vault query.
gam create vaultexport|export matter <MatterItem> [name <String>]
vaultquery <QueryItem>
[driveclientsideencryption any|encrypted|unencrypted]
[includeaccessinfo <Boolean>]
[excludedrafts <Boolean>] [mailclientsideencryption any|encrypted|unencrypted]
[showconfidentialmodecontent <Boolean>] [usenewexport <Boolean>] [exportlinkeddrivefiles <Boolean>]
[format ics|mbox|pst|xml]
[region any|europe|us] [showdetails|returnidonly]
7.22.04
Added a variant of gam create vaulthold that gets its parameters from a saved Vault query.
gam create vaulthold matter <MatterItem> [name <String>]
vaultquery <QueryItem>
[showdetails|returnidonly]
7.22.03
Fix backwards compatability bug introduced in 7.22.00 for gam print users that changed suspended from a field name to a query option; it is now correctly interpreted as a field name.
7.22.02
An update to the httplib2 library caused GAM proxy connections to fail; this has been fixed by including the pysocks library needed by the latest httplib2 library.
7.22.00
Expanded <UserTypeEntity> to allow specification of non-archived/archived users.
See Collections of Users
These commands have also been updated to deal with archived users:
gam print aliases
gam update groups
gam info orgs
gam print orgs
gam print users
Added datetime <DateTimeFormat> command that can be embedded in Gam batch files. The current time is formatted with <DateTimeFormat> and subsequent lines in <BatchContent> will have %datetime% replaced with the formatted time value.
7.21.03
Added option notifyrecoveryemail to gam create user and gam <UserTypeEntity> update user password <String> that sends the passsword notification email to the user's recovery email address (if defined).
7.21.02
GAM now builds on macOS 26 Tahoe and properly identifies the OS.
A custom build of the cryptography library is no longer needed for Windows arm64 builds as the project now releases their own build for the OS.
Upgrade to OpenSSL 3.5.3 latest
7.21.01
Replaced datetime, dateutil, calendar and iso8601 Python libraries with arrow library. This should have no performance impact; report any problems.
You can now use timezone names when setting timezone in gam.cfg.
gam config timezone America/Los_Angeles save
7.20.04
Cleaned up Python library imports: googleapiclient, iso8601
7.20.03
Rebranded license SKU 1010470004 from Gemini Education to Google AI Pro for Education.
Additional updates to student groups in Google Classroom.
7.20.02
Upgraded gam create course-studentgroups to allow specification of multiple student group titles; multiple student groups can be created in a single command.
((title <String>)|(select <StringEntity))+
7.20.01
Added option showaccesssettings to gam [<UserTypeEntity>] print|show chatspaces. When listing Chat Spaces, the Chat API does not return the accessSettings field; if you need to see this field, add showaccesssettings to the command. This requires an additional Chat API call per chat space of type SPACE to get the accessSettings field.
7.20.00
Added initial support for student groups in Google Classroom. This is a work in progress and requires Developer Preview membership.
7.19.03
Fixed bug where specifying a <UserItem> as id:1234567890 could lead to errors like this:
ERROR: 400: invalidArgument - Resource name has invalid email.
gam: update to 7.19.02
Changes since 7.10.07:
7.19.02
Update gam info user <UserItem> to eliminate 5 second delay when getting license info.
7.19.01
Updated gam <UserTypeEntity> print|show signature to handle the following error that occurs when an alias is specified:
ERROR: 404: notFound - Requested entity was not found.
7.19.00
Eliminated drive_v3_beta and meet_v2_beta from gam.cfg as the API betas are no longer used.
Updated Meet API scopes so that GAM can read metadata about additional Meet spaces.
[*] 34) Meet API - Manage/Display Meeting Spaces
[*] 35) Meet API - Read Meeting Spaces metadata
7.18.07
Updated gam <UserTypeEntity> print drivelastmodification to put addcsvdata columns after User,id,name rather than after the last column.
7.18.06
Updated gam <UserTypeEntity> delete|modify messages to improve the handling of the following error:
quotaExceeded - User-rate limit exceeded
7.18.05
Added support for Inbound SSO OIDC profiles.
Currently, if you enter gam select <SectionName> and nothing else on the command line, GAM performs no action. Now, it will be treated as if you entered: gam select <SectionName> save
Updated to Python 3.13.7.
7.18.04
Added commands to display/manage Alert Center Pub/Sub notifications.
See: https://github.com/GAM-team/GAM/wiki/Alert-Center#configuring-settings
7.18.03
Updated gam oauth create to give a warning if the number of selected scopes will probably cause Google to generate a "Something went wrong" error.
7.18.02
Upgraded to OpenSSL 3.5.2.
7.18.01
Added option nosystemroles to gam print|show adminroles that causes GAM to only display non-system roles.
Added option formatjson to gam info|print|show adminroles; this will be most useful when the privileges option is used.
Updated gam create|update adminrole to allow specification of privileges with JSON data: privileges <JSONData>. These two updates make it easier to copy admin roles.
Updated gam create|update adminrole to allow output of the created/updated role data in CSV format; by default, GAM displays <RoleName>(<RoleID>) created|updated.
csv [todrive <ToDriveAttribute>*] [formatjson [quotechar <Character>]] (addcsvdata <FieldName> <String>)*
7.18.00
Added commands to display Business Profile Accounts. These are special purpose commands and will not generally be used.
gam show businessprofileaccounts
gam print businessprofileaccounts [todrive <ToDriveAttribute>*]
7.17.03
Fixed bug in gam <UserItem> print|show chatspaces asadmin fields <ChatSpaceFieldNameList> that caused a trap when displayname was not in <ChatSpaceFieldNameList>.
7.17.02
Updated gam <UserTypeEntity> print|show webmastersites to handle the following error that occurs if you haven't updated your project to include the Google Search Console API:
ERROR: 403: permissionDenied - Google Search Console API has not been used in project 111055363999 before or it is disabled. Enable it by visiting https://console.developers.google.com/apis/api/searchconsole.googleapis.com/overview?project=111055363999 then retry. If you enabled this API recently, wait a few minutes for the action to propagate to our systems and retry.
7.17.01
Fixed bug in gam <UserTypeEntity> show webmastersites that caused a trap.
7.17.00
Added commands to discover Sites and WebResources that managed users (previously unmanaged) may have access to for better governance and visibility. These are special purpose commands and will not generally be used.
gam <UserTypeEntity> show webresources
gam <UserTypeEntity> print webresources [todrive <ToDriveAttribute>*]
gam <UserTypeEntity> show webmastersites
gam <UserTypeEntity> print webmastersites [todrive <ToDriveAttribute>*]
7.16.01
The Drive API now supports setting download restrictions on individual files.
Added downloadrestictions and <DriveDownloadRestrictionsSubfieldName> to <DriveFieldName>.
<DriveDownloadRestrictionsSubfieldName> ::=
downloadrestrictions.itemdownloadrestriction|
downloadrestrictions.effectivedownloadrestrictionwithcontext
Added itemdownloadrestriction (restrictedforreaders [<Boolean>]) (restrictedforwriters [<Boolean>]) to <DriveFileAttribute>.
From the Drive API documentation:
itemDownloadRestriction - The download restriction of the file applied directly by the owner or organizer. This does not take into account shared drive settings or DLP rules.
effectiveDownloadRestrictionWithContext - Output only. The effective download restriction applied to this file. This considers all restriction settings and DLP rules.
restrictedForReaders - Whether download and copy is restricted for readers.
restrictedForWriters - Whether download and copy is restricted for writers. If true, download is also restricted for readers.
7.16.00
Removed drive_v3_native_names from gam.cfg; GAM now only uses Drive API v3 fields names on output. If you had drive_v3_native_names = False in gam.cfg or are updating from Legacy GAM:
See: https://github.com/GAM-team/GAM/wiki/Drive-REST-API-v3
7.15.01
Added downloadrestrictions.restrictedforreaders and downloadrestrictions.restrictedforwriters to <SharedDriveRestrictionsSubfieldName>; previously, only the abbreviations downloadrestrictedforreaders and downloadrestrictedforwriters were supported (they are still supported).
Updated gam <UserTypeEntity> copy drivefile to handle unexpected data returned by Google that caused a trap.
7.15.00
Updated gam print shareddriveorganizers to make shownoorganizerdrives default to True as documented; it was defaulting to False.
Cleaned up code for processing Python dictionary structures; this should have no noticable effect.
7.14.04
Fixed bug in gam print|show cigroups cimember <UserItem> that generated the following error:
ERROR: Cloud Identity Group: groups/-, Print Failed: Error(4013): Insufficient permissions to retrieve memberships.
Updated gam <UserTypeEntity> update user suspended off and gam <UserTypeEntity> unsuspend users to handle the following error that occurs when trying to unsuspend a user that has been suspended for abuse:
ERROR: 412: adminCannotUnsuspend - Cannot restore a user suspended for abuse.
See: https://support.google.com/a/answer/1110339
7.14.03
Fixed bug in gam print cigroup-members includederivedmembership that caused a trap.
7.14.02
Fixed bug in gam print|show cigroups|cigroups-members cimember <UserItem> that generated the following error:
Cloud Identity Group Print Failed: Request contains an invalid argument.
7.14.01
Don't install yubikey library via pip by default. To install with yubikey support use pip install gam7[yubikey]
7.14.00
Added commands to display Google Tag Manager accounts, containers, workspaces, tags and user permissions.
See: https://github.com/GAM-team/GAM/wiki/Users-Tag-Manager
7.13.03
Added option csv [todrive <ToDriveAttribute>*] [formatjson [quotechar <Character>]]] to gam create chromeprofilecommand so that command details are displayed in CSV format.
Added option commands <ChromeProfileCommandNameList>|<FileSelector>|<CSVFileSelector> to <ChromeProfileNameEntity> so that gam print|show chromeprofilecommands can directly display the commands generated by gam create chromeprofilecommand with the csv option.
7.13.02
Fixed bug in gam create chromeprofilecommand where select|filter were not recognized.
Updated gam create datatransfer <OldOwnerID> datastudio <NewOwnerID> that generated the following error due to an unhandled API change:
ERROR: Invalid choice (google data studio): Expected <calendar|looker studio|drive and docs>
7.13.01
Enhanced gam create|print|show chromeprofilecommand to allow specification of multiple Chrome browser profiles rather than just one.
<ChromeProfilePermanentID> ::= <String>
<ChromeProfileName> ::= customers/<CustomerID>/profiles/<ChromeProfilePermanentID> | <ChromeProfilePermanentID>
<ChromeProfileNameList> ::= "<ChromeProfileName>(,<ChromeProfileName>)*"
<ChromeProfileNameEntity> ::=
<ChromeProfileNameEntity> ::=
<ChromeProfileNameList> |
(select <FileSelector>|<CSVFileSelector>) |
(filter <String> (filtertime<String> <Time>)* [orderby <ChromeProfileOrderByFieldName> [ascending|descending]])
gam create|print_show chromeprofilecommand <ChromeProfileNameEntity>
7.13.00
Added commands that send remote commands to Chrome browser profiles and display the results; at the moment, these commands can clear the browser cache and cookies.
See: https://github.com/GAM-team/GAM/wiki/Chrome-Profile-Management#create-a-chrome-profile-command
7.12.02
Updated gam print users to handle the following error:
ERROR: 503: serviceNotAvailable - The service is currently unavailable
7.12.01
Added support for plan free in gam create resoldsubscription.
The free plan is exclusive to the Cloud Identity SKU and does not incur any billing.
7.12.00
Started updated handling of missing scopes messages in client access commands; this is a work in progress.
Updated gam info|show shareddrive to handle changes in the Drive API that caused traps.
Added downloadrestrictedforreaders and downloadrestrictedforwriters to <SharedDriveRestrictionsSubfieldName> to support new Shared Drive restrictions.
Updated gam course <CourseID> create|update announcement to accept input from a literal string, a file or a Google Doc.
<CourseAnnouncementContent> ::=
((text <String>)|
(textfile <FileName> [charset <Charset>])|
(gdoc <UserGoogleDoc>)|
(gcsdoc <StorageBucketObjectName>))
Added command gam check suspended <UserItem> that checks the suspension status of a user and sets the return code to 0 if the user is not suspended or 26 if it is.
$ gam check suspended testok@domain.com
User: testok@domain.com, Account Suspended: False
$ echo $?
0
$ gam check suspended testsusp@domain.com
User: testsusp@domain.com, Account Suspended: True, Suspension Reason: ADMIN
$ echo $?
26
Updated gam <UserTypeEntity> sendemail to verify that one of recipient|to|from immediately follows sendemail.
7.11.00
Added commands to manage classroom/course announcements.
See: https://github.com/GAM-team/GAM/wiki/Classroom-Courses#manage-course-announcements
Upgraded to OpenSSL 3.5.1.
7.10.10
Added choices text and hyperlink to option showwebviewlink in gam [<UserTypeEntity>] print|show shareddrives.
showwebviewlink text - Displays https://drive.google.com/drive/folders/<SharedDriveID>
showwebviewlink hyperlink - Displays =HYPERLINK("https://drive.google.com/drive/folders/<SharedDriveID>", "<SharedDriveName>")
7.10.09
Added option showwebviewlink to gam [<UserTypeEntity>] print|show shareddrives that displays the web view link for the Shared Drive: https://drive.google.com/drive/folders/<SharedDriveID>.
7.10.08
Fixed bug in commands that modify messages where the labelids <LabelIdList> option could not be used unless one of these options was also specified: query, matchlabel, ids; it can be now be used by itself.
gam: adapt for setuptools 78 Bump PKGREVISION.
gam: update to 7.05.08
Changes since 7.02.00:
7.05.08
Added error message to gam report commands to indicate forbidden access;
previously, no error message was displayed.
7.05.07
Fixed bug in gam calendars <CalendarEntity> info events and gam <UserTypeEntity> info events where option showdayofweek was not recognized.
7.05.06
Improve message displayed when a command is issued that requires Google Chat Bot setup; display a link to the Wiki Set up a Chat Bot instructions.
7.05.05
Added options password prompt and password uniqueprompt to gam create user <EmailAddress> and gam update users <UserTypeEntity> that prompt you to enter a password from stdin.
See User Passwords
7.05.04
Updated gam calendars <CalendarEntity> update events and gam <UserTypeEntity> update events to handle the following error:
ERROR 400: malformedWorkingLocationEvent - A working location event must have a visibility setting of public.
7.05.03
Fixed bug in gam all users print users issuspended false allfields that caused a trap.
7.05.02
Chat usage reports are now available. Added chat to <CustomerServiceName> and <UserServiceName> for use in gam report customer|user.
https://workspaceupdates.googleblog.com/2025/02/chat-usage-analytics-updates.html
7.05.01
Updated from v1beta1 to v1 for Cloud Identity - Policy.
See: https://workspaceupdates.googleblog.com/2025/02/policy-api-general-availability.html
7.05.00
Enabled support for Limited Access as described here:
https://workspaceupdates.googleblog.com/2025/02/updating-access-experience-in-google-drive.html
Added option inheritedpermissionsdisabled [<Boolean>] to <DriveFileAttribute>; this attribute can be set on folders.
Added inheritedpermissionsdisabled to <DriveFieldName>.
Added capabilities.candisableinheritedpermissions and capabilities.canenableinheritedpermissions to <DriveCapabilitiesSubfieldName>. Added option enforceexpansiveaccess [<Boolean>] to all commands that delete or update drive file ACLs/permissions.
7.04.05
Added initial support for Meet API v2beta; you must be in the Developer Preview program for this to be effective.
https://developers.google.com/meet/api/guides/beta/configuration-beta#auto-artifacts
Added meet_v2_beta Boolean variable to gam.cfg.
7.04.04
Updated gam print group-members|cigroup-members to include the email column when fields <MembersFieldNameList> did not include email.
7.04.03
Added option minimal|basic|full to gam print cigroup-members
Added option minimal|basic|full to gam show cigroup-members
Upgraded gam print cigroup-members ... recursive to display sub-group email addresses rather than IDs.
7.04.02
Improved output formatting for the following commands:
gam info peoplecontact
gam show peoplecontacts
gam info peopleprofile
gam show peopleprofile
gam <UserTypeEntity> info contacts
gam <UserTypeEntity> show contacts
gam <UserTypeEntity> show peopleprofile
7.04.01
Fixed bug where multiple querytime<String> values in a query were not properly processed; only the last querytime<String> was processed.
7.04.00
The Classic Sites API no longer functions, the following commands are deprecated:
gam [<UserTypeEntity>] create site
gam [<UserTypeEntity>] update site
gam [<UserTypeEntity>] info site
gam [<UserTypeEntity>] print sites
gam [<UserTypeEntity>] show sites
gam [<UserTypeEntity>] create siteacls
gam [<UserTypeEntity>] update siteacls
gam [<UserTypeEntity>] delete siteacls
gam [<UserTypeEntity>] info siteacls
gam [<UserTypeEntity>] show siteacls
gam [<UserTypeEntity>] print siteacls
gam [<UserTypeEntity>] print siteactivity
7.03.09
Added option maxmessagesperthread <Number> to gam <UserTypeEntity> print|show threads that limits the number of messages displayed per thread. The default is 0, there is no limit. For example, this can be used if you only want to see the first message of each thread.
gam user user@domain.com print|show threads maxmessagesperthread 1
Fixed bug in gam <UserTypeEntity> print filelist countsonly where extraneous columns were displayed.
Fixed bug in gam <UserTypeEntity> print filelist countsonly showsize where sizes were all shown as 0 unlesssizefield size was specified.
7.03.08
Improved pip install.
Yubikey as optional should now be working also.
7.03.07
Updated gam create vaultexport to include corpus gemini.
See: https://workspaceupdates.googleblog.com/2025/02/google-vault-now-supports-gemini.html
7.03.06
Added option rawfields "<BrowserFieldNameList>" to gam info|print|show browsers that allows specification of complex field lists with selected subfields.
See: https://github.com/GAM-team/GAM/wiki/Chrome-Browser-Cloud-Management#raw-fields
7.03.05
GAM can now be installed by pip: pip install --upgrade gam7
7.03.04
Added option security to gam create cigroup that allows creation of a security group in a single command.
Updated to Python 3.13.2.
7.03.03
Fixed bug in gam update resoldcustomer that caused the following error:
ERROR: Got an unexpected keyword argument customerAuthToken
7.03.02
Updated gam <UserTypeEntity> show labels nested to properly display label nesting when labels have embedded / characters in their names.
7.03.01
Updated gam create project to retry the following unexpected error:
ERROR: 400 - invalidArgument - Service account gam-project-a1b2c@gam-project-a1b2c.iam.gserviceaccount.com does not exist.
7.03.00
Updated gam create|use project to discontinue use of the Identity-Aware Proxy (IAP) OAuth Admin APIs that are being deprecated by Google. You will see a set of instructions detailing how to configure the Oauth Consent screen and create the Oauth client.
Added options copypermissionroles <DriveFileACLRoleList> and copypermissiontypes <DriveFileACLTypeList> to gam <UserTypeEntity> copy drivefile that provide more control over what permissions are copied from the source files/folders to the destination files/folders.
7.02.11
Updated gam report <ActivityApplicationName> to display id:<actor.profileId> in the emailAddress column when actor.email is empty. This typically occurs when the actor is not in your workspace.
Updated gam <UserTypeEntity> copy drivefile to ignore ACLs referencing deleted user/groups.
7.02.10
Added option bydate to gam report <ActivityApplicationName> ... countsonly that provides an additional display option.
7.02.09
Added option clearresources to <EventUpdateAttribute> for use in gam <UserTypeEntity> update events that allows clearing all resources from a user's calendar events. For example, to clear all resources from a user's future events:
gam user user@domain.com update events primary matchfield attendeespattern @resource.calendar.google.com after now clearresources
Added option resource <ResourceID> to <EventAttribute> for use in gam <UserTypeEntity> create|update events that adds a resource to an event.
Added option removeresource <ResourceID> to <EventUpdateAttribute> for use in gam <UserTypeEntity> update events that removes a resource from an event.
7.02.08
Fixed bug in gam print|show chromepolicies that caused a trap when neither ou|orgunit <OrgUnitItem> nor group <GroupItem> was specified.
7.02.07
Updated gam delete|update chromepolicy to display the <AppID> or <PrinterID> (if specified) in the command status messages.
7.02.06
Added option <JSONData> to gam <UserTypeEntity> create|update form that allows for creation/modification of all fields in a form. <JSONData> is a list of form update requests.
See: https://developers.google.com/forms/api/reference/rest/v1/forms/batchUpdate
7.02.05
Updated gam [<UserTypeEntity>] show shareddriveacls ... formatjson to not display this line which interferes with the JSON output.
User: user@domain.com, Show N Shared Drives
7.02.04
Updated code to eliminate trap caused by bug introduced in 7.02.00 that occurs when an invalid domain or OU is specified.
7.02.03
Added option archive to gam <UserTypeEntity> update license <NewSKUID> from <OldSKUID> that causes GAM to archive <UserTypeEntity> after updating their license to <NewSKUID>. This will be used when you want to archive a user with a non-archivable license. The <NewSKUID> license is assigned to the user and it then converts to the equivalent Archived User license when the user is archived.
7.02.02
Updated gam <UserTypeEntity> archive messages <GroupItem> to retry the following unexpected error that occurs after many messages have been successfully archived. ERROR: 404: notFound - Unable to lookup group
7.02.01
Added options locked and unlocked to gam update cigroups that allow locking/unlocking groups.
gam: simplify package by using more of the Python infrastructure adapt wheel name for latest setuptools and depend on it Bump PKGREVISION.
gam: update to 7.00.39 This package was previously Jay Lee's Legacy GAM. GAM 7 is a merge-back of Ross Scrogg's GAMADV-XTD3 branch which is a rewrite/extension of Legacy GAM so that is only one project going forward. As such, it is not possible to provide a clear list of changes from the final version of Legacy GAM. https://github.com/GAM-team/GAM/wiki/GamUpdates
gam: fix and document locations of authorisation files By default gam creates and stores authorisation files in its installation directory which is not suitable for pkgsrc (site-packages). Move authorisation files to PKG_SYSCONFDIR and document the new location.
gam: update to 6.58
Fix COMMENT
Allow certificates to be validated as needed for authorisation workflow
Changes since 6.25:
GAM 6.58
workaround #1625 where Google is not handling max page size for print licenses correctly.
other minor fixes and improvements.
GAM 6.57
"certain Enterprise SKUs" can assign a delegated admin role to a group. gam create admin helpdesk-team@acme.com _HELP_DESK_ADMIN_ROLE customer
Fix Linux -legacy builds were missing.
gam version extended now includes version information for dependency Python libraries.
GAM 6.56
Improved support for running GAM on Google Compute Engine and other Workload Identity Federation setups.
GAM now requires Python 3.8 or newer, 3.7 is deprecated.
various fixes and improvements by Jay and Ross
GAM 6.53
afce21a: Add steps to trust GAM client_ID (Jay Lee)
27461b0: Update var.py (Jay Lee)
bd0bb15: AppSheet licenses (Jay Lee)
GAM 6.52
Ross: fix crash on gam create project
GAM 6.51
Upgrade OpenSSL to 3.1.0 release and completely disable insecure TLS 1.0 / 1.1 protocols.
When rotating service account keys you can now set key expiration time with validity_hours <number>
Ross: Improvements to Yubikey Service Account setup and usage.
Ross: gam version checkrc command will exit with a non-zero status if there is a newer version of GAM available.
GAM 6.50
Run GAM securely on Google Compute Engine (GCP) VMs with no service account private key that can be stolen.
GAM 6.42
Allow/block content managers ability to share folders on shared drives: gam user <email> update shareddrive <id> sharingFoldersRequiresOrganizerPermission true|false. Note that Google is still rolling this feature out and the GAM command won't actually work until rollout is complete.
GAM 6.41
fixed #1600 unable to create new projects
GAM 6.40
gam copy vaultexport and gam copy storagebucket commands to copy Google Vault and Organization Takeout data to your own GCS bucket.
Ross: gam print chromeaues command to see when your Chrome OS devices will reach auto-update expiration and gam print chromeneedsattn command to see devices that require attention.
Upgrade to latest OpenSSL 3.0.8 and Python 3.11.2
The usual bug fixes and improvements by Ross and Jay.
GAM 6.31
NEW: manage Inbound SSO profiles, credentials and assignments with GAM.
NEW: set the display name of a user. Display name overrides the first/last name displayed to other users. gam create|update user <email> displayname "Dave Smith"
The usual fixes by Ross and Jay
GAM 6.30
Upgrade to OpenSSL 3.0.7 to fix a high risk vulnerability (low chance of impact to GAM)
Upgrade to Python 3.11.0 which offers performance improvements
Fix: GAM was ignoring nobrowser.txt and trying to open a browser on WSL which caused a hang. #1516
gam info domain can now be run as a delegated admin assuming proper role.
The usual bug fixes and improvements by Ross and Jay
gam: Add GAM 6.24 GAM is a command line tool for Google Workspace admins to manage domain and user settings quickly and easily.