gam7 7.20.0__tar.gz → 7.20.1__tar.gz

{gam7-7.20.0 → gam7-7.20.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: gam7
-Version: 7.20.0
+Version: 7.20.1
 Summary: CLI tool to manage Google Workspace
 Project-URL: Homepage, https://github.com/GAM-team/GAM
 Project-URL: Issues, https://github.com/GAM-team/GAM/issues

{gam7-7.20.0 → gam7-7.20.1}/src/GamCommands.txt

@@ -2000,10 +2000,10 @@ gam info chatspace <ChatSpace>
         [fields <ChatSpaceFieldNameList>]
         [formatjson]
 gam show chatspaces
-        [fields <ChatSpaceFieldNameList>]
+        [fields <ChatSpaceFieldNameList>] [showaccessssettings]
         [formatjson]
 gam print chatspaces [todrive <ToDriveAttribute>*]
-        [fields <ChatSpaceFieldNameList>]
+        [fields <ChatSpaceFieldNameList>] [showaccessssettings]
         [formatjson [quotechar <Character>]]
 
 <ChatMemberFieldName> ::=
@@ -6409,11 +6409,11 @@ gam <UserTypeEntity> info chatspacedm <UserItem>
         [formatjson]
 gam <UserTypeEntity> show chatspaces
         [types <ChatSpaceTypeList>]
-        [fields <ChatSpaceFieldNameList>]
+        [fields <ChatSpaceFieldNameList>] [showaccessssettings]
         [formatjson]
 gam <UserTypeEntity> print chatspaces [todrive <ToDriveAttribute>*]
         [types <ChatSpaceTypeList>]
-        [fields <ChatSpaceFieldNameList>]
+        [fields <ChatSpaceFieldNameList>] [showaccessssettings]
         [formatjson [quotechar <Character>]]
 
 gam <UserItem> info chatspace asadmin <ChatSpace>
@@ -6422,12 +6422,12 @@ gam <UserItem> info chatspace asadmin <ChatSpace>
 gam <UserItem> show chatspaces asadmin
         [query <String>] [querytime<String> <Time>]
         [orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
-        [fields <ChatSpaceFieldNameList>]
+        [fields <ChatSpaceFieldNameList>] [showaccessssettings]
         [formatjson]
 gam <UserItem> print chatspaces asadmin [todrive <ToDriveAttribute>*]
         [query <String>] [querytime<String> <Time>]
         [orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
-        [fields <ChatSpaceFieldNameList>]
+        [fields <ChatSpaceFieldNameList>] [showaccessssettings]
         [formatjson [quotechar <Character>]]
 
 gam <UserTypeEntity> create chatmember <ChatSpace>

{gam7-7.20.0 → gam7-7.20.1}/src/GamUpdate.txt

@@ -1,3 +1,10 @@
+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.

{gam7-7.20.0 → gam7-7.20.1}/src/gam/__init__.py

@@ -25,7 +25,7 @@ https://github.com/GAM-team/GAM/wiki
 """
 
 __author__ = 'GAM Team <google-apps-manager@googlegroups.com>'
-__version__ = '7.20.00'
+__version__ = '7.20.01'
 __license__ = 'Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0)'
 
 #pylint: disable=wrong-import-position
@@ -27004,31 +27004,33 @@ CHAT_SPACES_ADMIN_ORDERBY_CHOICE_MAP = {
 
 # gam [<UserTypeEntity>] show chatspaces
 #	[types <ChatSpaceTypeList>]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson]
 # gam [<UserTypeEntity>] print chatspaces [todrive <ToDriveAttribute>*]
 #	[types <ChatSpaceTypeList>]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson [quotechar <Character>]]
 # gam <UserItem> show chatspaces asadmin
 #	[query <String>] [querytime<String> <Time>]
 #	[orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson]
 # gam <UserItem> print chatspaces asadmin [todrive <ToDriveAttribute>*]
 #	[query <String>] [querytime<String> <Time>]
 #	[orderby <ChatSpaceAdminOrderByFieldName> [ascending|descending]]
-#	[fields <ChatSpaceFieldNameList>]
+#	[fields <ChatSpaceFieldNameList>] [showaccesssettings]
 #	[formatjson [quotechar <Character>]]
 def printShowChatSpaces(users):
   csvPF = CSVPrintFile(['User', 'name'] if not isinstance(users, list) else ['name']) if Act.csvFormat() else None
   FJQC = FormatJSONQuoteChar(csvPF)
   OBY = OrderBy(CHAT_SPACES_ADMIN_ORDERBY_CHOICE_MAP)
   useAdminAccess, api, kwargsCS = _getChatAdminAccess(API.CHAT_SPACES_ADMIN, API.CHAT_SPACES)
+  kwargsSAS = {'useAdminAccess': useAdminAccess}
   fieldsList = []
   queries = []
   queryTimes = {}
   pfilter = ''
+  showAccessSettings = False
   if useAdminAccess:
     function = 'search'
     queries = ['customer = "customers/my_customer" AND spaceType = "SPACE"']
@@ -27044,8 +27046,12 @@ def printShowChatSpaces(users):
       pass
     elif useAdminAccess and _getChatSpaceSearchParms(myarg, queries, queryTimes, OBY):
       pass
+    elif myarg == 'showaccesssettings':
+      showAccessSettings = True
     else:
       FJQC.GetFormatJSONQuoteChar(myarg, True)
+  if showAccessSettings and fieldsList:
+    fieldsList.extend(['name', 'spaceType'])
   fields = getItemFieldsFromFieldsList('spaces', fieldsList)
   i, count, users = getEntityArgument(users)
   if useAdminAccess:
@@ -27070,6 +27076,17 @@ def printShowChatSpaces(users):
                                            GAPI.PERMISSION_DENIED, GAPI.FAILED_PRECONDITION],
                              retryReasons=GAPI.SERVICE_NOT_AVAILABLE_RETRY_REASONS,
                              fields=fields, pageSize=CHAT_PAGE_SIZE, **kwargsCS)
+      if showAccessSettings:
+        for space in spaces:
+          if space['spaceType'] == 'SPACE':
+            try:
+              result = callGAPI(chat.spaces(), 'get',
+                                throwReasons=[GAPI.NOT_FOUND, GAPI.INVALID_ARGUMENT, GAPI.INTERNAL_ERROR,
+                                              GAPI.PERMISSION_DENIED, GAPI.FAILED_PRECONDITION],
+                                name=space['name'], fields='accessSettings', **kwargsSAS)
+              space.update(result)
+            except (GAPI.notFound, GAPI.invalidArgument, GAPI.internalError, GAPI.permissionDenied, GAPI.failedPrecondition):
+              pass
     except (GAPI.notFound, GAPI.invalidArgument, GAPI.internalError, GAPI.permissionDenied) as e:
       exitIfChatNotConfigured(chat, kvList, str(e), i, count)
       continue

{gam7-7.20.0 → gam7-7.20.1}/wiki/Classroom-StudentGroups.md

@@ -12,6 +12,7 @@
 
 ## Notes
 These commands wera added in version 7.20.00.
+
 To use these commands your project must be enrolled the Developer Preview program.
 * https://developers.google.com/workspace/preview
 
@@ -36,7 +37,7 @@ You will need an API key
 Issue the following GAM command:
 `gam config developer_preview_api_key <API Key Value> save`
 
-Once you get an email from Google that your project has been registered you can use these commands.
+Once you get an email from Google saying that your project has been registered you can use these commands.
 
 ## API documentation
 * [Google Classroom API](https://developers.google.com/classroom/reference/rest)
@@ -85,7 +86,6 @@ See: [Lists and Collections](Lists-and-Collections)
 
 ## Manage student groups
 
-These commands can process multiple courses and `add` and `delete` can process multiple students/teachers.
 ```
 gam create course-studentgroups
         (course|class <CourseEntity>)*|([teacher <UserItem>] [student <UserItem>] [states <CourseStateList>])
@@ -97,6 +97,8 @@ gam clear course-studentgroups
         (course|class <CourseEntity>)*|([teacher <UserItem>] [student <UserItem>] [states <CourseStateList>])
 ```
 
+The `update|delete course-studentgroups` commands manage a specific course.
+
 By default, the `create|clear course-studentgroups` commands manage student group information about all courses.
 
 To manage student group information for a specific set of courses, use the following option; it can be repeated to select multiple courses.

{gam7-7.20.0 → gam7-7.20.1}/wiki/GamUpdates.md

@@ -10,6 +10,11 @@ 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.20.00
+
+Added initial support for student groups in Google Classroom. This is a work in progress and requires Developer Preview membership.
+* See: https://github.com/GAM-team/GAM/wiki/Classroom-StudentGroups#notes
+
 ### 7.19.03
 
 Fixed bug where specifying a `<UserItem>` as `id:1234567890` could lead to errors like this:

{gam7-7.20.0 → gam7-7.20.1}/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.19.03 - https://github.com/GAM-team/GAM - pyinstaller
+GAM 7.20.00 - https://github.com/GAM-team/GAM - pyinstaller
 GAM Team <google-apps-manager@googlegroups.com>
 Python 3.13.7 64-bit final
 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:\>gam version
 WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found
-GAM 7.19.03 - https://github.com/GAM-team/GAM - pythonsource
+GAM 7.20.00 - https://github.com/GAM-team/GAM - pythonsource
 GAM Team <google-apps-manager@googlegroups.com>
 Python 3.13.7 64-bit final
 Windows-10-10.0.17134 AMD64

{gam7-7.20.0 → gam7-7.20.1}/wiki/Version-and-Help.md

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