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)
- [Definitions](#definitions)
- [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 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 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 list of Users](#a-list-of-users)
- [The admin user referenced in oauth2.txt](#the-admin-user-referenced-in-oauth2txt)
@@ -40,6 +50,18 @@
## 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.
```
all users_na
@@ -123,6 +145,8 @@ ous_and_children_na_ns
<UserTypeEntity> ::=
(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>)|
(users <UserList>)|
(oauthuser)
@@ -232,6 +256,26 @@ Use these options to select users for GAM commands.
## All non-suspended and suspended Users
* `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
* `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
### 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
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$ 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>
Python 3.14.4 64-bit final
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:\>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>
Python 3.14.4 64-bit final
Windows 11 10.0.26200 AMD64

View File

@@ -91,8 +91,8 @@ gam <UserItem> show meetconferences
[formatjson]
```
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
* `code <String>` - Display conferences for a specifc space by giving its code
* `space <MeetSpaceName>` - Display conferences for a specific space by giving its name
* `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.
* `formatjson` - Display the fields in JSON format.
@@ -103,8 +103,8 @@ gam <UserItem> print meetconferences [todrive <ToDriveAttribute>*]
[formatjson [quotechar <Character>]]
```
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
* `code <String>` - Display conferences for a specifc space by giving its code
* `space <MeetSpaceName>` - Display conferences for a specific space by giving its name
* `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,
* `formatjson` - Display the fields in JSON format.

View File

@@ -3,7 +3,7 @@
Print the current version of Gam with details
```
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>
Python 3.14.4 64-bit final
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
```
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>
Python 3.14.4 64-bit final
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
```
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>
Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64
@@ -68,7 +68,7 @@ MacOS High Sierra 10.13.6 x86_64
Path: /Users/gamteam/bin/gam7
Version Check:
Current: 5.35.08
Latest: 7.42.00
Latest: 7.43.00
echo $?
1
```
@@ -76,7 +76,7 @@ echo $?
Print the current version number without details
```
gam version simple
7.42.00
7.43.00
```
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.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>
Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64