Added option showaccesssettings to gam [<UserTypeEntity>] print|show chatspaces

This commit is contained in:
Ross Scroggs
2025-09-01 12:35:55 -07:00
parent 74db8d503e
commit 076f9dd376
4 changed files with 37 additions and 13 deletions

View File

@@ -10,6 +10,13 @@ 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 See [Downloads-Installs-GAM7](https://github.com/GAM-team/GAM/wiki/Downloads-Installs) for Windows or other options, including manual installation
### 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 ### 7.20.00
Added initial support for student groups in Google Classroom. This is a work in progress and requires Developer Preview membership. Added initial support for student groups in Google Classroom. This is a work in progress and requires Developer Preview membership.

View File

@@ -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$ rm -f /Users/admin/GAMConfig/oauth2.txt
admin@server:/Users/admin$ gam version 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 WARNING: Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: /Users/admin/GAMConfig/oauth2.txt, Not Found
GAM 7.20.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.20.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.7 64-bit final Python 3.13.7 64-bit final
MacOS Sequoia 15.6.1 x86_64 MacOS Sequoia 15.6.1 x86_64
@@ -990,7 +990,7 @@ writes the credentials into the file oauth2.txt.
C:\>del C:\GAMConfig\oauth2.txt C:\>del C:\GAMConfig\oauth2.txt
C:\>gam version C:\>gam version
WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found
GAM 7.20.00 - https://github.com/GAM-team/GAM - pythonsource GAM 7.20.01 - https://github.com/GAM-team/GAM - pythonsource
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.7 64-bit final Python 3.13.7 64-bit final
Windows-10-10.0.17134 AMD64 Windows-10-10.0.17134 AMD64

View File

@@ -320,24 +320,32 @@ By default, Gam displays the information as an indented list of keys and values.
``` ```
gam <UserTypeEntity> show chatspaces gam <UserTypeEntity> show chatspaces
[types <ChatSpaceTypeList>] [types <ChatSpaceTypeList>]
[fields <ChatSpaceFieldNameList>] [fields <ChatSpaceFieldNameList>] [showaccessssettings]
[formatjson] [formatjson]
``` ```
By default, chat spaces of all types are displayed. By default, chat spaces of all types are displayed.
* `types <ChatSpaceTypeList>` - Display specific types of spaces. * `types <ChatSpaceTypeList>` - Display specific types of spaces.
When listing Chat Spaces, the Chat API does not return the `accessSettings` field; if you need to see this fieldf,
add `showaccesssettings` to the command. This requires an additional Chat API call per chat space of type `SPACE`
to get the `accessSettings` field.
By default, Gam displays the information as an indented list of keys and values. By default, Gam displays the information as an indented list of keys and values.
* `formatjson` - Display the fields in JSON format. * `formatjson` - Display the fields in JSON format.
``` ```
gam <UserTypeEntity> print chatspaces [todrive <ToDriveAttribute>*] gam <UserTypeEntity> print chatspaces [todrive <ToDriveAttribute>*]
[types <ChatSpaceTypeList>] [types <ChatSpaceTypeList>]
[fields <ChatSpaceFieldNameList>] [fields <ChatSpaceFieldNameList>] [showaccessssettings]
[formatjson [quotechar <Character>]] [formatjson [quotechar <Character>]]
``` ```
By default, chat spaces of all types are displayed. By default, chat spaces of all types are displayed.
* `types <ChatSpaceTypeList>` - Display specific types of spaces. * `types <ChatSpaceTypeList>` - Display specific types of spaces.
When listing Chat Spaces, the Chat API does not return the `accessSettings` field; if you need to see this fieldf,
add `showaccesssettings` to the command. This requires an additional Chat API call per chat space of type `SPACE`
to get the `accessSettings` field.
By default, Gam displays the information as columns of fields; the following option causes the output to be in JSON format, By default, Gam displays the information as columns of fields; the following option causes the output to be in JSON format,
* `formatjson` - Display the fields in JSON format. * `formatjson` - Display the fields in JSON format.
@@ -385,13 +393,17 @@ Only spaces of `<ChatSpaceType>` `space` are displayed; spaces of `<ChatSpaceTyp
gam <UserItem> show chatspaces asadmin gam <UserItem> show chatspaces asadmin
[query <String>] [querytime<String> <Time>] [query <String>] [querytime<String> <Time>]
[orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]] [orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
[fields <ChatSpaceFieldNameList>] [fields <ChatSpaceFieldNameList>] [showaccessssettings]
[formatjson] [formatjson]
``` ```
By default, all chat spaces of type SPACE are displayed. By default, all chat spaces of type SPACE are displayed.
* `query <String> [querytime<String> <Time>]` - Display selected chat spaces * `query <String> [querytime<String> <Time>]` - Display selected chat spaces
* See: https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search * See: https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search
When listing Chat Spaces, the Chat API does not return the `accessSettings` field; if you need to see this fieldf,
add `showaccesssettings` to the command. This requires an additional Chat API call per chat space of type `SPACE`
to get the `accessSettings` field.
By default, Gam displays the information as an indented list of keys and values. By default, Gam displays the information as an indented list of keys and values.
* `formatjson` - Display the fields in JSON format. * `formatjson` - Display the fields in JSON format.
@@ -399,13 +411,17 @@ By default, Gam displays the information as an indented list of keys and values.
gam <UserItem> print chatspaces asadmin [todrive <ToDriveAttribute>*] gam <UserItem> print chatspaces asadmin [todrive <ToDriveAttribute>*]
[query <String>] [querytime<String> <Time>] [query <String>] [querytime<String> <Time>]
[orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]] [orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
[fields <ChatSpaceFieldNameList>] [fields <ChatSpaceFieldNameList>] [showaccessssettings]
[formatjson [quotechar <Character>]] [formatjson [quotechar <Character>]]
``` ```
By default, all chat spaces of type SPACE are displayed. By default, all chat spaces of type SPACE are displayed.
* `query <String> [querytime<String> <Time>]` - Display selected chat spaces * `query <String> [querytime<String> <Time>]` - Display selected chat spaces
* See: https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search * See: https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces/search
When listing Chat Spaces, the Chat API does not return the `accessSettings` field; if you need to see this fieldf,
add `showaccesssettings` to the command. This requires an additional Chat API call per chat space of type `SPACE`
to get the `accessSettings` field.
By default, Gam displays the information as columns of fields; the following option causes the output to be in JSON format, By default, Gam displays the information as columns of fields; the following option causes the output to be in JSON format,
* `formatjson` - Display the fields in JSON format. * `formatjson` - Display the fields in JSON format.
@@ -975,8 +991,9 @@ The `quotechar <Character>` option allows you to choose an alternate quote chara
## Bulk Operations ## Bulk Operations
### Display information about all chat spaces for a collection of users ### Display information about all chat spaces for a collection of users
``` ```
gam config auto_batch_min 1 redirect csv ./ChatSpaces.csv multiprocess [todrive <ToDriveAttribute>*] redirect stdout - multiprocess redirect stderr <UserTypeEntity> print chatspaces gam config auto_batch_min 1 redirect csv ./ChatSpaces.csv multiprocess [todrive <ToDriveAttribute>*] redirect stdout - multiprocess redirect stderr <UserTypeEntity> print chatsacesp
[types <ChatSpaceTypeList>] [types <ChatSpaceTypeList>]
[fields <ChatSpaceFieldNameList>] [showaccessssettings]
[formatjson [quotechar <Character>]] [formatjson [quotechar <Character>]]
``` ```

View File

@@ -3,7 +3,7 @@
Print the current version of Gam with details Print the current version of Gam with details
``` ```
gam version gam version
GAM 7.20.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.20.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.7 64-bit final Python 3.13.7 64-bit final
MacOS Sequoia 15.6.1 x86_64 MacOS Sequoia 15.6.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 Print the current version of Gam with details and time offset information
``` ```
gam version timeoffset gam version timeoffset
GAM 7.20.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.20.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.7 64-bit final Python 3.13.7 64-bit final
MacOS Sequoia 15.6.1 x86_64 MacOS Sequoia 15.6.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 Print the current version of Gam with extended details and SSL information
``` ```
gam version extended gam version extended
GAM 7.20.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.20.01 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.7 64-bit final Python 3.13.7 64-bit final
MacOS Sequoia 15.6.1 x86_64 MacOS Sequoia 15.6.1 x86_64
@@ -64,7 +64,7 @@ MacOS High Sierra 10.13.6 x86_64
Path: /Users/Admin/bin/gam7 Path: /Users/Admin/bin/gam7
Version Check: Version Check:
Current: 5.35.08 Current: 5.35.08
Latest: 7.20.00 Latest: 7.20.01
echo $? echo $?
1 1
``` ```
@@ -72,7 +72,7 @@ echo $?
Print the current version number without details Print the current version number without details
``` ```
gam version simple gam version simple
7.20.00 7.20.01
``` ```
In Linux/MacOS you can do: In Linux/MacOS you can do:
``` ```
@@ -82,7 +82,7 @@ echo $VER
Print the current version of Gam and address of this Wiki Print the current version of Gam and address of this Wiki
``` ```
gam help gam help
GAM 7.20.00 - https://github.com/GAM-team/GAM GAM 7.20.01 - https://github.com/GAM-team/GAM
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.7 64-bit final Python 3.13.7 64-bit final
MacOS Sequoia 15.6.1 x86_64 MacOS Sequoia 15.6.1 x86_64