diff --git a/wiki/GamUpdates.md b/wiki/GamUpdates.md index b5e82ea7..347bb552 100644 --- a/wiki/GamUpdates.md +++ b/wiki/GamUpdates.md @@ -10,6 +10,27 @@ Add the `-s` option to the end of the above commands to suppress creating the `g See [Downloads-Installs-GAM7](https://github.com/GAM-team/GAM/wiki/Downloads-Installs) for Windows or other options, including manual installation +### 7.27.03 + +Updated `gam 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 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 ` to `gam [] update chatmessage` diff --git a/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md b/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md index a2351589..d76599d2 100644 --- a/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md +++ b/wiki/How-to-Upgrade-Legacy-GAM-to-GAM7.md @@ -252,7 +252,7 @@ writes the credentials into the file oauth2.txt. admin@server:/Users/admin$ rm -f /Users/admin/GAMConfig/oauth2.txt admin@server:/Users/admin$ gam version WARNING: Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: /Users/admin/GAMConfig/oauth2.txt, Not Found -GAM 7.27.02 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.27.03 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.0.1 x86_64 @@ -990,7 +990,7 @@ writes the credentials into the file oauth2.txt. C:\>del C:\GAMConfig\oauth2.txt C:\>gam version WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found -GAM 7.27.02 - https://github.com/GAM-team/GAM - pythonsource +GAM 7.27.03 - https://github.com/GAM-team/GAM - pythonsource GAM Team Python 3.14.0 64-bit final Windows-10-10.0.17134 AMD64 diff --git a/wiki/Users-Chat.md b/wiki/Users-Chat.md index 4b9eab70..72f121d6 100644 --- a/wiki/Users-Chat.md +++ b/wiki/Users-Chat.md @@ -7,6 +7,7 @@ - [Chat Space Permissions](#chat-space-permissions) - [Manage Chat Spaces](#manage-chat-spaces) - [Display Chat Spaces](#display-chat-spaces) +- [UI API member role mapping](#ui-api-mwmber-role-mapping) - [Manage Chat Members](#manage-chat-members) - [Display Chat Members](#display-chat-members) - [Manage Chat Messages](#manage-chat-messages) @@ -211,7 +212,7 @@ For `type space`, the following apply: * `description ` - Optional * `guidelines ` - Optional * `history ` - Optional -* `announcement|collaboration` - Initial permission settings; default is `collaboration`; this is in Developer Preview +* `announcement|collaboration` - Initial permission settings; default is `collaboration` For `type groupchat`, the following apply: * `members ` - Required, must specify between 2 and 20 users @@ -244,30 +245,19 @@ gam update chatspace [type space] [description ] [guidelines|rules ] [history ]) - [managemembersandgroups managers|members] - [modifyspacedetails managers|members] - [togglehistory managers|members] - [useatmentionall managers|members] - [manageapps managers|members] - [managewebhooks managers|members] - [replymessages managers|members] + [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] [formatjson] ``` A groupchat space can be upgraded to a space by specifying `type space` and `displayname `. The `restricted|audience` options can not be combined with options `displayname,type,description,guidelines,history`. -You can manage permissions for chat spaces with the following options that are available with Developer Preview. - [managemembersandgroups managers|members] - [modifyspacedetails managers|members] - [togglehistory managers|members] - [useatmentionall managers|members] - [manageapps managers|members] - [managewebhooks managers|members] - [postmessages managers|members] - [replymessages managers|members] - - By default, Gam displays the information about the created chatspace as an indented list of keys and values. * `formatjson` - Display the fields in JSON format. @@ -432,11 +422,20 @@ When using the `formatjson` option, double quotes are used extensively in the da The `quotechar ` option allows you to choose an alternate quote character, single quote for instance, that makes for readable/processable output. `quotechar` defaults to `gam.cfg/csv_output_quote_char`. When uploading CSV files to Google, double quote `"` should be used. +## UI API member role mapping +GAM uses the Chat UI role names. + +| UI setting | API setting | +|------------|------------| +| Member | ROLE_MEMBER | +| Manager | ROLE_ASSISTANT_MANAGER | +| Owner | ROLE_MANAGER | + ## Manage Chat Members ### Add members to a user's chat space ``` gam create chatmember - [type human|bot] [role member|manager] + [type human|bot] [role member|manager|owner] (user )* (members )* (group )* (groups )* [formatjson|returnidonly] @@ -462,7 +461,7 @@ gam remove chatmember members Creating memberships for users outside the administrator's Google Workspace organization isn't supported using asadmin. ``` gam create chatmember asadmin - [type human|bot] [role member|manager] + [type human|bot] [role member|manager|owner] (user )* (members )* (group )* (groups )* [formatjson|returnidonly] @@ -488,13 +487,13 @@ gam remove chatmember asadmin members Update members by specifying a chat space, user/group email addresses and role. ``` gam update chatmember - role member|manager + role member|manager|owner ((user )|(members ))+ ``` Update members by specifying chatmember names and role. ``` gam modify chatmember - role member|manager + role member|manager|owner members ``` @@ -502,13 +501,13 @@ gam modify chatmember Update members by specifying a chat space, user/group email addresses and role. ``` gam update chatmember asadmin - role member|manager + role member|manager|owner ((user )|(members ))+ ``` Update members by specifying chatmember names and role. ``` gam modify chatmember asadmin - role member|manager + role member|manager|owner members ``` diff --git a/wiki/Version-and-Help.md b/wiki/Version-and-Help.md index cd89a2cd..9cd360e7 100644 --- a/wiki/Version-and-Help.md +++ b/wiki/Version-and-Help.md @@ -3,7 +3,7 @@ Print the current version of Gam with details ``` gam version -GAM 7.27.02 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.27.03 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.0.1 x86_64 @@ -15,7 +15,7 @@ Time: 2023-06-02T21:10:00-07:00 Print the current version of Gam with details and time offset information ``` gam version timeoffset -GAM 7.27.02 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.27.03 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.0.1 x86_64 @@ -27,7 +27,7 @@ Your system time differs from www.googleapis.com by less than 1 second Print the current version of Gam with extended details and SSL information ``` gam version extended -GAM 7.27.02 - https://github.com/GAM-team/GAM - pyinstaller +GAM 7.27.03 - https://github.com/GAM-team/GAM - pyinstaller GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.0.1 x86_64 @@ -68,7 +68,7 @@ MacOS High Sierra 10.13.6 x86_64 Path: /Users/Admin/bin/gam7 Version Check: Current: 5.35.08 - Latest: 7.27.02 + Latest: 7.27.03 echo $? 1 ``` @@ -76,7 +76,7 @@ echo $? Print the current version number without details ``` gam version simple -7.27.02 +7.27.03 ``` In Linux/MacOS you can do: ``` @@ -86,7 +86,7 @@ echo $VER Print the current version of Gam and address of this Wiki ``` gam help -GAM 7.27.02 - https://github.com/GAM-team/GAM +GAM 7.27.03 - https://github.com/GAM-team/GAM GAM Team Python 3.14.0 64-bit final macOS Tahoe 26.0.1 x86_64