Update guest user support #1874

This commit is contained in:
Ross Scroggs
2026-04-28 16:39:14 -07:00
parent 1b7e736caf
commit c2192674ff
5 changed files with 63 additions and 12 deletions

View File

@@ -3,9 +3,19 @@
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)
- [User Type Entity](#user-type-entity) - [User Type Entity](#user-type-entity)
- [All non-archived Users](#all-non-archived-users)
- [All archived Users](#all-archived-Users)
- [All non-suspended Users](#all-non-suspended-users) - [All non-suspended Users](#all-non-suspended-users)
- [All suspended Users](#all-suspended-Users) - [All suspended Users](#all-suspended-Users)
- [All archived or suspended Users](#all-archived-or-suspended-users)
- [All non-archived and non-suspended Users](#all-non-archived-and-non-suspended-users)
- [All non-suspended and suspended Users](#all-non-suspended-and-suspended-users) - [All non-suspended and suspended Users](#all-non-suspended-and-suspended-users)
- [All non-suspended Guests](#all-non-suspended-guests)
- [All suspended Guests](#all-suspended-Guests)
- [All non-suspended and suspended Guests](#all-non-suspended-and-suspended-guests)
- [All non-suspended Users and Guests](#all-non-suspended-users-and-guests)
- [All suspended Users and Guests](#all-suspended-users-and-guests)
- [All non-suspended and suspended Users and Guests](#all-non-suspended-and-suspended-users-and-guests)
- [A single User](#a-single-user) - [A single User](#a-single-user)
- [A list of Users](#a-list-of-users) - [A list of Users](#a-list-of-users)
- [The admin user referenced in oauth2.txt](#the-admin-user-referenced-in-oauth2txt) - [The admin user referenced in oauth2.txt](#the-admin-user-referenced-in-oauth2txt)
@@ -40,6 +50,18 @@
## Notes ## Notes
The following items referencing guest users were added to `<UserTypeEntity>` in version 7.43.00.
```
all_guests
all_guests_ns
all_guests_susp
all_guests_ns_susp
all_users_and_guests
all_users_and_guests_ns
all_users_and_guests_susp
all_users_and_guests_ns_susp
```
The followig items referencing non-archived/archived users were added to `<UserTypeEntity>` in version 7.22.00. The followig items referencing non-archived/archived users were added to `<UserTypeEntity>` in version 7.22.00.
``` ```
all users_na all users_na
@@ -123,6 +145,8 @@ ous_and_children_na_ns
<UserTypeEntity> ::= <UserTypeEntity> ::=
(all users|users_na|users_arch|users_ns|users_susp|users_ns_susp|users_arch_or_susp|users_na_ns)| (all users|users_na|users_arch|users_ns|users_susp|users_ns_susp|users_arch_or_susp|users_na_ns)|
(all guests|guests_ns|guests_susp|guests_ns_susp)|
(all users_and_guests|users_and_guests_ns|users_and_guests_susp|users_and_guests_ns_susp)|
(user <UserItem>)| (user <UserItem>)|
(users <UserList>)| (users <UserList>)|
(oauthuser) (oauthuser)
@@ -232,6 +256,26 @@ Use these options to select users for GAM commands.
## All non-suspended and suspended Users ## All non-suspended and suspended Users
* `all users_ns_susp` * `all users_ns_susp`
## All non-suspended Guests
* `all guests`
* `all guests_ns`
## All suspended Guests
* `all guests_susp`
## All non-suspended and suspended Guests
* `all guests_ns_susp`
## All non-suspended Users and Guests
* `all users_and_guests`
* `all users_and_guests_ns`
## All suspended Users and Guests
* `all users_and_guests_susp`
## All non-suspended and suspended Users and Guests
* `all users_and_guests_ns_susp`
## A single User ## A single User
* `user <UserItem>` * `user <UserItem>`

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.43.00
Updated `gam info user` and `gam print users` to display guest user attributes: `isGuestUser, guestAccountInfo`
Expanded `<UserTypeEntity>` to allow specification of guest users.
* See [Collections of Users](Collections-of-Users)
### 7.42.00 ### 7.42.00
In versions prior to 7.42.00, when `redirect csv <FileName>` was used, GAM did not open and write `<FileName>` In versions prior to 7.42.00, when `redirect csv <FileName>` was used, GAM did not open and write `<FileName>`

View File

@@ -251,7 +251,7 @@ writes the credentials into the file oauth2.txt.
``` ```
gamteam@server:/Users/gamteam$ rm -f /Users/gamteam/GAMConfig/oauth2.txt gamteam@server:/Users/gamteam$ rm -f /Users/gamteam/GAMConfig/oauth2.txt
gamteam@server:/Users/gamteam$ gam version gamteam@server:/Users/gamteam$ gam version
GAM 7.42.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.00 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -1034,7 +1034,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
GAM 7.42.00 - https://github.com/GAM-team/GAM - pythonsource GAM 7.43.00 - https://github.com/GAM-team/GAM - pythonsource
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
Windows 11 10.0.26200 AMD64 Windows 11 10.0.26200 AMD64

View File

@@ -91,8 +91,8 @@ gam <UserItem> show meetconferences
[formatjson] [formatjson]
``` ```
By default, conferences are shown for all of a user's meet spaces. To limit the display use: By default, conferences are shown for all of a user's meet spaces. To limit the display use:
* `space <MeetSpaceName>` - Display conferences for a specifc space by giving its name * `space <MeetSpaceName>` - Display conferences for a specific space by giving its name
* `code <String>` - Display conferences for a specifc space by giving its code * `code <String>` - Display conferences for a specific space by giving its code
By default, Gam displays the information about the meet conferences as an indented list of keys and values. By default, Gam displays the information about the meet conferences as an indented list of keys and values.
* `formatjson` - Display the fields in JSON format. * `formatjson` - Display the fields in JSON format.
@@ -103,8 +103,8 @@ gam <UserItem> print meetconferences [todrive <ToDriveAttribute>*]
[formatjson [quotechar <Character>]] [formatjson [quotechar <Character>]]
``` ```
By default, conferences are shown for all of a user's meet spaces. To limit the display use: By default, conferences are shown for all of a user's meet spaces. To limit the display use:
* `space <MeetSpaceName>` - Display conferences for a specifc space by giving its name * `space <MeetSpaceName>` - Display conferences for a specific space by giving its name
* `code <String>` - Display conferences for a specifc space by giving its code * `code <String>` - Display conferences for a specific space by giving its code
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.

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.42.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.00 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -15,7 +15,7 @@ Time: 2026-02-15T07:51:00-08: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.42.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.00 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -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.42.00 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.00 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -68,7 +68,7 @@ MacOS High Sierra 10.13.6 x86_64
Path: /Users/gamteam/bin/gam7 Path: /Users/gamteam/bin/gam7
Version Check: Version Check:
Current: 5.35.08 Current: 5.35.08
Latest: 7.42.00 Latest: 7.43.00
echo $? echo $?
1 1
``` ```
@@ -76,7 +76,7 @@ echo $?
Print the current version number without details Print the current version number without details
``` ```
gam version simple gam version simple
7.42.00 7.43.00
``` ```
In Linux/MacOS you can do: In Linux/MacOS you can do:
``` ```
@@ -86,7 +86,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.42.00 - https://github.com/GAM-team/GAM GAM 7.43.00 - https://github.com/GAM-team/GAM
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64