The NetBSD Project

CVS log for pkgsrc/sysutils/gam/Makefile

[BACK] Up to [cvs.NetBSD.org] / pkgsrc / sysutils / gam

Request diff between arbitrary revisions


Keyword substitution: kv
Default branch: MAIN


Revision 1.28: download - view: text, markup, annotated - select for diffs
Tue Sep 22 17:59:49 2026 UTC (7 weeks, 5 days ago) by sborrill
Branches: MAIN
CVS tags: HEAD
Diff to: previous 1.27: preferred, colored
Changes since revision 1.27: +2 -2 lines
gam: update to 7.48.11

Changes since 7.44.03:

7.48.11

Added option extensionupdatecheck to gam create chromeprofilecommand.

7.48.10

Updated Looker Studio references to Data Studio references; all functionality remains the same.

For backwards compatability, in all commands the following synonyms apply:

    lookerstudioassets is a synonym for datastudioassets
    lookerstudiopermissions is a synonym for datastudiopermissions

7.48.09

Updated gam calendars <CalendarEntity> modify <CalendarSettings> to handle the following error: ERROR: 403: requiredAccessLevel - You need to have owner access to this calendar.

7.48.08

Updated gam version extended for macOS Golden Gate 27.0.

7.48.07

Updated GAM to allow 20 million cells when creating/updating sheets with todrive.

    See: https://us.list-manage.com/4cGS8LG3mAB?e=baa211e38e&c2id=934399a2c72577ccc05c42d924dd344b

7.48.06

Added option expires <DateTime> to gam create admin that specifies when the role assignment expires.

7.48.05

Updated gam print|show policies to handle the following (inappropriate I believe) error: ERROR: 404: notFound - Requested enti bug in gam print|show policies group <REMatchPattern> that mistakenly displayed orgUnit policies.

Updated gam print policies to improve column name sorting.

Updated gam version extended and gam <UserTypeEntity> check|update serviceaccount to handle the following error when a proxy is being used: ERROR: Socket error: 403: Forbidden

7.48.04

Updated gam [<UserTypeEntity>] create|update shareddrive to handle API changes and the following error: ERROR: 403: insufficientFilePermissions - The user does not have sufficient permissions for this file.

7.48.02

Fixed bug in gam create|update policy that caused the following error: Policy: New Policy, Create Failed: Error(7016): Request contains invalid argument(s)..

7.48.01

Updated gam create datatransfer to handle the following error: ERROR: Invalid choice (looker studio): Expected <drive and docs|calendar|data studio>

Upgraded to OpenSSL 4.0.2.

7.48.00

Added support for Allowlisted Domains.

    See: https://github.com/GAM-team/GAM/wlisted-Domains

7.47.07

Added levels and subject to <CourseFieldName>.

Added levels <String> and subject String> to <CourseAttribute>.

7.47.06

Updated gam print cigroups to handle the following error: ERROR: 500: internalError - Internal error encountered.

7.47.05

Added option showorgunits to gam print shareddriveorganizers that adds columns orgUnit,orgUnitId to the output. This is only available to system administrators.

7.47.04

Added clientencryptiondetails to <DriveFieldName>.

7.47.03

Added support for externalIds in Cloud Identity Groups.

Upgraded to Python 3.14.7.

7.47.02

Added option threadid <String> to gam <UserTypeEntity> draft|import|insert message.

7.47.01

Fixed bug in gam <UserTypeEntity> create shareddrive where GAM was unnecessarily waiting for the shared drive creation to complete when not required.

7.47.00

Added commands to update|display a user's chat availability.

    See: https://github.com/GAM-team/GAM/wiki/Users-Chat#manage-chat-user-availability
com/GAM-team/GAM/wiki/Users-Chat#display-chat-user-availability

You'll need to run gam user user@domain.com update serviceaccount and select 12)  Chat API - User Availability (supports readonly).

7.46.11

Updated gam <UserTypeEntity> update user to handle the following error: ERROR: 404: resourceNotFound - Does not exist

7.46.10

Updated gam calendars <CalendarEntity> create event and gam <UserTypeEntity> create event to handle a trap ending in gamlib.glgapi.serviceNotAvailable: The service is currently unavailable

7.46.09

Added option showmembertypes to gam print cigroup|groups that expands Members fields to include type information.

Members -> MembersTypeCustomer, MembersTypeGroup, MembersTypeUser
MembersCount -> MembersTypeCustomerCount, MembersTypeGroupCount, MembersTypeUserCount
InternalMembers -> InternalMembersTypeCustomer, InternalMembersTypeGroup, InternalMembersTypeUser
InternalMembersCount -> InternalMembersTypeCustomerCount, InternalMembersTypeGroupCount, InternalMemblMembers -> ExternalMembersTypeGroup, ExternalMembersTypeUser
ExternalMembersCount -> ExternalMembersTypeGroupCount, ExternalMembersTypeUserCount

7.46.08

Added option (addcsvdata <FieldName> <String>)* to gam <UserTypeEntity> print calendars that adds additional columns of data to the CSV file output.

Added option ownedsecondary to gam <UserTypeEntity> print|show calendars that causes GAM to only display secondary calendars where <UserTypeEntity> is the dataOwner.

Added option showenabled to gam <UserTypeEntity> print|show forwardingaddresses that causes GAM to display the enabled status for each forwarding address.

Disabled unnecessary Regional Access Boundary (trust boundary) lookups to improve performance.

7.46.07

Added command gam show configlicenseskus that can be used to generate a command that sets the list of used license SKUs in gam.cfg; this improves performance of gam info user.

gam show configlicenseskus
Got 0 Licenses for 1010010001 (Cloud Identity Free)...
Got 0 LCloud Identity Premium)...
...
Got 2 Licenses for 1010340007 (Google Workspace for Education Fundamentals - Archived User)...
...
Got 100 Licenses for 1010070001 (Google Workspace for Education Fundamentals)...
Got 200 Licenses for 1010070001 (Google Workspace for Education Fundamentals)...
Got 300 Licenses for 1010070001 (Google Workspace for Education Fundamentals)...
Got 358 Licenses for 1010070001 (Google Workspace for Education Fundamentals)...
Got 2 Licenses for 1010070004 (Google Workspace for Education Gmail Only)...
...
Got 0 Licenses for Google-Vault (Google Vault)...
Got 0 Licenses for Google-Vault-Former-Employee (Google Vault - Former Employee)...
To set license_skus in gam.cfg, execute the following command:
gam config license_skus "1010340007,1010070001,1010070004" save verify variables license_skus

    See: https://github.com/GAM-team/GAM/wiki/Licenses#info-user-performance

7.46.06

Updated GAM to suppress the following message:

Regional Access Boundary HTTP request sponse_data={'error': {'code': 403, 'message': 'Permission denied on the service account.', 'status': 'PERMISSION_DENIED'}}, retryable_error=False

7.46.05

Fixed bug in gam <UserTypeEntity> print sheet where an extra line of output was displayed before the CSV data.

7.46.04

Added the following command to transfer secondary calendar ownership.

gam <CalendarEntity> transfer ownership <UserItem>

7.46.03

Updated all Vault related commands to handle the following error: ERROR: 403: permissionDenied

7.46.02

Updated gam calendars <CalendarEntity> show settings to display dataOwner field; it is labelled Owner.

7.46.01

Fixed bug in gam <CrOSTypeEntity> issuecommand command <CrOSCommand> ... csv where command execution status lines were improperly indented.

Upgraded to Python 3.14.6.

7.46.00

Added commands to create, update and delete Cloud Identity policies for data loss prevention (DLP) rules and detectors.

    See: https://github.com/GAM-team/GAM/wiki/Cloud-Identity-Policies
   pdates.googleblog.com/2026/06/introducing-workspace-policy-api-mutate-endpoints-for-DLP.html

7.45.00

Added options isdisabled [<Boolean>], disabledafter <DateTime> and disabledbefore <DateTime> to gam print users. These options along with issuspended [<Boolean>] and isarchived [<Boolean>] are useful when identifying users to deprovision.

Added option movefilepermissions [<Boolean>]] to gam <UserTypeEntity> move drivefile that, when False, causes GAM to remove ACLs from a file before moving it; this will be most useful when moving files to Shared Drives so that only the Shared Drive ACls apply. When not specified or set True, file permissions are not removed; this is the current GAM behavi

Revision 1.27: download - view: text, markup, annotated - select for diffs
Tue Jun 2 15:06:30 2026 UTC (5 months, 2 weeks ago) by sborrill
Branches: MAIN
CVS tags: pkgsrc-2026Q3-base, pkgsrc-2026Q3, pkgsrc-2026Q2-base, pkgsrc-2026Q2
Diff to: previous 1.26: preferred, colored
Changes since revision 1.26: +2 -2 lines
gam: update to 7.44.03

Changes since 7.42.00:

7.44.03

Added writerwithoutprivateaccess to <CalendarACLRole>; this will become effective 2026-06-29.

7.44.02

Added fields bluetoothadapterinfo and osversioncompliance to <CrOSFieldName> for use in gam info|print cros.

7.44.01

Added option oneitemperrow to gam print crostelemetry to have each of a device's report field entries displayed on a separate row with all of the other device fields.

Added additional fields to <CrOSTelemetryFieldName>and <CrOSTelemetryListFieldName>:

appreport
heartbeatstatusreport
kioskappstatusreport
networkbandwidthreport
runtimecountersreport

7.44.00

Added support for User data archivalTime and suspensionTime that is available when fields archived and suspended are requested in gam info user and gam print users.

Added the following options to gam <UserTypeEntity> show chatmessages to simplify specifying a filter.

start|starttime <Date>|<Time>
end|endtime <Date>|<Time>
range <Date>|<Time> <Date>|<Time>
thread <ChatThread>

Added commands to search for and display chat messages.
These commands are in Developer Preview; to use them you must have these values set in gam.cfg.

developer_preview_apis = chat
developer_preview_api_key = <DeveloperPreviewKey>

Upgraded to Python 3.14.5.

7.43.10

Updated gam <UserTypeEntity> forward message|thread [recipient|to] <RecipientEntity> to not forward messages to the Bcc recipients of the original message.

Fixed bug in gam <UserTypeEntity> forward message|thread [recipient|to] <RecipientEntity> addorigfieldstosubject where the recipient of the forwarded message was added to the subject line instead of the recipient of the original message.

7.43.09

Fixed bug in gam <UserTypeEntity> print filelist that caused a trap.

7.43.08

Fixed bug and formatting issues in gam info device <DeviceEntity>.

7.43.07

Improved validation of <QueryCrOS>, <QueryDevice> and <QueryMobile>.

7.43.06

Updated commands that use <QueryCrOS>, <QueryDevice> or <QueryMobile> to validate that it is of the form field:value and that value does not contain a '?'. Without validation, Google can return many more devices than are expected.

7.43.05

Added option matchfield attendeesorganizer <Boolean> <EmailAddressEntity> to <EventMatchProperty> that is used in commands that process events. The match is true if all of the addresses in <EmailAddressEntity> are present as attendees in the event and are an organizer or not based on <Boolean>.

Added option max_to_deprov <Integer> to gam update cros <CrOSEntity> action <CrOSAction> that is used when <CrOSAction> is any of the following:

deprovision_different_model_replace|
deprovision_different_model_replacement|
deprovision_retiring_device|
deprovision_same_model_replace|
deprovision_same_model_replacement|
deprovision_upgrade_transfer

max_to_deprov <Integer> - No deprovisions are processed if the number of devices in <CrOSEntity> exceeds <Integer>; the default value is one; set <Integer> to 0 for no limit.

7.43.04

Added option include_suspended_zeros [<Boolean>] to gam print vaultcounts that causes GAM to generate zero count lines for suspended users with zero items as well as non-suspended users.

7.43.03

Added option parentpathonly [<Boolean>] to the following commands that causes GAM to display only the parent folder names when displaying the path to a file.

gam <UserTypeEntity> info drivefile ... filepath|fullpath
gam <UserTypeEntity> show fileinfo ... filepath|fullpath
gam <UserTypeEntity> print|show filepath
gam <UserTypeEntity> print filelist ... filepath|fullpath

7.43.02

Added option maxactivities <Integer> to gam <UserTypeEntity> print driveactivity to limit the number of activities displayed; the default is 0, no limit.

7.43.01

Updated gam info user and gam print users to display guest user attributes: isGuestUser, guestAccountInfo

Expanded <UserTypeEntity> to allow specification of guest users.

Revision 1.26: download - view: text, markup, annotated - select for diffs
Tue Apr 28 09:18:53 2026 UTC (6 months, 2 weeks ago) by sborrill
Branches: MAIN
Diff to: previous 1.25: preferred, colored
Changes since revision 1.25: +2 -2 lines
gam: update to 7.42.00

Changes since 7.40.00:

7.42.00

In versions prior to 7.42.00, when redirect csv <FileName> was used, GAM did not open and write <FileName> until all processing was complete; if <FileName> was not accessible, an error was generated and no results were saved. Now, <FileName> is opened initially to verify accessiblity and then written when processing is complete.

In the unlikely event that this causes issues, you can do redirect csv <FileName> delayopen to get the previous behavior.

7.41.03

Fixed bug in the following: Added the following to <RowValueFilter> used in CSV input/output row filtering; these are synonyms for count and countrange.

[(any|all):]number<Operator><Number>|
[(any|all):]numberrange!=<Number>/<Number>|
[(any|all):]numberrange=<Number>/<Number>|

7.41.02

Added option ownername to gam info|print courses to have GAM display the course owners full name; there is an extra API call per course to get the name.

Added option creatorname to gam print course-announcements|course-materials|course-works to have GAM display the item creators full name; there is an extra API call per course to get the name.

After creating a group, it may be sometime, e.g. 30-45 seconds, before members can successfully be added to the group even though the API reported that the group was created. The following options can be used with gam create group to verify that the group is actually ready to be updated. This will be most useful in scripts that are used to create and then populate groups.

verifycreationretries <Integer> - Verify group creation, defaults to 0, no verification performed, range 0-20
verifycreationinitialdelay <Integer> - Number of seconds to delay before first verification performed, defaults to 5, range 0-60
verifycreationretrydelay <Integer> - Number of seconds to delay between verificaton retries, defaults to 5, range 1-60

If you have a script that deletes a group and then immediately tries to create a new group with the same email address, you may run into issues. There seems to be a 30-45 second window after the deletion in which a couple of strange errors can occur on the creation: Resource not found and Duplicate. The following options can be used with gam create group to handle these errors. This will be most useful in scripts that are used to delete and then immediately recreate groups.

recentdeleteretries <Integer> - Handle group delete/create errors, defaults to 0, no errors handled, range 0-20
recentdeleteretrydelay <Integer> - Number of seconds to delay between retries, defaults to 5, range 1-60

Added the following to <RowValueFilter> used in CSV input/output row filtering; these are synonyms for count and countrange.

[(any|all):]number<Operator><Number>|
[(any|all):]numberrange!=<Number>/<Number>|
[(any|all):]numberrange=<Number>/<Number>|

7.41.01

Fixed bug in gam print cigroups members managers owners countsonly totalcount internal external that caused a trap.

7.41.00

Upgraded to Python 3.14.4 and OpenSSL 4.0.0.

7.40.03

Added option whocanaddexternalmembers only_owners_can_add_external_members|end_users_can_add_external_members to <GroupSettingsAttribute>. It appears that allowexternalmembers true must be set in the same command. Added option whocanaddexternalmembers to <GroupFieldName>. These options are not in general release as of 2026-04-13; experiment.

7.40.02

Updated gam info|print cigroups and gam print|show cigroup-members to handle trap caused by API returning invalid member data; preferredMemberKey with no id.

7.40.01

Updated gam <UserTypeEntity> print filelist|filecounts to handle the permissionDetails subfield of the permissions field for My Drives; this useful when trying to display permission inheritance. An additional API call per file is required to get the permissionDetails subfield.

Revision 1.25: download - view: text, markup, annotated - select for diffs
Thu Apr 9 09:47:12 2026 UTC (7 months, 1 week ago) by sborrill
Branches: MAIN
Diff to: previous 1.24: preferred, colored
Changes since revision 1.24: +3 -3 lines
gam: update to 7.40.00 and take maintainership

Take maintainership.

Changes since 7.38.00:

7.40.00

Updated gam print|show businessprofileaccounts (client access) to gam <UserTypeEntity> print|show businessprofileaccounts (service account access). You'll need to run gam user user@domain.com update serviceaccount and select 2)  Business Account Management API.

7.39.08

Fixed bug in gam oauth create that caused a trap when 0)  Business Account Management API was selected.

Upgraded to Python 3.14.4 on macOS and Windows; Linux is still 3.14.3.

7.39.07

Upgraded to OpenSSL 3.6.2.

7.39.06

Fixed bug in gam version checkrc.

7.39.05

Added optional argument preview to updateprimaryemail <RegularExpression> <EmailReplacement> [preview] for the following commands that causes GAM to preview, but not perform, primary email address changes. This allows verification of the primary email address changes before commiting the changes.

gam update group <GroupEntity>
gam update cigroup <GroupEntity>
gam <UserTypeEntity> update user

7.39.04

Added updateprimaryemail <RegularExpression> <EmailReplacement> option to gam update group <GroupEntity> and gam update cigroup <GroupEntity> to allow modifying the group's current primary email address. For example, to change the domain of a set of groups from the current domain.com to newdomain.com:

gam update group csvfile Groups.csv:email updateprimaryemail "^(.+)@domain.com$" "\1@newdomain.com"

7.39.03

Added the following options to gam <UserTypeEntity> create chatspace that can be used to capture space details when creating chat spaces in bulk.

csv [todrive <ToDriveAttribute>*] [formatjson [quotechar <Character>]] (addcsvdata <FieldName> <String>)*

See: https://github.com/GAM-team/GAM/wiki/Users-Chat#bulk-build-chat-spaces

7.39.02

Fixed progress messages for gam <UserTypeEntity> print filelist when permissions were being displayed/matched for Shared Drives.

7.39.01

Updated gam <UserTypeEntity> transfer drive <UserItem> to handle the following error:

ERROR: 403: cannotDeletePermission - The authenticated user cannot delete the permission.

7.39.00

Deleted variable enforce_expansive_access from gam.cfg and removed option enforceexpansiveaccess from the following commands as expansive access is now always enforced by Google on My Drives.

gam <UserTypeEntity> delete permissions
gam <UserTypeEntity> delete drivefileacl
gam <UserTypeEntity> update drivefileacl
gam <UserTypeEntity> copy drivefile
gam <UserTypeEntity> move drivefile
gam <UserTypeEntity> transfer ownership
gam <UserTypeEntity> claim ownership

7.38.02

Added license SKU 1010470009 for AI Expanded Access; abbreviation aiexpandedaccess.

Renamed license SKU 1010470001 from Gemini Enterprise to Gemini Enterprise - Legacy.

7.38.01

Added root as a synonym for '/' in command line arguments that specify an OU. This is to avoid issues where a stand-alone / on the command line may be mis-interpreted by the command line interpreter as a reference to the file system root.

Revision 1.24: download - view: text, markup, annotated - select for diffs
Tue Mar 24 12:32:36 2026 UTC (7 months, 3 weeks ago) by sborrill
Branches: MAIN
CVS tags: pkgsrc-2026Q1-base, pkgsrc-2026Q1
Diff to: previous 1.23: preferred, colored
Changes since revision 1.23: +2 -2 lines
gam: update to 7.38.00

Changes since 7.36.01:

Added variable gcp_org_id to gam.cfg that is used by the following commands; by setting the value, additional API calls are eliminated.

gam create project
gam create gcpfolder
gam create|update|delete caalevel
gam print|show caalevels
gam print|show tokens gcpdetails

You can get and set the gam.cfg/gcp_org_id value with these commands:

$ gam info gcporgid
organizations/906207637890
$ gam config gcp_org_id organizations/906207637890 save

You can get and set the gam.cfg/customer_id value with these commands:

$ gam info customerid
C78abc9de
$ gam config customer_id C78abc9de save

Added the following options to gam report <ActivityApplicationName>.

applicationinfofilter <String>
networkinfofilter <String>
statusfilter <String>
includesensitivedata

7.37.00

Added new client access scopes used by gam print tokens.

[*] 52)  Resource Manager API - Organizations readonly
[*] 53)  Resource Manager API - Projects readonly

Added option gcpdetails to gam print tokens that uses these scopes to get additional project information.

7.36.03

Added command to send email replies that causes Gmail to recognize the message in conversation mode for the user sending the reply and the user receiving the reply; GAM supplies the necessary headers and options.

gam <UserTypeEntity> sendreply
        (((query <QueryGmail> [querytime<String> <Date>]*) [or|and])+) | (ids <MessageIDEntity>)
        [replyto <EmailAddress>]
        [subject <String>] [<MessageContent>] [html [<Boolean>]]
        (attach <FileName> [charset <CharSet>])*
        (embedimage <FileName> <String>)*
        (<SMTPDateHeader> <Time>)* (<SMTPHeader> <String>)* (header <String> <String>)*

gam user user@domain.com sendreply query "rfc822MsgId:<CAAMmEdqj43...1OsQ@mail.gmail.com>" textmessage "Thanks for the information"
gam user user@domain.com sendreply ids 19cfc3506c02c22b textmessage "Thanks for the information"

    See: https://github.com/GAM-team/GAM/wiki/Send-Email#conversation-mode

7.36.02

Added option threadid <String> to gam [<UserTypeEntity>] sendemail that causes Gmail to recognize the message in conversation mode in for the user sending the message.

    See: https://github.com/GAM-team/GAM/wiki/Send-Email#conversation-mode

Revision 1.23: download - view: text, markup, annotated - select for diffs
Mon Mar 16 09:04:39 2026 UTC (8 months ago) by sborrill
Branches: MAIN
Diff to: previous 1.22: preferred, colored
Changes since revision 1.22: +2 -2 lines
gam: update to 7.36.01

Changes since 7.34.02:

7.36.01

Fixed bug in gam info|print|show policies where the policyQuery/query field was not displayed.

Added option noidmapping to gam info|print|show policies to suppress adding the policyQuery/groupEmail and policyQuery/orgUnitPath name fields that are mapped from the policyQuery/group and policyQuery/orgInit id fields.

7.36.00

Added options filtermultiattrtype and filtermultiattrcustom to gam info user and gam print users that support filtering display based on type or customType.

7.35.03

Updated gam <UserTypeEntity> print filelist|filecounts to handle options showsize and showsizeunits as independent options.

    showsize - Display a column Size with a byte count
    showsizeunits - Display a column SizeUnits with a formatted size with units

If you select both options, you can sort multiple rows using the Size column.

7.35.02

Added option showsizeunits to gam gam <UserTypeEntity> print filelist|filecounts as an alternative to option showsize.

    showsize - 31549200951 - This is a byte count
    showsizeunits - 31.55 GB - This is as shown in the Admin console

7.35.01

The following commands have been updated to not verify the existence of gam.cfg credentials files as the WARNING messages about the missing files can be confusing to new users setting up GAM.

gam checkconn
gam oauth|oauth2
gam version

7.35.00

Windows gam-7.wx.yz-x86_64.msi has been replaced with gam-7.wx.yz-x86_64.exe.

Windows gam-7.wx.yz-arm64.msi has been replaced with gam-7.wx.yz-arm64.exe.

Updated cacerts.pem to avoid to following error in gam checkconn.

Checking raw.githubusercontent.com (185.199.110.133) (2)...                                         ERROR
    Certificate verification failed. If you are behind a firewall / proxy server that does TLS / SSL inspection you may need to point GAM at your certificate authority file by setting cacerts_pem = /path/to/your/certauth.pem in gam.cfg.

If you have customized cacerts.pem, update your version with the Operating CA: Let's Encrypt values from the GAM default version.

7.34.13

Fixed bug in gam info policies <CIPolicyNameEntity> ... formatjson where extraneous line Show Info 1 Policy was displayed.

7.34.12

Fixed build errors that prevented Windows zip files from being created.

Added option returnidonly to gam create|update printer that causes GAM to return just the ID of the printer.

7.34.11

Updated gam-install.sh script for macOS/Linux to properly config GAM when the answer to the following question is No.

Can you run a full browser on this machine? (usually Y for macOS, N for Linux if you SSH into this machine)

7.34.10

Fixed bug where formatjson quotechar <Character> on the command line did not override redirect csv <FileName> multiprocess quotechar <Character>.

7.34.09

Updated gam <UserTypeEntity> update photo to delete the user's existing photo before performing the update as the API update will succeed but not replace a user's existing self-set photo.

7.34.08

Rebuild to avoid the following error:

requests/__init__.py:113: RequestsDependencyWarning: urllib3 (2.6.3) or chardet (6.0.0.post1)/charset_normalizer (3.4.4) doesn't match a supported version!

7.34.07

Added the following command to create a guest user.

    See: https://support.google.com/a/answer/16558545

gam create guestuser <EmailAddress>

Added the following items to <UserFieldName>:

    guestaccountinfo - Additional guest-related metadata fields
    isguestuser - Indicates if the inserted user is a guest

7.34.06

Added option copyfolderpermissions [<Boolean>] to gam <UserTypeEntity> copy|move drivefile.

When copyfolderpermissions false is specified, no folder permissions are copied; this simplifies disabling all folder permission copying.

When not specified or copyfolderpermissions [true] is specified, folder permissions are copied based on the following options:

copymergewithparentfolderpermissions [<Boolean>]
copymergedtopfolderpermissions [<Boolean>]
copytopfolderpermissions [<Boolean>]
copytopfolderiheritedpermissions [<Boolean>]
copytopfoldernoniheritedpermissions never|always|syncallfolders|syncupdatedfolders
copymergedsubfolderpermissions [<Boolean>]
copysubfolderpermissions [<Boolean>]
copysubfolderinheritedpermissions [<Boolean>]
copysubfoldernoniheritedpermissions never|always|syncallfolders|syncupdatedfolders

7.34.05

Updated gam report <ActivityApplictionName> to perform a reverse chronological sort on all rows across multiple users and/or event names; this is consistent with the behavior in the Admin console. Use option notimesort to suppress this sort.

7.34.04

Updated gam <UserTypeEntity> create drivefileacl <DriveFileEntity> user <UserItem> role owner to better handle the case where the current owner of a file is suspended. Previously, the command was displayed as an error even though the ownership was changed.

gam user currentowner@domain.com add drivefileacl <DriveFileID> user newowner@domain.com role owner

User: currentowner@domain.com, Add 1 Drive File/Folder ACL
  User: currentowner@domain.com, Drive File/Folder ID: <DriveFileID>, Permission ID: newowner@domain.com, Add Failed: Sorry, the items were successfully shared but emails could not be sent to newowner@domain.com.

Now the command is displayed as a success with a note indicating that the ownership change email was not sent.

gam user currentowner@domain.com add drivefileacl <DriveFileID> user newowner@domain.com role owner
User: currentowner@domain.com, Add 1 Drive File/Folder ACL
  User: currentowner@domain.com, Drive File/Folder ID: <DriveFileID>, Permission ID: newowner@domain.com, Added: Sorry, the items were successfully shared but emails could not be sent to newowner@domain.com.
  New Owner
    id: 10834698115409747890
    type: user
    emailAddress: newowner@domain.com
    domain: domain.com
    role: owner
    permissionDetails:
      role: writer
        type: file
        inherited: True
        inheritedFrom: Unknown
      role: owner
        type: file
        inherited: False
    deleted: False
    pendingOwner: False

7.34.03

Updated to Python 3.14.3

Updated Cryptography to 46.0.5

Updated gam course <CourseID> create student|teacher <EmailAddress> error message when <EmailAddress> is not in a trusted domain to remove suggestion about creating an invitation.

Revision 1.22: download - view: text, markup, annotated - select for diffs
Mon Feb 16 09:41:37 2026 UTC (8 months, 4 weeks ago) by sborrill
Branches: MAIN
Diff to: previous 1.21: preferred, colored
Changes since revision 1.21: +2 -2 lines
gam: update to 7.34.02

Changes from 7.33.02:

Updated GAM to prevent errors like the following:

ERROR: Unable to find the server at oauth2.googleapis.com
ERROR: Unable to find the server at gmail.googleapis.com

7.34.01

Updated gam create|update adminrole to handle the following errors:

ERROR: 400: invalid - Invalid Role privileges
ERROR: 400: required - Required parameter: [resource.privileges[n].service_id]

7.34.00

Added variable csv_output_header_required to gam.cfg that is a comma separated list of <Strings> that are required to be in the list of column headers in the CSV file written by a gam print command. This will typically be used to specify headers that are required in subsequent commands that process the CSV file even if the API didn't return any data for those columns.

Updated the following commands to not require the Directory API - Domains scope unless the internal or external options are used to request the member category.

gam info|print groups
gam print|show group-members
gam info|print cigroups
gam print|show cigroup-members
gam <UserTypeEntity> print|show filesharecounts

7.33.03

Fixed bug in gam [<UserTypeEntity>] sendemail ... from <EmailAddress> replyto <EmailAddress> where an <EmailAddress> of the form Text <user@domain.com> had the Text removed.

Revision 1.21: download - view: text, markup, annotated - select for diffs
Tue Feb 10 11:24:57 2026 UTC (9 months ago) by sborrill
Branches: MAIN
Diff to: previous 1.20: preferred, colored
Changes since revision 1.20: +2 -2 lines
gam: Update to 7.33.02

Changes since 7.32.06

7.33.02

Added hideinvitationssetting to <UserCalendarSettingsField> used by gam <UserTypeEntity> print|show calsettings.

7.33.01

Added option shownopolicy to gam print chromepolicies that will display output like the following if no policies apply to the selected OU or group.

gam print chromepolicies ou /Test appid chrome:emidddocikgklceeeifefomdnbkldhng namespace chrome.users.apps shownopolicy
Getting all Chrome Policies that match query (chrome.users.apps.*) for /Test
Got 0 Chrome Policies that matched query (chrome.users.apps.*) for /Test...
name,orgUnitPath,parentOrgUnitPath,direct,appId
noPolicy,/Test,/,False,chrome:emidddocikgklceeeifefomdnbkldhng

7.33.00

Added variable developer_preview_apis to gam.cfg that is a comma separated list of APIs requiring a Developer Preview key.
Currently, chat is the only API that requires a Developer Preview key; it is required for the User Sections commands.

    See: https://github.com/GAM-team/GAM/wiki/Users-Chat#introduction
    See: https://github.com/GAM-team/GAM/wiki/Users-Chat#manage-chat-user-sections

7.32.07

Added option includepermissionsforview published to gam <UserTypeEntity> print filelist and gam <UserTypeEntity> show fileinfo. From the Drive API documentation:

Specifies which additional view's permissions to include in the response. Only published is supported.

Revision 1.20: download - view: text, markup, annotated - select for diffs
Fri Jan 30 11:32:35 2026 UTC (9 months, 2 weeks ago) by sborrill
Branches: MAIN
Diff to: previous 1.19: preferred, colored
Changes since revision 1.19: +2 -2 lines
gam: update to 7.32.06

Changes since 7.29.01:

7.32.06

Added options to gam <UserTypeEntity> copy drivefile ... copysubfiles to limit copying to files whose modifiedTime meets specified requirements.

    start|starttime <Date>|<Time> - If specified, modifiedTime must be >= the value
    end|endtime <Date>|<Time> - If specified, modifiedTime must be <= the value
    range <Date>|<Time> <Date>|<Time> - first value <= modifiedTime <= second value

7.32.05

Fixed bug in gam <UserTypeEntity> print messages|threads ... headers <SMTPHeaderList> where headers other than those specified in <SMTPHeaderList> were displayed.

Updated gam info users <UserTypeEntity> to display the following data when the Licensing API does not return data due to quota limits. Previously, no License data was displayed and there was no way to know if it was omitted due to API quota limits vs the user has no license?

  Licenses: (1)
    Not available/incomplete

If a user has no licenses, this will be displayed.

  Licenses: (0)

You should use license_skus = <SKUIDList> in gam.cfg to list all of the licensing SKUs used in your workspace. Without this list, GAM has to make 70+ API calls to get the licenses for a user; this can cause quota limit errors.

7.32.04

Support for student groups in Google Classroom no longer requires Developer Preview membership.

Upgraded to OpenSSL 3.6.1.

7.32.03

Added option template as an additional formating option for gam <UserTypeEntity> show signature that displays just the HTML data; this simplifies capturing the data for use as input to GAM.

$ gam redirect stdout ./SigTemplate.html user user@domain.com show signature template
$ more SigTemplate.html
<div dir="ltr"><div dir="ltr"><div dir="ltr">
<p style="margin:0px;font-size-adjust:none;font-stretch:normal;font-size:12px;line-height:normal;font-family:Monaco;color:rgb(0,0,0)">
<span style="background-color:rgb(82,208,206)">{RT}Email: {Email}{/RT}</span></p>
<p style="margin:0px;font-size-adjust:none;font-stretch:normal;font-size:12px;line-height:normal;font-family:Monaco;color:rgb(0,0,0)">
<span style="background-color:rgb(82,208,206)">{RT}Phone: {Phone}{/RT}</span></p>
<p style="margin:0px;font-size-adjust:none;font-stretch:normal;font-size:12px;line-height:normal;font-family:Monaco;color:rgb(0,0,0)">
<span style="background-color:rgb(82,208,206)">{RT}Mobile: {Mobile}{/RT}</span></p>
</div><br></div>\n</div>

7.32.02

Added variable oauth2_txt_lock_mode to gam.cfg, the default is 644 and valid values are: 644, 664, 666. This value is used to set the file permissions on the oauth2.txt.lock file. In very special cases where daemon processes, e.g. Apache/httpd, are running GAM, the value 666 may have to be used.

7.32.01

Added option (addcsvdata <FieldName> <String>)* to gam <CrOSTypeEntity> issuecommand command <CrOSCommand> csv and gam <CrOSTypeEntity> getcommand commandid <CommandID> csv that adds additional columns of data to the CSV file output.

    See: https://github.com/GAM-team/GAM/wiki/ChromeOS-Devices#bulk-action-example

7.32.00

Added option verifyallowexternal to gam print cigroup-members|group-members that causes GAM to only display external members in groups with `allowExternalMembers=False'. This option can be used to help verify that internal-only groups don't have external members.

Updated option internaldomains for the following commands:

gam info|print groups
gam print|show group-members
gam info|print cigroups
gam print|show cigroup-members
gam <UserTypeEntity> print|show filesharecounts

Which domains are considered internal domains:

    internaldomains all - All of your workspace domains; this is the default
    internaldomains primary - Your workspace primary domain
    internaldomains <DomainNameList> - A list of domain names

Added option csv to gam <CrOSTypeEntity> issuecommand command <CrOSCommand> and gam <CrOSTypeEntity> getcommand commandid <CommandID> so that command details are displayed in CSV format. This can be used to log commands issued to devices and then monitor the results.

Added option filemimetype category <MimeTypeNameList> to gam <UserTypeEntity> copy drivefile to support copying of files based on their MimeType category.

Added option attendeeslist to gam calendars <CalendarEntity> print events and gam <UserTypeEntity> print events that causes GAM to display the attendee email addresses in a single column attendeesList; no attendee details are displayed. The email addresses are separated by csv_output_field_delimiter from gam.cfg.

Fixed bug in gam sendemail ... replyto <EmailAddress> that caused a message delivery error if <EmailAddress> did not include a domain name.

Added support for users's chat sections.

    See: https://github.com/GAM-team/GAM/wiki/Users-Chat#manage-chat-users-sections
    This is in Deveoper Preview; you must have a developer_preview_api_key in gam.cfg to use these commands.

7.31.06

Added option batchsize <Integer> to gam calendar <CalendarEntity> delete|purge events and gam <UserTypeEntity> delete|purge events <UserCalendarEntity> that causes GAM to delete events with batch API calls rather than with individual API calls.

7.31.05

Added option variables <RESearchPattern> to gam select section <SectionName> verify and gam config verify that causes GAM to only display variables with names selected by <RESearchPattern>.

gam select School verify variables "^(customer|domain)"
Section: School
  customer_id = C03abc123
  domain = school.edu

gam config verify variables  'dir'
Section: DEFAULT
  cache_dir = ~/GamConfig/gamcache ; /Users/gamteam/GamConfig/gamcache
  config_dir = ~/GamConfig ; /Users/gamteam/GamConfig
  drive_dir = ~/GamWork ; /Users/gamteam/GamWork
  gmail_cse_incert_dir = ~/GmailCSE/Certs ; /Users/gamteam/GmailCSE/Certs
  gmail_cse_inkey_dir = ~/GmailCSE/Keys ; /Users/gamteam/GmailCSE/Keys
  input_dir = .

7.31.04

Fixed bug in gam report admin|chrome that caused to events to not be displayed.

Updated gam <UserTypeEntity> print|show messages|threads ... query <QueryGmail> to display the query.

7.31.03

Due to the following Calendar API update, the gam <UserTypeEntity> transfer calendars command has been removed.

    See: https://developers.google.com/workspace/calendar/release-notes#October_27_2025 Data ownership can be transferred in the Google Calendar UI.

7.31.02

Added the following options to gam <UserTypeEntity> copy drivefile to limit copying to those files owned by selected users.

    copysubfilesownedby users <EmailAddressList> - Only files owned by users in <EmailAddressList> are copied.
    copysubfilesownedby notusers <EmailAddressList> - Only files not owned by users in <EmailAddressList> are copied.
    copysubfilesownedby regex <REMatchPattern> - Only files owned by users whose email addresses match <REMatchPattern> are copied.
    copysubfilesownedby notregex <REMatchPattern> - Only files owned by users whose email addresses do not match <REMatchPattern> are copied.

7.31.01

Code cleanup for addcsvdata <FieldName> <String>.

7.31.00

Fixed bug in gam report chrome (user <UserItem>)|(select <UserTypeEntity>) where no activities were returned. report chrome does not use the parameter userKey=<EmailAddress> as do other applications but requires parameter filter DEVICE_USER==<EmailAddress>.

Updated gam report admin (user <UserItem>)|(select <UserTypeEntity>) to use parameter filter USER_EMAIL==<EmailAddress> to display activiities affecting the user <EmailAddress>. Use option userisactor to use the parameter userKey=<EmailAddress> that displays activities where user <EmailAddress> executed the command that generated the activity.

Fixed bug in gam print cros|filelist|users ... (addcsvdata <FieldName> <String>)+ formatjson where the addcsvdata columns were not displayed but the additional field values were included in the JSON data. Now, the addcsvdata columns are displayed but the additional field values are only included in the JSON data when option includdecsvdatainjson is specified.

Added option addcsvdata <FieldName> <String> to gam <UserTypeEntity> print cigroups|groups that adds additional columns of data to the CSV file output.

Added option addcsvdata <FieldName> <String> to gam <UserTypeEntity> print cigroupmembere|group-members that adds additional columns of data to the CSV file output.

7.30.05

Added option gmaileventtypes <NumberRangeList> to gam report gmail that can be used to limit the event types displayed.

<NumberRange> ::= <Number>|(<Number>/<Number>)
<NumberRangeList> ::= "<NumberRange>(,<NumberRange>)*"

gam report gmail user user@domain.com gmaileventtypes 1,10/11

    See: https://developers.google.com/workspace/admin/reports/v1/appendix/activity/gmail

Updated sorting of column headers in gam report <ActivityApplicationName>.

7.30.04

Updated gam report gmail to avoid the following error when incomplete start/end time information is provided.

ERROR: Invalid request: Start time and end time should both be provided, and the scan duration should not be greater than 30 days.

    No time information provided - GAM sets range -30d today
    Only start <Time> provided - GAM sets end <Time>+30d
    Only end <Time> provided - GAM sets start <Time>-30d

7.30.03

Updated gam report <ActivityApplicationName> to reflect the changes described here:

    See: https://workspaceupdates.googleblog.com/2025/12/google-workspace-audit-log-api.html

Added option resourcedetailsfilter <String> to gam report <ActivityApplicationName> described here:

    See: https://developers.google.com/workspace/admin/reports/reference/rest/v1/activities/list#query-parameters

For gam <UserTypeEntity> print <Objects>, expanded the list of <Objects> covered by gam.cfg csv_output_users_audit = True.

7.30.02

Added option conferencedata meet <MeetID> to <EventAttribute> that allows specifying a reference to an existing Google Meet when creating/updating a calendar event.

Upgraded to Python 3.14.2.

7.30.01

Fixed bug introduced in 7.30.00 that caused errors when reading CSV files.

Added the following options to gam <UserTypeEntity> create focustime|outofoffice:

((date yyyy-mm-dd)|
 (range yyyy-mm-dd yyyy-mm-dd)|
 (daily yyyy-mm-dd N)|
 (weekly yyyy-mm-dd N))

Added the following options to gam <UserTypeEntity> create focustime|outofoffice|workinglocation:

noreminders|(reminder email|popup <Number>)+

7.30.00

Added input_dir directory variable to gam.cfg that is used to select a directory for reading files with non-absolute file names. The default is an empty string that matches the current behavior where these files are read from the current working directory. This will be most useful in multiple domain situations where each domain will have distinct drive_dir and input_dir values.

Added support for the new resource calendar setting autoAcceptInvitations.

7.29.04

Updated gam delete chromepolicy chrome.users.apps.InstallType ou <OrgUnitItem> appid <AppID> to allow deleting an app, i.e., explicitly remove it from management. <OrgUnitItem> must specify where it was added for management.

7.29.03

Remove debugging message from gam <UserTypeEntity> move drivefile <DriveFileEntity>.

7.29.02

Fixed bug in gam <UserTypeEntity> move drivefile <DriveFileEntity> where the following options were only applied to top level files or folders re-created in the destination. Now, domain and email address mappings apply to all moved files/folders.

excludepermissionsfromdomains <DomainNameList>
includepermissionsfromdomains <DomainNameList>
mappermissionsdomain <DomainName> <DomainName>
mappermissionsemail <EmailAddress> <EmailAddress>
mappermissionsemailfile <CSVFileInput> endcsv

Upgraded to Python 3.14.1.

Revision 1.19: download - view: text, markup, annotated - select for diffs
Tue Dec 2 14:24:21 2025 UTC (11 months, 2 weeks ago) by sborrill
Branches: MAIN
CVS tags: pkgsrc-2025Q4-base, pkgsrc-2025Q4
Diff to: previous 1.18: preferred, colored
Changes since revision 1.18: +3 -2 lines
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.

Revision 1.18: download - view: text, markup, annotated - select for diffs
Fri Aug 29 13:50:22 2025 UTC (14 months, 2 weeks ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2025Q3-base, pkgsrc-2025Q3
Diff to: previous 1.17: preferred, colored
Changes since revision 1.17: +4 -3 lines
gam: fix tool dependency

Prefer REPLACE_PYTHON to CHECK_INTERPRETER_SKIP.

Revision 1.17: download - view: text, markup, annotated - select for diffs
Fri Aug 29 13:42:23 2025 UTC (14 months, 2 weeks ago) by sborrill
Branches: MAIN
Diff to: previous 1.16: preferred, colored
Changes since revision 1.16: +5 -9 lines
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.

Revision 1.16: download - view: text, markup, annotated - select for diffs
Mon Jun 30 12:36:42 2025 UTC (16 months, 2 weeks ago) by sborrill
Branches: MAIN
Diff to: previous 1.15: preferred, colored
Changes since revision 1.15: +2 -2 lines
gam: update to 7.10.07

Changes since 7.10.01:

7.10.07

Updated gam <UserTypeEntity> copy|move drivefile to hanndle additional instances of the cannotModifyInheritedPermission error.

Added license SKU Google AI Ultra for Business

    ProductID - 101047
    SKUID - 1010470008 | geminiultra

7.10.06

Added option clientstates to gam print devices to include client states in device output.

7.10.05

Google renamed an error: cannotModifyInheritedTeamDrivePermission became cannotModifyInheritedPermission. GAM will now handle the new error.

7.10.04

Updated gam report <ActivityApplicationName> to accept accept application names as defined in the Reports API discovery document; this means that GAM does not have to be updated when Google defines a new application name.

gemini_in_workspace_apps is now available in gam report.

7.10.03

Fixed bug in commands that modify messages where the labelids <LabelIdList> option was not being applied.

7.10.02

Added option labelids <LabelIdList> to all commands that process messages; this option causes GAM to only return messages with labels that match all of the specified label IDs.

Updated gam <UserTypeEntity> print|show forms to always display isPublished and isAcceptingResponses in publishSettings/publishState regardless of their value; the API doesn't return these values when they are False.

Revision 1.15: download - view: text, markup, annotated - select for diffs
Fri Jun 20 15:41:26 2025 UTC (16 months, 3 weeks ago) by sborrill
Branches: MAIN
CVS tags: pkgsrc-2025Q2-base, pkgsrc-2025Q2
Diff to: previous 1.14: preferred, colored
Changes since revision 1.14: +2 -3 lines
gam: update to 7.10.01

Changs since 7.05.08:

7.10.01

Added options ispublished [<Boolean>] and isacceptingresponses [<Boolean>] to gam <UserTypeEntity> create|update form.

7.10.00

Added commands to manage/display Chat Custom Emojis.

    See: https://github.com/GAM-team/GAM/wiki/Users-Chat#manage-chat-emojis
    See: https://github.com/GAM-team/GAM/wiki/Users-Chat#display-chat-emojis

Updated gam <UserItem> print|show chatspaces|chatmembers asadmin to display the spaces in ascending display name order.
7.09.07


Added webviewlink to <FileTreeFieldName> for use in gam <UserTypeEntity> print|show filetree.

7.09.06

Upddated gam print|show shareddrives, gam print|show shareddriveacls, gam print shareddriveorganizers to display the Shared Drives in ascending name order; the API returns them in an unidentifiable order.

7.09.05

Improved output of gam info|show chromeschemas [std] to more accurately display the schemas.

Fixed bugs in gam update chromepolicy that caused invalid error messaages.

7.09.04

Fixed bug in gam whatis <EmailItem> where the check for an invitable user always failed.

Fixed bug in gam print shareddriveorganizers where no organizers were displayed when domain in gam.cfg was blank.

Updated to Python 3.13.5

7.09.03

Updated gam <UserTypeEntity> create focustime|outofoffice ... timerange <Time> <Time> to check that the first <Time> is less than the second Time; previously the event was not created.

For new installs the enforce_expansive_access Boolean variable in gam.cfg now defaults to True. For existing installations, if enforce_expansive_access has not been added to gam.cfg, a default value of True will be used.

7.09.02

Added command gam info chromeschema std <SchemaName> to display a Chrome policy schema in the same format as Legacy GAM.

Improved output of gam show chromeschemas [std] and gam info chromeschema [std] to more accurately display the schemas.

7.09.01

Fixed bug in gam <UserTypeEntity> print diskusage where the ownedByMe column was blank for the top folder.

Fixed bug in gam update chromepolicy where the following error was generated when updating policies with simple numerical values.

ERROR: Missing argument: Expected <value>"

7.09.00

Removed the overly broad service account IAM and Access Management API scope https://www.googleapis.com/auth/cloud-platform from DWD. The gam <UserTypeEntity> check|Update serviceaccount commands issue an error message if this scope is enabled prompting you to update your service account authorization so that the scope can be removed.

GAM commands that need IAM access now use the more limited scope https://www.googleapis.com/auth/iam in a non-DWD manner.

Added enforce_expansive_access Boolean variable to gam.cfg that provides the default value for option enforceexpansiveaccess in all commands that delete or update drive file ACLs/permissions. It's default value is False.

gam <UserTypeEntity> delete permissions
gam <UserTypeEntity> delete drivefileacl
gam <UserTypeEntity> update drivefileacl
gam <UserTypeEntity> copy drivefile
gam <UserTypeEntity> move drivefile
gam <UserTypeEntity> transfer ownership
gam <UserTypeEntity> claim ownership
gam <UserTypeEntity> transfer drive

Fixed bug in gam print shareddriveorganizers that caused a trap when an organizer was a deleted user.

Updated to Python 3.13.4

7.08.02

Updated the defaults in gam print shareddriveorganizers to match the most common use case, not the script.

    domainlist - The workspace primary domain
    includetypes - user
    oneorganizer - True
    shownoorganizerdrives - True
    includefileorganizers - False

To select organizers from any domain, use: domainlist ""

These commands produce the same result.

gam redirect csv ./TeamDriveOrganizers.csv print shareddriveorganizers domainlist mydomain.com includetypes user oneorganizer shownoorganizerdrives
gam redirect csv ./TeamDriveOrganizers.csv print shareddriveorganizers

7.08.01

Added option shareddrives (<SharedDriveIDList>|(select <FileSelector>|<CSVFileSelector>)) to gam print shareddriveorganizers that displays organizers for a specific list of Shared Drive IDs.

See: https://github.com/GAM-team/GAM/wiki/Shared-Drives#display-shared-drive-organizers

7.08.00

Added the following command that can be used instead of the GetTeamDriveOrganizers.py script.

gam [] print shareddriveorganizers [todrive *] [adminaccessasadmin] [shareddriveadminquery|query ] [orgunit|org|ou ] [matchname ] [domainlist ] [includetypes ] [oneorganizer []] [shownorganizerdrives [false|true|only]] [includefileorganizers []] [delimiter ]

See: https://github.com/GAM-team/GAM/wiki/Shared-Drives#display-shared-drive-organizers

The command defaults match the script defaults:
* `domainlist` - All domains
* `includetypes` - user,group
* `oneorganizer` - False
* `shownoorganizerdrives` - True
* `includefileorganizers` - False

For example, to get a single user organizer from your domain for all Shared Drives including no organizer drives:

gam redirect csv ./TeamDriveOrganizers.csv print shareddriveorganizers domainlist mydomain.com includetypes user oneorganizer shownoorganizerdrives

7.07.17

Added option `oneuserperrow` to `gam print devices` to have each of a
device's users displayed on a separate row with all of the other device fields.

7.07.16

Added `chromeostype`, `diskspaceusage` and `faninfo` to `<CrOSFieldName>` for use in `gam info|print cros`.

Fixed bugs/cleaned output in  `gam info|print cros`.

7.07.15

Added option `shareddrivesoption included|included_if_account_is_not_a_member|not_included` to `gam create vaultexport`.

The previous option `includeshareddrives <Boolean>` is mapped as follows:
* `includeshareddrives false` - `shareddrivesoption included_if_account_is_not_a_member`
* `includeshareddrives true` - `shareddrivesoption included`

7.07.14

Update `gam setup chat` output to include the following that shows the actual Cloud Pub/Sub Topic Name.

You'll use projects//topics/no-topic in Connection settings Cloud Pub/Sub Topic Name

7.07.13

Added option `showitemcountonly` to `gam [<UserTypeEntity>] print|show shareddrives` that causes GAM to display the
number of Shared Drives on stdout; no CSV file is written.

7.07.12

Fixed bug in `gam print|show oushareddrives` that caused a trap.

Improved getting Shared Drive names from IDs when accessing Shared Drives in external workspaces.

7.07.11

Updated `gam calendars <CalendarEntity> update events` and `gam <UserTypeEntity> update events <UserCalendarEntity>`
to handle the following error:

ERROR: 400: badRequest - Bad Request

Updated `gam <UserTypeEntity> move drivefile` to handle the following error:

ERROR: 400: shareOutNotPermitted

7.07.10

Updated `gam calendars <CalendarEntity> update events` and `gam <UserTypeEntity> update events <UserCalendarEntity>`
to handle the following error:

ERROR: 400: eventTypeRestriction - Attendees cannot be added to 'fromGmail' event with this visibility setting.

7.07.09

Updated `gam calendars <CalendarEntity> update events` and `gam <UserTypeEntity> update events <UserCalendarEntity>`
to handle the following error:

gamlib.glgapi.serviceNotAvailable: Authentication backend unavailable.

7.07.08

Fixed bug in `gam <UserTypeEntity> print filelist ... countsonly` that issued an
incorrect warning message like the following when `redirect csv <FileName> multiprocess` was specified.

WARNING: csv_output_row_filter column "^name$" does not match any output columns

7.07.07

Fixed bug in `gam report <ActivityApplictionName> ... countsonly eventrowfilter` that issued an
incorrect warning message like the following when `redirect csv <FileName> multiprocess` was specified.

WARNING: csv_output_row_filter column "^doc_title$" does not match any output columns

7.07.06

Added option `eventrowfilter` to `gam calendars <CalendarEntity> print events ... countsonly`
and `gam <UserTypeEntity> print events <UserCalendarEntity> ... countsonly` that causes
GAM to apply `config csv_output_row_filter` to the event details rather than the event counts.
This will be useful when `<EventSelectProperty>` and `<EventMatchProperty>` do not have the
capabilty to select the events of interest; e.g., you want to filter based on the event `created` property.

Dropped the extraneous `id` column for `gam calendars <CalendarEntity> print events ... countsonly`
and `gam <UserTypeEntity> print events <UserCalendarEntity> ... countsonly`.

7.07.05

Updated `gam <UserTypeEntity> move drivefile` to recognize the API error: `ERROR: 400: shareOutWarning`.

7.07.04

Updated `gam create vaultexport ... rooms <ChatSpaceList>` to strip `spaces/` from the Chat Space IDs.

Updated `gam <UserTypeEntity> copy drivefile` to recognize the API error: `ERROR: 400: shareOutWarning`.

7.07.03

Updated `gam create vaultexport` to allow allow specifying a list of items in a search method
with `shareddrives|rooms|sitesurl select <FileSelector>|<CSVFileSelector>`.

7.07.02

Fixed bug in `redirect csv ... transpose` where a CSV file with multiple rows was not properly transposed.

7.07.01

Fixed bug in `gam print|show chromepolicies` that caused a trap. Made additional
updates to handle changes in the Chrome Policy API.

7.07.00

As of mid-October 2024, Google deprecated the API that retrieved the Global Address List.

The following commands have been eliminated.

gam info gal gam print gal gam show gal


These commands are a work-around for `gam print gal`.

gam config csv_output_row_filter "includeInGlobalAddressList:boolean:true" redirect csv ./UserGAL.csv print users fields name,gal gam config csv_output_row_filter "includeInGlobalAddressList:boolean:true" batch_size 25 redirect csv ./GroupGAL.csv print groups fields name,gal


7.06.14

Updated `create|update adminrole` to allow specifying a collection of privileges
with `privileges select <FileSelector>|<CSVFileSelector>` which makes copying roles much simpler.

Added option `role <RoleItem>` to `gam print|show adminroles` to allow display of information
for a specific role.

7.06.13

Updated `gam print group-members ... recursive` and `gam print cigroup-members ... recursive`
to expand groups representing chat spaces.

7.06.12

Deleted commands to display Analytic UA properties; the API has been deprecated.

gam print|show analyticuaproperties

7.06.11

Improved `gam checkconn`.

Updated `gam print group-members` and `gam print cigroup-members` to recognize members
that are groups representing chat spaces. For now, these groups are not expanded when
`recursive` is specified.

7.06.10

Added the following license SKU.

1010020034 - Google Workspace Frontline Plus

7.06.09

Added `gemini` and `geminiforworkspace` to `<ActivityApplicationName>` for use in
`gam report <ActivityApplicationName>`.

7.06.08

Fixed problem where Yubikeys caused a trap.

7.06.07

Updated private key rotation progress messages in `gam create|use|update project`
and `gam upload sakey`.

Updated `gam use project` to display the following error message when the specifed project
already has a service account.

Re-run the command specify a new service account name with: saname '

7.06.06

Native support for Windows 11 Arm-based devices.

Renamed some MacOS and Linux binary installer files to align on terminology. Everything is "arm64" now, no "aarch64".

7.06.05

Updated code in `gam delete|update chromepolicy` to handle the `policyTargetKey[additionalTargetKeys]`
field in a more general manner for future use.

7.06.04

Fixed bug in `gam report <ActivityApplictionName>` where a report with no activities
was not displaying any output.

7.06.03

Fixed bug in `gam <UserTypeEntity> print|show drivelastmodification` that caused a trap
when an empty drive was specified.

7.06.02

Updated `gam <UserTypeEntity> print|show filecounts ... showlastmodification` to include
file mimetype and path information for the last modified file.

Added simple commands to get information about the last modified file on a drive.
By default, a user's My Drive is processed; optionally, a Shared Drive can be processed.

gam print drivelastmodification [todrive ] [select ] [pathdelimiter ] (addcsvdata ) gam show drivelastmodification [select ] [pathdelimiter ]

7.06.01

Updated `gam <UserTypeEntity> create|update drivefileacl ... expiration <Time>`
to handle additional API errors.

Updated to Python 3.13.3.

7.06.00

Upgraded to OpenSSL 3.5.0.

Fixed bug in `gam print cigroups` where `createTime`, `updateTime` and `statusTime`
were not converted according to `gam.cfg timezone`.

7.05.22

Updated progress messages for  `gam <UserTypeEntity> print filelist|filecounts|filesharecounts|filetree select shareddriveid <SharedDriveID>`
to display the ID of the SharedDrive that is being accessed.

Getting all Drive Files/Folders for user@domain.com on Shared Drive ID: <SharedDriveID Got 33 Drive Files/Folders for user@domain.com on Shared Drive ID: ...

7.05.21

Fixed bug in `gam update chromepolicy` that generated an error like the following
when JSON data was read from a file.

ERROR: JSON: {'error': {'code': 400, 'message': 'Invalid enum value: {prefix}{value} for enum type: chrome.policy.api.v1.devicepolicy.AllowNewUsersEnum', 'status': 'INVALID_ARGUMENT'}}

Fixed bug in `gam create chromepolicyimage` that caused a trap.

7.05.20

Updated code to validate both `<RegularExpression>` and `<ReplacementString>`
in the following command line options; this will expose errors when the command
is being parsed rather than at run-time.

replaceregex replacedescription replacefilename

7.05.19

Added `replaceregex <RegularExpression> <ReplacementString> <Tag> <String>` to the following commands:

gam sendemail subject gam sendemail subject

The `<RegularExpression>` is used as a match pattern against `<String>` to produce `<ReplacementString>`.
Instances of `{Tag}` will be replaced by `<ReplacementString>` in the message subject and body.

Added `replaceregex <RegularExpression> <ReplacementString> <Tag> <UserReplacement>` to the following commands:

gam create user gam update user gam update users gam update users gam draft message gam import message gam insert messageo gam create sendas gam update sendas gam signature gam vacation subject

The `<RegularExpression>` is used as a match pattern against `<UserReplacement>` to produce `<ReplacementString>`.
Instances of `{Tag}` will be replaced by `<ReplacementString>` in the indicated items.

For example, when adding a phone number to a signature, an unformatted number can be formatted:

replaceregex "(\d{3})(\d{3})(\d{4})" "(\1) \2-\3" Phone "9876543210" replaces 9876543210 with (987) 654-3210

replaceregex "(+\d{2})(\d{3})(\d{3})(\d{3})" "\1 \2 \3 \4" Phone "+61987654321" replaces +61421221506 with +61 987 654 321

7.05.18

Updated `gam calendars <CalendarEntity> show events` and `gam <UserTypeEntity> show events`
to display the event description according to `show_convert_cr_nl` in `gam.cfg`;
previously, GAM assumed `show_convert_cr_nl = true`.

show_convert_cr_nl = false description: Line 1 Line 2 Line 3

show_convert_cr_nl = true description: Line 1\nLine 2\nLine 3\n

7.05.17

Updated commands that delete drive ACLs to handle the following error:

ERROR: 403: cannotDeletePermission - The authenticated user does not have the required access to delete the permission.

7.05.16

Added option `transpose [<Boolean>]` to `redirect csv` that causes
GAM to transpose CSV output rows and columns. This will most useful
when a `countsonly` option is used in a `print` or `report` command.

7.05.15

Updated `gam <UserTypeEntity> get drivefile` and `gam <UserTypeEntity> create drivefile`
to allow downloading and uploading of Google Apps Scripts.

$ gam user user1@domain.com get drivefile 1ZY-YkS3E0OKipALra_XzfIh9cvxoILSbb8TRdHBFCpyB_mXI_J8FmjHv format json User: user1@domain.com, Download 1 Drive File User: user1@domain.com, Drive File: Test Project, Downloaded to: /Users/gamteam/GamWork/Test Project.json, Type: Google Doc $ gam user user2@domain.com create drivefile localfile "Test Project.json" mimetype application/vnd.google-apps.script+json drivefilename "Test Project" User: user2@domain.com, Drive File: Test Project(1Ok_svw55VTreZ5CzcViJDLfEzVRi-Un8D9eG6I5pIeVyRl2YsmNiy3C_), Created with content from: Test Project.json

7.05.14

Added the following License SKU:

ProductId SKUId Display Name 101039 1010390002 Assured Controls Plus

7.05.13

Updated license product names to match Google.

7.05.12

Fixed bug in `gam update chromepolicy` where `appid` was misinterpreted for `chrome.devices.kiosk` policies
and an error was generated.

ERROR: Chrome Policy Schema: customers/C123abc456/policySchemas/, Does not exist

7.05.11

Added the following License SKUs:

ProductId SKUId Display Name Google-Apps 1010070001 Google Workspace for Education Fundamentals Google-Apps 1010070004 Google Workspace for Education Gmail Only 101034 1010340007 Google Workspace for Education Fundamentals - Archived User

7.05.10

Updated various chat space commands to handle the following error:

ERROR: 503: serviceNotAvailable - The service is currently unavailable

7.05.09

Fixed bug in `gam calendars <CalendarEntity> print events matchfield attendeesstatus required accepted resource_calendar@resource.calendar.google.com`
that caused a trap.

Revision 1.14: download - view: text, markup, annotated - select for diffs
Fri Apr 25 11:01:06 2025 UTC (18 months, 3 weeks ago) by wiz
Branches: MAIN
Diff to: previous 1.13: preferred, colored
Changes since revision 1.13: +3 -2 lines
gam: adapt for setuptools 78

Bump PKGREVISION.

Revision 1.13: download - view: text, markup, annotated - select for diffs
Mon Mar 10 09:07:53 2025 UTC (20 months, 1 week ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2025Q1-base, pkgsrc-2025Q1
Diff to: previous 1.12: preferred, colored
Changes since revision 1.12: +3 -3 lines
gam: fix wheel name for latest setuptools and depend on it

ride update

Revision 1.12: download - view: text, markup, annotated - select for diffs
Mon Mar 10 09:02:51 2025 UTC (20 months, 1 week ago) by sborrill
Branches: MAIN
Diff to: previous 1.11: preferred, colored
Changes since revision 1.11: +3 -4 lines
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.

Revision 1.11: download - view: text, markup, annotated - select for diffs
Sat Mar 8 13:20:15 2025 UTC (20 months, 1 week ago) by wiz
Branches: MAIN
Diff to: previous 1.10: preferred, colored
Changes since revision 1.10: +3 -6 lines
gam: simplify package by using more of the Python infrastructure

adapt wheel name for latest setuptools and depend on it

Bump PKGREVISION.

Revision 1.10: download - view: text, markup, annotated - select for diffs
Fri Dec 13 13:33:44 2024 UTC (23 months ago) by sborrill
Branches: MAIN
CVS tags: pkgsrc-2024Q4-base, pkgsrc-2024Q4
Diff to: previous 1.9: preferred, colored
Changes since revision 1.9: +3 -3 lines
gam: Update to 7.02.00

- 7.02.00

Improved the error message displayed for user service account access commands when:

    The API is not enabled
    The user does not exist
    The user exists but is in a OU where the service is disabled

- 7.01.04

Admin role assignments are now in the v1 stable API, use that and remove custom local workaround for the beta. #1724

Remove duplicate local JSON discovery files. #1724

Suppress "UserWarning: Attribute's length must be..." messages on service accounts with long emails. #1725

Added options internal, internaldomains <DomainNameList> and external to these commands
that expand the options for viewing group members:

gam info group
gam print groups
gam print|show group-members
gam info cigroup
gam print cigroups
gam print|show cigroup-members

By default, when listing group members, GAM does not take the domain of the member into account.

    internal internaldomains <DomainNameList> - Display members whose domain is in <DomainNameList>
    external internaldomains <DomainNameList> - Display members whose domain is not in <DomainNameList>
    internal external internaldomains <DomainNameList> - Display all members, indicate their category: internal or external
    internaldomains <DomainNameList> - Defaults to value of domain in gam.cfg

Members without an email address, e.g. customer, chrome-os-device and cbcm-browser are considered internal.

- 7.01.03

Fixed bug in gam update cigroups <GroupEntity> delete|sync|update where cbcm-browser and chrome-os-device
addresses were not properly handled.

- 7.01.02

Added option positivecountsonly to gam <UserTypeEntity> print|show filecomments that causes
GAM to display the number of comments and replies only for files that have comments.

Added my_commentable_items to <DriveFileQueryShortcut> that can be used with
gam <UserTypeEntity> print|show filecomments my_commentable_items to speed up processing.

Updated code that uses the Domain Shared Contacts API with an HTTPS proxy to avoid a trap

- 7.01.01

Fixed bug in gam <UserTypeEntity> print|show filetree where no error message was generated
if a user had Drive disabled.

- 7.01.00

Fixed bug in gam update chromepolicy that caused some policy updates to fail.

Added option showhtml to gam <UserTypeEntity> print|show messages that, when used with showbody,
will display message body content of type HTML.

Added support for managing/displaying Chrome profiles.

- 7.00.40

Updated gam <UserTypeEntity> update serviceaccount to properly set the readonly scope
for [R] 35)  Meet API (supports readonly) as it is a special case.

Revision 1.9: download - view: text, markup, annotated - select for diffs
Tue Nov 19 15:35:39 2024 UTC (23 months, 3 weeks ago) by sborrill
Branches: MAIN
Diff to: previous 1.8: preferred, colored
Changes since revision 1.8: +15 -25 lines
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

Revision 1.8: download - view: text, markup, annotated - select for diffs
Mon Oct 14 06:45:58 2024 UTC (2 years, 1 month ago) by wiz
Branches: MAIN
Diff to: previous 1.7: preferred, colored
Changes since revision 1.7: +1 -3 lines
*: clean-up after python38 removal

Revision 1.7: download - view: text, markup, annotated - select for diffs
Wed Aug 28 13:20:33 2024 UTC (2 years, 2 months ago) by sborrill
Branches: MAIN
CVS tags: pkgsrc-2024Q3-base, pkgsrc-2024Q3
Diff to: previous 1.6: preferred, colored
Changes since revision 1.6: +17 -3 lines
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.

Revision 1.6: download - view: text, markup, annotated - select for diffs
Tue Aug 27 16:04:44 2024 UTC (2 years, 2 months ago) by sborrill
Branches: MAIN
Diff to: previous 1.5: preferred, colored
Changes since revision 1.5: +9 -5 lines
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

Revision 1.5: download - view: text, markup, annotated - select for diffs
Tue Nov 7 22:38:04 2023 UTC (3 years ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2024Q2-base, pkgsrc-2024Q2, pkgsrc-2024Q1-base, pkgsrc-2024Q1, pkgsrc-2023Q4-base, pkgsrc-2023Q4
Diff to: previous 1.4: preferred, colored
Changes since revision 1.4: +2 -2 lines
*: latest py-sphinx only support Python 3.9+

Revision 1.4: download - view: text, markup, annotated - select for diffs
Mon Aug 14 05:25:15 2023 UTC (3 years, 3 months ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2023Q3-base, pkgsrc-2023Q3
Diff to: previous 1.3: preferred, colored
Changes since revision 1.3: +2 -1 lines
*: recursive bump for Python 3.11 as new default

Revision 1.3: download - view: text, markup, annotated - select for diffs
Fri Oct 14 12:01:17 2022 UTC (4 years, 1 month ago) by sborrill
Branches: MAIN
CVS tags: pkgsrc-2023Q2-base, pkgsrc-2023Q2, pkgsrc-2023Q1-base, pkgsrc-2023Q1, pkgsrc-2022Q4-base, pkgsrc-2022Q4
Diff to: previous 1.2: preferred, colored
Changes since revision 1.2: +3 -3 lines
gam: update to 6.25

Disable automatic update check

Changes:

GAM now uses a list of certificate authorities provided by Google rather
than the old list provided by the httplib2 library. The file roots.pem
is distributed with GAM binaries as a separate file.

The usual fixes and upgrades.

Revision 1.2: download - view: text, markup, annotated - select for diffs
Sun Sep 4 18:56:05 2022 UTC (4 years, 2 months ago) by wiz
Branches: MAIN
CVS tags: pkgsrc-2022Q3-base, pkgsrc-2022Q3
Diff to: previous 1.1: preferred, colored
Changes since revision 1.1: +3 -1 lines
py-pathvalidate: does not support python 2.7

Revision 1.1: download - view: text, markup, annotated - select for diffs
Wed Aug 31 10:10:17 2022 UTC (4 years, 2 months ago) by sborrill
Branches: MAIN
gam: Add GAM 6.24

GAM is a command line tool for Google Workspace admins to manage domain and
user settings quickly and easily.

Diff request

This form allows you to request diffs between any two revisions of a file. You may select a symbolic revision name using the selection box or you may type in a numeric name using the type-in text box.

Log view options

CVSweb <webmaster@jp.NetBSD.org>