mirror of
https://github.com/GAM-team/GAM.git
synced 2026-07-03 12:21:35 +00:00
Compare commits
35 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
af94ea6e54 | ||
|
|
c220f41cbe | ||
|
|
8a32e53652 | ||
|
|
372f86a79a | ||
|
|
7f307254bf | ||
|
|
2ae7b4a4b5 | ||
|
|
6dde273ee9 | ||
|
|
b66f6f60fe | ||
|
|
01fcefc647 | ||
|
|
a59e3008c5 | ||
|
|
eb82da4ff2 | ||
|
|
c4aa399446 | ||
|
|
f1713ec685 | ||
|
|
74924c9c0e | ||
|
|
8d3b65f5f1 | ||
|
|
260f2d3f5c | ||
|
|
475275add7 | ||
|
|
d71832096a | ||
|
|
f12d3abfc1 | ||
|
|
474aa069b7 | ||
|
|
c49708cbae | ||
|
|
43ecba07bb | ||
|
|
51f8ebe8e2 | ||
|
|
28edce3aca | ||
|
|
fe1f0285f8 | ||
|
|
da83121d0d | ||
|
|
f58a69e374 | ||
|
|
2f40a164c5 | ||
|
|
58a3fa7313 | ||
|
|
39ce5b7349 | ||
|
|
860d44d819 | ||
|
|
5e90ff143e | ||
|
|
28e05bf09a | ||
|
|
0781e27993 | ||
|
|
a441dddc06 |
2
.github/workflows/build.yml
vendored
2
.github/workflows/build.yml
vendored
@@ -126,7 +126,7 @@ jobs:
|
|||||||
with:
|
with:
|
||||||
path: |
|
path: |
|
||||||
cache.tar.xz
|
cache.tar.xz
|
||||||
key: gam-${{ matrix.jid }}-20250603
|
key: gam-${{ matrix.jid }}-20250611
|
||||||
|
|
||||||
- name: Untar Cache archive
|
- name: Untar Cache archive
|
||||||
if: matrix.goal == 'build' && steps.cache-python-ssl.outputs.cache-hit == 'true'
|
if: matrix.goal == 'build' && steps.cache-python-ssl.outputs.cache-hit == 'true'
|
||||||
|
|||||||
@@ -1,4 +1,4 @@
|
|||||||
This document describes the GAM command line syntax in modified BNF, see https://en.wikipedia.org/wiki/Backus-Naur_Form
|
his document describes the GAM command line syntax in modified BNF, see https://en.wikipedia.org/wiki/Backus-Naur_Form
|
||||||
Skip the History section and start reading at Introduction.
|
Skip the History section and start reading at Introduction.
|
||||||
|
|
||||||
Items on the command line are space separated, when an actual space character is required, it will be indicated by <Space>.
|
Items on the command line are space separated, when an actual space character is required, it will be indicated by <Space>.
|
||||||
@@ -380,6 +380,8 @@ If an item contains spaces, it should be surrounded by ".
|
|||||||
domain:<DomainName>|domain|default
|
domain:<DomainName>|domain|default
|
||||||
<CalendarItem> ::= <EmailAddress>
|
<CalendarItem> ::= <EmailAddress>
|
||||||
<ChannelCustomerID> ::= <String>
|
<ChannelCustomerID> ::= <String>
|
||||||
|
<ChatEmojiName> ::= :<String>:
|
||||||
|
<ChatEmoji> ::= emojiname <ChatEmojiName> | customemojis/<String>
|
||||||
<ChatMember> ::= spaces/<String>/members/<String>
|
<ChatMember> ::= spaces/<String>/members/<String>
|
||||||
<ChatMessage> ::= spaces/<String>/messages/<String>
|
<ChatMessage> ::= spaces/<String>/messages/<String>
|
||||||
<ChatSpace> ::= spaces/<String> | space <String> | space spaces/<String>
|
<ChatSpace> ::= spaces/<String> | space <String> | space spaces/<String>
|
||||||
@@ -664,6 +666,7 @@ If an item contains spaces, it should be surrounded by ".
|
|||||||
(gdoc|ghtml <UserGoogleDoc>)|
|
(gdoc|ghtml <UserGoogleDoc>)|
|
||||||
(gcsdoc|gcshtml <StorageBucketObjectName>)
|
(gcsdoc|gcshtml <StorageBucketObjectName>)
|
||||||
<YouTubeChannelID> ::= <String>
|
<YouTubeChannelID> ::= <String>
|
||||||
|
|
||||||
## Lists of basic items
|
## Lists of basic items
|
||||||
|
|
||||||
<APIScopeURLList> ::= "<APIScopeURL>(,<APIScopeURL>)*"
|
<APIScopeURLList> ::= "<APIScopeURL>(,<APIScopeURL>)*"
|
||||||
@@ -2725,6 +2728,7 @@ gam print chromschemas [todrive <ToDriveAttribute>*]
|
|||||||
<ChromePolicySchemaFieldName>* [fields <ChromePolicySchemaFieldNameList>]
|
<ChromePolicySchemaFieldName>* [fields <ChromePolicySchemaFieldNameList>]
|
||||||
[[formatjson [quotechar <Character>]]
|
[[formatjson [quotechar <Character>]]
|
||||||
|
|
||||||
|
gam info chromeschema std <SchemaName>
|
||||||
gam show chromeschemas std
|
gam show chromeschemas std
|
||||||
[filter <String>]
|
[filter <String>]
|
||||||
|
|
||||||
@@ -4436,13 +4440,14 @@ gam report usage customer [todrive <ToDriveAttribute>*]
|
|||||||
calendar|calendars|
|
calendar|calendars|
|
||||||
chat|
|
chat|
|
||||||
chrome|
|
chrome|
|
||||||
|
classroom|
|
||||||
contextawareaccess|
|
contextawareaccess|
|
||||||
currents|gplus|google+|
|
currents|gplus|google+|
|
||||||
datastudio|
|
datastudio|
|
||||||
devices|mobile|
|
devices|mobile|
|
||||||
domain|
|
domain|
|
||||||
drive|doc|docs|
|
drive|doc|docs|
|
||||||
gcp|
|
gcp|cloud|
|
||||||
gemini|geminiforworkspace|
|
gemini|geminiforworkspace|
|
||||||
groups|group|
|
groups|group|
|
||||||
groupsenterprise|enterprisegroups|
|
groupsenterprise|enterprisegroups|
|
||||||
@@ -4461,7 +4466,7 @@ gam report <ActivityApplicationName> [todrive <ToDriveAttribute>*]
|
|||||||
[(user all|<UserItem>)|(orgunit|org|ou <OrgUnitPath> [showorgunit])|(select <UserTypeEntity>)]
|
[(user all|<UserItem>)|(orgunit|org|ou <OrgUnitPath> [showorgunit])|(select <UserTypeEntity>)]
|
||||||
[([start <Time>] [end <Time>])|(range <Time> <Time>)|
|
[([start <Time>] [end <Time>])|(range <Time> <Time>)|
|
||||||
yesterday|today|thismonth|(previousmonths <Integer>)]
|
yesterday|today|thismonth|(previousmonths <Integer>)]
|
||||||
[filtertime.* <Time>] [filter|filters <String>]
|
[filtertime.String> <Time>] [filter|filters <String>]
|
||||||
[event|events <EventNameList>] [ip <String>]
|
[event|events <EventNameList>] [ip <String>]
|
||||||
[groupidfilter <String>]
|
[groupidfilter <String>]
|
||||||
[maxactivities <Number>] [maxevents <Number>] [maxresults <Number>]
|
[maxactivities <Number>] [maxevents <Number>] [maxresults <Number>]
|
||||||
@@ -5030,18 +5035,18 @@ gam <UserTypeEntity> delete permissions <SharedDriveEntityAdmin> <DriveFilePermi
|
|||||||
|
|
||||||
In these commands, the Google administrator named in oauth2.txt is used.
|
In these commands, the Google administrator named in oauth2.txt is used.
|
||||||
|
|
||||||
gam copy teamdriveacls <SharedDriveEntity> to <SharedDriveEntity>
|
gam copy shareddriveacls <SharedDriveEntity> to <SharedDriveEntity>
|
||||||
[adminaccess|asadmin]
|
[adminaccess|asadmin]
|
||||||
[showpermissionsmessages [<Boolean>]]
|
[showpermissionsmessages [<Boolean>]]
|
||||||
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
||||||
(mappermissionsdomain <DomainName> <DomainName>)*
|
(mappermissionsdomain <DomainName> <DomainName>)*
|
||||||
gam sync teamdriveacls <SharedDriveEntity> with <SharedDriveEntity>
|
gam sync shareddriveacls <SharedDriveEntity> with <SharedDriveEntity>
|
||||||
[adminaccess|asadmin]
|
[adminaccess|asadmin]
|
||||||
[showpermissionsmessages [<Boolean>]]
|
[showpermissionsmessages [<Boolean>]]
|
||||||
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
||||||
(mappermissionsdomain <DomainName> <DomainName>)*
|
(mappermissionsdomain <DomainName> <DomainName>)*
|
||||||
|
|
||||||
gam print teamdriveacls [todrive <ToDriveAttribute>*]
|
gam print shareddriveacls [todrive <ToDriveAttribute>*]
|
||||||
[teamdriveadminquery|query <QueryTeamDrive>]
|
[teamdriveadminquery|query <QueryTeamDrive>]
|
||||||
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
||||||
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
||||||
@@ -5049,7 +5054,7 @@ gam print teamdriveacls [todrive <ToDriveAttribute>*]
|
|||||||
[oneitemperrow] [<DrivePermissionsFieldName>*|(fields <DrivePermissionsFieldNameList>)]
|
[oneitemperrow] [<DrivePermissionsFieldName>*|(fields <DrivePermissionsFieldNameList>)]
|
||||||
(addcsvdata <FieldName> <String>)*
|
(addcsvdata <FieldName> <String>)*
|
||||||
[formatjson [quotechar <Character>]]
|
[formatjson [quotechar <Character>]]
|
||||||
gam show teamdriveacls
|
gam show shareddriveacls
|
||||||
[teamdriveadminquery|query <QueryTeamDrive>]
|
[teamdriveadminquery|query <QueryTeamDrive>]
|
||||||
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
||||||
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
||||||
@@ -5059,18 +5064,18 @@ gam show teamdriveacls
|
|||||||
|
|
||||||
In these commands, you specify an administrator and then indicate that you want domain administrator access with the adminaccess option.
|
In these commands, you specify an administrator and then indicate that you want domain administrator access with the adminaccess option.
|
||||||
|
|
||||||
gam <UserTypeEntity> copy teamdriveacls <SharedDriveEntity> to <SharedDriveEntity>
|
gam <UserTypeEntity> copy shareddriveacls <SharedDriveEntity> to <SharedDriveEntity>
|
||||||
[adminaccess|asadmin]
|
[adminaccess|asadmin]
|
||||||
[showpermissionsmessages [<Boolean>]]
|
[showpermissionsmessages [<Boolean>]]
|
||||||
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
||||||
(mappermissionsdomain <DomainName> <DomainName>)*
|
(mappermissionsdomain <DomainName> <DomainName>)*
|
||||||
gam <UserTypeEntity> sync teamdriveacls <SharedDriveEntity> with <SharedDriveEntity>
|
gam <UserTypeEntity> sync shareddriveacls <SharedDriveEntity> with <SharedDriveEntity>
|
||||||
[adminaccess|asadmin]
|
[adminaccess|asadmin]
|
||||||
[showpermissionsmessages [<Boolean>]]
|
[showpermissionsmessages [<Boolean>]]
|
||||||
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
[excludepermissionsfromdomains|includepermissionsfromdomains <DomainNameList>]
|
||||||
(mappermissionsdomain <DomainName> <DomainName>)*
|
(mappermissionsdomain <DomainName> <DomainName>)*
|
||||||
|
|
||||||
gam <UserTypeEntity> print teamdriveacls [todrive <ToDriveAttribute>*]
|
gam <UserTypeEntity> print shareddriveacls [todrive <ToDriveAttribute>*]
|
||||||
[adminaccess|asadmin] [teamdriveadminquery|query <QueryTeamDrive>]
|
[adminaccess|asadmin] [teamdriveadminquery|query <QueryTeamDrive>]
|
||||||
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
||||||
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
||||||
@@ -5079,7 +5084,7 @@ gam <UserTypeEntity> print teamdriveacls [todrive <ToDriveAttribute>*]
|
|||||||
[shownopermissionsdrives false|true|only]
|
[shownopermissionsdrives false|true|only]
|
||||||
(addcsvdata <FieldName> <String>)*
|
(addcsvdata <FieldName> <String>)*
|
||||||
[formatjson [quotechar <Character>]]
|
[formatjson [quotechar <Character>]]
|
||||||
gam <UserTypeEntity> show teamdriveacls
|
gam <UserTypeEntity> show shareddriveacls
|
||||||
[adminaccess|asadmin] [teamdriveadminquery|query <QueryTeamDrive>]
|
[adminaccess|asadmin] [teamdriveadminquery|query <QueryTeamDrive>]
|
||||||
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
[matchname <REMatchPattern>] [orgunit|org|ou <OrgUnitPath>]
|
||||||
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
[user|group <EmailAddress> [checkgroups]] (role|roles <SharedDriveACLRoleList>)*
|
||||||
@@ -6435,6 +6440,22 @@ gam <UserTypeEntity> print chatevents [todrive <ToDriveAttribute>*]
|
|||||||
filter <String>
|
filter <String>
|
||||||
[formatjson [quotechar <Character>]]
|
[formatjson [quotechar <Character>]]
|
||||||
|
|
||||||
|
<ChatEmojiName> ::= :[0-9a-z_-]+:
|
||||||
|
<ChatEmoji> ::= emojiname <ChatEmojiName> | customemojis/<String>
|
||||||
|
|
||||||
|
gam <UserTypeEntity> create chatemoji <ChatEmojiName>
|
||||||
|
([drivedir|(sourcefolder <FilePath>)] [filename <FileNamePattern>])
|
||||||
|
[formatjson]
|
||||||
|
gam <UserTypeEntity> delete chatemoji <ChatEmoji>
|
||||||
|
gam <UserTypeEntity> info chatemoji <ChatEmoji>
|
||||||
|
[formatjson]
|
||||||
|
gam <UserTypeEntity> show chatemojis
|
||||||
|
[showcreatedby any|me|others]
|
||||||
|
[formatjson]
|
||||||
|
gam <UserTypeEntity> print chatemojis [todrive <ToDriveAttribute>*]
|
||||||
|
[showcreatedby any|me|others]
|
||||||
|
[formatjson [quotechar <Character>]]
|
||||||
|
|
||||||
# Users - Drive
|
# Users - Drive
|
||||||
|
|
||||||
<DriveFileOrderByFieldName> ::=
|
<DriveFileOrderByFieldName> ::=
|
||||||
@@ -7203,7 +7224,8 @@ gam <UserTypeEntity> show filesharecounts
|
|||||||
owners|
|
owners|
|
||||||
parents|
|
parents|
|
||||||
size|
|
size|
|
||||||
trashed
|
trashed|
|
||||||
|
webviewlink
|
||||||
<FileTreeFieldNameList> ::= "<FileTreeFieldName>(,<FileTreeFieldName>)*"
|
<FileTreeFieldNameList> ::= "<FileTreeFieldName>(,<FileTreeFieldName>)*"
|
||||||
|
|
||||||
gam <UserTypeEntity> print filetree [todrive <ToDriveAttribute>*]
|
gam <UserTypeEntity> print filetree [todrive <ToDriveAttribute>*]
|
||||||
@@ -7396,10 +7418,12 @@ gam <UserTypeEntity> print filters [labelidsonly] [todrive <ToDriveAttribute>*]
|
|||||||
|
|
||||||
gam <UserTypeEntity> create form
|
gam <UserTypeEntity> create form
|
||||||
title <String> [description <String>] [isquiz [<Boolean>]] [<JSONData>]
|
title <String> [description <String>] [isquiz [<Boolean>]] [<JSONData>]
|
||||||
|
[ispublished [<Boolean>] isacceptingresponses [<Boolean>]]
|
||||||
[drivefilename <DriveFileName>] [<DriveFileParentAttribute>]
|
[drivefilename <DriveFileName>] [<DriveFileParentAttribute>]
|
||||||
[(csv [todrive <ToDriveAttribute>*]) | returnidonly]
|
[(csv [todrive <ToDriveAttribute>*]) | returnidonly]
|
||||||
gam <UserTypeEntity> update form <DriveFileEntity>
|
gam <UserTypeEntity> update form <DriveFileEntity>
|
||||||
[title <String>] [description <String>] [isquiz [<Boolean>]] [<JSONData>]
|
[title <String>] [description <String>] [isquiz [<Boolean>]] [<JSONData>]
|
||||||
|
[ispublished [<Boolean>] isacceptingresponses [<Boolean>]]
|
||||||
|
|
||||||
gam <UserTypeEntity> print forms <DriveFileEntity> [todrive <ToDriveAttribute>*]
|
gam <UserTypeEntity> print forms <DriveFileEntity> [todrive <ToDriveAttribute>*]
|
||||||
(addcsvdata <FieldName> <String>)*
|
(addcsvdata <FieldName> <String>)*
|
||||||
|
|||||||
@@ -1,3 +1,67 @@
|
|||||||
|
7.10.01
|
||||||
|
|
||||||
|
Added options `ispublished [<Boolean>]` and `isacceptingresponses [<Boolean>]` to
|
||||||
|
`gam <UserTypeEntity> create|update form`.
|
||||||
|
|
||||||
|
7.10.00
|
||||||
|
|
||||||
|
Added commands to manage/display Chat Custom Emojis.
|
||||||
|
|
||||||
|
* See: https://github.com/GAM-team/GAM/wiki/Users-Chat#manage-chat-emojis
|
||||||
|
* See: https://github.com/GAM-team/GAM/wiki/Users-Chat#display-chat-emojis
|
||||||
|
|
||||||
|
Updated `gam <UserItem> print|show chatspaces|chatmembers asadmin` to display
|
||||||
|
the spaces in ascending display name order.
|
||||||
|
|
||||||
|
7.09.07
|
||||||
|
|
||||||
|
Added `webviewlink` to `<FileTreeFieldName>` for use in `gam <UserTypeEntity> print|show filetree`.
|
||||||
|
|
||||||
|
7.09.06
|
||||||
|
|
||||||
|
Upddated `gam print|show shareddrives`, `gam print|show shareddriveacls`, `gam print shareddriveorganizers`
|
||||||
|
to display the Shared Drives in ascending name order; the API returns them in an unidentifiable order.
|
||||||
|
|
||||||
|
7.09.05
|
||||||
|
|
||||||
|
Improved output of `gam info|show chromeschemas [std]` to more accurately display the schemas.
|
||||||
|
|
||||||
|
Fixed bugs in `gam update chromepolicy` that caused invalid error messaages.
|
||||||
|
|
||||||
|
7.09.04
|
||||||
|
|
||||||
|
Fixed bug in `gam whatis <EmailItem>` where the check for an invitable user always failed.
|
||||||
|
|
||||||
|
Fixed bug in `gam print shareddriveorganizers` where no organizers were displayed when `domain` in `gam.cfg` was blank.
|
||||||
|
|
||||||
|
Updated to Python 3.13.5
|
||||||
|
|
||||||
|
7.09.03
|
||||||
|
|
||||||
|
Updated `gam <UserTypeEntity> create focustime|outofoffice ... timerange <Time> <Time>` to check
|
||||||
|
that the first `<Time>` is less than the second `Time`; previously the event was not created.
|
||||||
|
|
||||||
|
For new installs the `enforce_expansive_access` Boolean variable in `gam.cfg` now defaults to True.
|
||||||
|
For existing installations, if `enforce_expansive_access` has not been added to `gam.cfg`,
|
||||||
|
a default value of True will be used.
|
||||||
|
|
||||||
|
7.09.02
|
||||||
|
|
||||||
|
Added command `gam info chromeschema std <SchemaName>` to display a Chrome policy schema in the same format as Legacy GAM.
|
||||||
|
|
||||||
|
Improved output of `gam show chromeschemas [std]` and `gam info chromeschema [std]` to more accurately display the schemas.
|
||||||
|
|
||||||
|
7.09.01
|
||||||
|
|
||||||
|
Fixed bug in `gam <UserTypeEntity> print diskusage` where the `ownedByMe` column was
|
||||||
|
blank for the top folder.
|
||||||
|
|
||||||
|
Fixed bug in `gam update chromepolicy` where the following error was generated
|
||||||
|
when updating policies with simple numerical values.
|
||||||
|
```
|
||||||
|
ERROR: Missing argument: Expected <value>"
|
||||||
|
```
|
||||||
|
|
||||||
7.09.00
|
7.09.00
|
||||||
|
|
||||||
Removed the overly broad service account `IAM and Access Management API` scope `https://www.googleapis.com/auth/cloud-platform`
|
Removed the overly broad service account `IAM and Access Management API` scope `https://www.googleapis.com/auth/cloud-platform`
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -26,6 +26,7 @@ ANALYTICS_ADMIN = 'analyticsadmin'
|
|||||||
CALENDAR = 'calendar'
|
CALENDAR = 'calendar'
|
||||||
CBCM = 'cbcm'
|
CBCM = 'cbcm'
|
||||||
CHAT = 'chat'
|
CHAT = 'chat'
|
||||||
|
CHAT_CUSTOM_EMOJIS = 'chatcustomemojis'
|
||||||
CHAT_EVENTS = 'chatevents'
|
CHAT_EVENTS = 'chatevents'
|
||||||
CHAT_MEMBERSHIPS = 'chatmemberships'
|
CHAT_MEMBERSHIPS = 'chatmemberships'
|
||||||
CHAT_MEMBERSHIPS_ADMIN = 'chatmembershipsadmin'
|
CHAT_MEMBERSHIPS_ADMIN = 'chatmembershipsadmin'
|
||||||
@@ -210,6 +211,7 @@ _INFO = {
|
|||||||
CALENDAR: {'name': 'Calendar API', 'version': 'v3', 'v2discovery': True, 'mappedAPI': 'calendar-json'},
|
CALENDAR: {'name': 'Calendar API', 'version': 'v3', 'v2discovery': True, 'mappedAPI': 'calendar-json'},
|
||||||
CBCM: {'name': 'Chrome Browser Cloud Management API', 'version': 'v1.1beta1', 'v2discovery': True, 'localjson': True},
|
CBCM: {'name': 'Chrome Browser Cloud Management API', 'version': 'v1.1beta1', 'v2discovery': True, 'localjson': True},
|
||||||
CHAT: {'name': 'Chat API', 'version': 'v1', 'v2discovery': True},
|
CHAT: {'name': 'Chat API', 'version': 'v1', 'v2discovery': True},
|
||||||
|
CHAT_CUSTOM_EMOJIS: {'name': 'Chat API - Custom Emojis', 'version': 'v1', 'v2discovery': True, 'mappedAPI': CHAT},
|
||||||
CHAT_EVENTS: {'name': 'Chat API - Events', 'version': 'v1', 'v2discovery': True, 'mappedAPI': CHAT},
|
CHAT_EVENTS: {'name': 'Chat API - Events', 'version': 'v1', 'v2discovery': True, 'mappedAPI': CHAT},
|
||||||
CHAT_MEMBERSHIPS: {'name': 'Chat API - Memberships', 'version': 'v1', 'v2discovery': True, 'mappedAPI': CHAT},
|
CHAT_MEMBERSHIPS: {'name': 'Chat API - Memberships', 'version': 'v1', 'v2discovery': True, 'mappedAPI': CHAT},
|
||||||
CHAT_MEMBERSHIPS_ADMIN: {'name': 'Chat API - Memberships Admin', 'version': 'v1', 'v2discovery': True, 'mappedAPI': CHAT},
|
CHAT_MEMBERSHIPS_ADMIN: {'name': 'Chat API - Memberships Admin', 'version': 'v1', 'v2discovery': True, 'mappedAPI': CHAT},
|
||||||
@@ -544,6 +546,10 @@ _SVCACCT_SCOPES = [
|
|||||||
'api': CALENDAR,
|
'api': CALENDAR,
|
||||||
'subscopes': READONLY,
|
'subscopes': READONLY,
|
||||||
'scope': 'https://www.googleapis.com/auth/calendar'},
|
'scope': 'https://www.googleapis.com/auth/calendar'},
|
||||||
|
{'name': 'Chat API - Custom Emojis',
|
||||||
|
'api': CHAT_CUSTOM_EMOJIS,
|
||||||
|
'subscopes': READONLY,
|
||||||
|
'scope': 'https://www.googleapis.com/auth/chat.customemojis'},
|
||||||
{'name': 'Chat API - Memberships',
|
{'name': 'Chat API - Memberships',
|
||||||
'api': CHAT_MEMBERSHIPS,
|
'api': CHAT_MEMBERSHIPS,
|
||||||
'subscopes': READONLY,
|
'subscopes': READONLY,
|
||||||
@@ -644,7 +650,7 @@ _SVCACCT_SCOPES = [
|
|||||||
'api': GMAIL,
|
'api': GMAIL,
|
||||||
'subscopes': [],
|
'subscopes': [],
|
||||||
'scope': 'https://www.googleapis.com/auth/gmail.modify'},
|
'scope': 'https://www.googleapis.com/auth/gmail.modify'},
|
||||||
{'name': 'Gmail API - Basic Settings (Filters,IMAP, Language, POP, Vacation) - read/write, Sharing Settings (Delegates, Forwarding, SendAs) - read',
|
{'name': 'Gmail API - Basic Settings (Filters, IMAP, Language, POP, Vacation) - read/write, Sharing Settings (Delegates, Forwarding, SendAs) - read',
|
||||||
'api': GMAIL,
|
'api': GMAIL,
|
||||||
'subscopes': [],
|
'subscopes': [],
|
||||||
'scope': 'https://www.googleapis.com/auth/gmail.settings.basic'},
|
'scope': 'https://www.googleapis.com/auth/gmail.settings.basic'},
|
||||||
|
|||||||
@@ -379,7 +379,7 @@ Defaults = {
|
|||||||
DEVICE_MAX_RESULTS: '200',
|
DEVICE_MAX_RESULTS: '200',
|
||||||
DOMAIN: '',
|
DOMAIN: '',
|
||||||
DRIVE_DIR: '',
|
DRIVE_DIR: '',
|
||||||
ENFORCE_EXPANSIVE_ACCESS: FALSE,
|
ENFORCE_EXPANSIVE_ACCESS: TRUE,
|
||||||
DRIVE_MAX_RESULTS: '1000',
|
DRIVE_MAX_RESULTS: '1000',
|
||||||
DRIVE_V3_BETA: FALSE,
|
DRIVE_V3_BETA: FALSE,
|
||||||
DRIVE_V3_NATIVE_NAMES: TRUE,
|
DRIVE_V3_NATIVE_NAMES: TRUE,
|
||||||
|
|||||||
@@ -461,6 +461,8 @@ class GamCLArgs():
|
|||||||
ARG_CHANNELSKU = 'channelsku'
|
ARG_CHANNELSKU = 'channelsku'
|
||||||
ARG_CHANNELSKUS = 'channelskus'
|
ARG_CHANNELSKUS = 'channelskus'
|
||||||
ARG_CHAT = 'chat'
|
ARG_CHAT = 'chat'
|
||||||
|
ARG_CHATEMOJI = 'chatemoji'
|
||||||
|
ARG_CHATEMOJIS = 'chatemojis'
|
||||||
ARG_CHATEVENT = 'chatevent'
|
ARG_CHATEVENT = 'chatevent'
|
||||||
ARG_CHATEVENTS = 'chatevents'
|
ARG_CHATEVENTS = 'chatevents'
|
||||||
ARG_CHATMEMBER = 'chatmember'
|
ARG_CHATMEMBER = 'chatmember'
|
||||||
@@ -843,6 +845,8 @@ class GamCLArgs():
|
|||||||
OB_CHARACTER = 'Character'
|
OB_CHARACTER = 'Character'
|
||||||
OB_CHAR_SET = 'CharacterSet'
|
OB_CHAR_SET = 'CharacterSet'
|
||||||
OG_CHAT_ATTACHMENT = 'ChatAttachment'
|
OG_CHAT_ATTACHMENT = 'ChatAttachment'
|
||||||
|
OB_CHAT_EMOJI = 'ChatEmoji'
|
||||||
|
OB_CHAT_EMOJI_NAME = 'ChatEmojiName'
|
||||||
OB_CHAT_EVENT = 'ChatEvent'
|
OB_CHAT_EVENT = 'ChatEvent'
|
||||||
OB_CHAT_MEMBER = 'ChatMember'
|
OB_CHAT_MEMBER = 'ChatMember'
|
||||||
OB_CHAT_MESSAGE = 'ChatMessage'
|
OB_CHAT_MESSAGE = 'ChatMessage'
|
||||||
@@ -930,6 +934,7 @@ class GamCLArgs():
|
|||||||
OB_FILE_NAME = 'FileName'
|
OB_FILE_NAME = 'FileName'
|
||||||
OB_FILE_NAME_FIELD_NAME = OB_FILE_NAME+'(:'+OB_FIELD_NAME+')+'
|
OB_FILE_NAME_FIELD_NAME = OB_FILE_NAME+'(:'+OB_FIELD_NAME+')+'
|
||||||
OB_FILE_NAME_OR_URL = 'FileName|URL'
|
OB_FILE_NAME_OR_URL = 'FileName|URL'
|
||||||
|
OB_FILE_NAME_PATTERN = 'FileNamePattern'
|
||||||
OB_FILE_PATH = 'FilePath'
|
OB_FILE_PATH = 'FilePath'
|
||||||
OB_FILTER_ID_ENTITY = 'FilterIDEntity'
|
OB_FILTER_ID_ENTITY = 'FilterIDEntity'
|
||||||
OB_FORMAT_LIST = 'FormatList'
|
OB_FORMAT_LIST = 'FormatList'
|
||||||
@@ -975,7 +980,6 @@ class GamCLArgs():
|
|||||||
OB_PERMISSION_ID_LIST = 'PermissionIDList'
|
OB_PERMISSION_ID_LIST = 'PermissionIDList'
|
||||||
OB_PERMISSION_ROLE_LIST = 'PermissionRoleList'
|
OB_PERMISSION_ROLE_LIST = 'PermissionRoleList'
|
||||||
OB_PERMISSION_TYPE_LIST = 'PermissionTypeList'
|
OB_PERMISSION_TYPE_LIST = 'PermissionTypeList'
|
||||||
OB_PHOTO_FILENAME_PATTERN = 'FilenameNamePattern'
|
|
||||||
OB_PRINTER_ID = 'PrinterID'
|
OB_PRINTER_ID = 'PrinterID'
|
||||||
OB_PRIVILEGE_LIST = 'PrivilegeList'
|
OB_PRIVILEGE_LIST = 'PrivilegeList'
|
||||||
OB_PRODUCT_ID = 'ProductID'
|
OB_PRODUCT_ID = 'ProductID'
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
|
|
||||||
# Copyright (C) 2024 Ross Scroggs All Rights Reserved.
|
# Copyright (C) 2025 Ross Scroggs All Rights Reserved.
|
||||||
#
|
#
|
||||||
# All Rights Reserved.
|
# All Rights Reserved.
|
||||||
#
|
#
|
||||||
@@ -86,6 +86,7 @@ class GamEntity():
|
|||||||
CHANNEL_SKU = 'chsk'
|
CHANNEL_SKU = 'chsk'
|
||||||
CHAT_BOT = 'chbo'
|
CHAT_BOT = 'chbo'
|
||||||
CHAT_ADMIN = 'chad'
|
CHAT_ADMIN = 'chad'
|
||||||
|
CHAT_EMOJI = 'chem'
|
||||||
CHAT_EVENT = 'chev'
|
CHAT_EVENT = 'chev'
|
||||||
CHAT_MANAGER_USER = 'chgu'
|
CHAT_MANAGER_USER = 'chgu'
|
||||||
CHAT_MEMBER = 'chme'
|
CHAT_MEMBER = 'chme'
|
||||||
@@ -436,6 +437,7 @@ class GamEntity():
|
|||||||
CHANNEL_SKU: ['Channel SKUs', 'Channel SKU'],
|
CHANNEL_SKU: ['Channel SKUs', 'Channel SKU'],
|
||||||
CHAT_BOT: ['Chat BOTs', 'Chat BOT'],
|
CHAT_BOT: ['Chat BOTs', 'Chat BOT'],
|
||||||
CHAT_ADMIN: ['Chat Admins', 'Chat Admin'],
|
CHAT_ADMIN: ['Chat Admins', 'Chat Admin'],
|
||||||
|
CHAT_EMOJI: ['Chat Emojis', 'Chat Emoji'],
|
||||||
CHAT_EVENT: ['Chat Events', 'Chat Event'],
|
CHAT_EVENT: ['Chat Events', 'Chat Event'],
|
||||||
CHAT_MANAGER_USER: ['Chat User Managers', 'Chat User Manager'],
|
CHAT_MANAGER_USER: ['Chat User Managers', 'Chat User Manager'],
|
||||||
CHAT_MESSAGE: ['Chat Messages', 'Chat Message'],
|
CHAT_MESSAGE: ['Chat Messages', 'Chat Message'],
|
||||||
|
|||||||
@@ -309,7 +309,9 @@ INVALID_ALIAS = 'Invalid Alias'
|
|||||||
INVALID_ATTENDEE_CHANGE = 'Invalid attendee change "{0}"'
|
INVALID_ATTENDEE_CHANGE = 'Invalid attendee change "{0}"'
|
||||||
INVALID_CHARSET = 'Invalid charset "{0}"'
|
INVALID_CHARSET = 'Invalid charset "{0}"'
|
||||||
INVALID_DATE_TIME_RANGE = '{0} {1} must be greater than/equal to {2} {3}'
|
INVALID_DATE_TIME_RANGE = '{0} {1} must be greater than/equal to {2} {3}'
|
||||||
|
INVALID_EMOJI_NAME = '{0} does not match pattern :[0-9a-z_-]:'
|
||||||
INVALID_ENTITY = 'Invalid {0}, {1}'
|
INVALID_ENTITY = 'Invalid {0}, {1}'
|
||||||
|
INVALID_EVENT_TIMERANGE = '{0} {1} must be less than {2}'
|
||||||
INVALID_FILE_SELECTION_WITH_ADMIN_ACCESS = 'Invalid file selection with adminaccess|asadmin'
|
INVALID_FILE_SELECTION_WITH_ADMIN_ACCESS = 'Invalid file selection with adminaccess|asadmin'
|
||||||
INVALID_GROUP = 'Invalid Group'
|
INVALID_GROUP = 'Invalid Group'
|
||||||
INVALID_HTTP_HEADER = 'Invalid http header data: {0}'
|
INVALID_HTTP_HEADER = 'Invalid http header data: {0}'
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
|
|
||||||
# Copyright (C) 2023 Ross Scroggs All Rights Reserved.
|
# Copyright (C) 2025 Ross Scroggs All Rights Reserved.
|
||||||
#
|
#
|
||||||
# All Rights Reserved.
|
# All Rights Reserved.
|
||||||
#
|
#
|
||||||
|
|||||||
@@ -1,6 +1,6 @@
|
|||||||
# -*- coding: utf-8 -*-
|
# -*- coding: utf-8 -*-
|
||||||
|
|
||||||
# Copyright (C) 2023 Ross Scroggs All Rights Reserved.
|
# Copyright (C) 2025 Ross Scroggs All Rights Reserved.
|
||||||
#
|
#
|
||||||
# All Rights Reserved.
|
# All Rights Reserved.
|
||||||
#
|
#
|
||||||
|
|||||||
@@ -96,7 +96,7 @@
|
|||||||
banana|basil|blueberry|flamingo|graphite|grape|
|
banana|basil|blueberry|flamingo|graphite|grape|
|
||||||
lavender|peacock|sage|tangerine|tomato
|
lavender|peacock|sage|tangerine|tomato
|
||||||
<FileFormat> ::=
|
<FileFormat> ::=
|
||||||
csv|doc|dot|docx|dotx|epub|html|jpeg|jpg|mht|odp|ods|odt|
|
csv|doc|dot|docx|dotx|epub|html|jpeg|jpg|json|mht|odp|ods|odt|
|
||||||
pdf|png|ppt|pot|potx|pptx|rtf|svg|tsv|txt|xls|xlt|xlsx|xltx|zip|
|
pdf|png|ppt|pot|potx|pptx|rtf|svg|tsv|txt|xls|xlt|xlsx|xltx|zip|
|
||||||
ms|microsoft|openoffice|
|
ms|microsoft|openoffice|
|
||||||
<LabelColorHex> ::=
|
<LabelColorHex> ::=
|
||||||
@@ -278,6 +278,8 @@
|
|||||||
domain:<DomainName>|domain|default
|
domain:<DomainName>|domain|default
|
||||||
<CalendarItem> ::= <EmailAddress>
|
<CalendarItem> ::= <EmailAddress>
|
||||||
<ChannelCustomerID> ::= <String>
|
<ChannelCustomerID> ::= <String>
|
||||||
|
<ChatEmojiName> ::= :[0-9a-z_-]+:
|
||||||
|
<ChatEmoji> ::= emojiname <ChatEmojiName> | customemojis/<String>
|
||||||
<ChatMember> ::= spaces/<String>/members/<String>
|
<ChatMember> ::= spaces/<String>/members/<String>
|
||||||
<ChatMessage> ::= spaces/<String>/messages/<String>
|
<ChatMessage> ::= spaces/<String>/messages/<String>
|
||||||
<ChatSpace> ::= spaces/<String> | space <String> | space spaces/<String>
|
<ChatSpace> ::= spaces/<String> | space <String> | space spaces/<String>
|
||||||
|
|||||||
File diff suppressed because it is too large
Load Diff
@@ -10,6 +10,65 @@ 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.10.00
|
||||||
|
|
||||||
|
Added commands to manage/display Chat Custom Emojis.
|
||||||
|
|
||||||
|
* See: https://github.com/GAM-team/GAM/wiki/Users-Chat#manage-chat-emojis
|
||||||
|
* See: https://github.com/GAM-team/GAM/wiki/Users-Chat#display-chat-emojis
|
||||||
|
|
||||||
|
Updated `gam <UserItem> print|show chatspaces|chatmembers asadmin` to display
|
||||||
|
the spaces in ascending display name order.
|
||||||
|
|
||||||
|
### 7.09.07
|
||||||
|
|
||||||
|
Added `webviewlink` to `<FileTreeFieldName>` for use in `gam <UserTypeEntity> print|show filetree`.
|
||||||
|
|
||||||
|
### 7.09.06
|
||||||
|
|
||||||
|
Upddated `gam print|show shareddrives`, `gam print|show shareddriveacls`, `gam print shareddriveorganizers`
|
||||||
|
to display the Shared Drives in ascending name order; the API returns them in an unidentifiable order.
|
||||||
|
|
||||||
|
### 7.09.05
|
||||||
|
|
||||||
|
Improved output of `gam info|show chromeschemas [std]` to more accurately display the schemas.
|
||||||
|
|
||||||
|
Fixed bugs in `gam update chromepolicy` that caused invalid error messaages.
|
||||||
|
|
||||||
|
### 7.09.04
|
||||||
|
|
||||||
|
Fixed bug in `gam whatis <EmailItem>` where the check for an invitable user always failed.
|
||||||
|
|
||||||
|
Fixed bug in `gam print shareddriveorganizers` where no organizers were displayed when `domain` in `gam.cfg` was blank.
|
||||||
|
|
||||||
|
Updated to Python 3.13.5
|
||||||
|
|
||||||
|
### 7.09.03
|
||||||
|
|
||||||
|
Updated `gam <UserTypeEntity> create focustime|outofoffice ... timerange <Time> <Time>` to check
|
||||||
|
that the first `<Time>` is less than the second `Time`; previously the event was not created.
|
||||||
|
|
||||||
|
For new installs the `enforce_expansive_access` Boolean variable in `gam.cfg` now defaults to True.
|
||||||
|
For existing installations, if `enforce_expansive_access` has not been added to `gam.cfg`,
|
||||||
|
a default value of True will be used.
|
||||||
|
|
||||||
|
### 7.09.02
|
||||||
|
|
||||||
|
Added command `gam info chromeschema std <SchemaName>` to display a Chrome policy schema in the same format as Legacy GAM.
|
||||||
|
|
||||||
|
Improved output of `gam show chromeschemas [std]` and `gam info chromeschema [std]` to more accurately display the schemas.
|
||||||
|
|
||||||
|
### 7.09.01
|
||||||
|
|
||||||
|
Fixed bug in `gam <UserTypeEntity> print diskusage` where the `ownedByMe` column was
|
||||||
|
blank for the top folder.
|
||||||
|
|
||||||
|
Fixed bug in `gam update chromepolicy` where the following error was generated
|
||||||
|
when updating policies with simple numerical values.
|
||||||
|
```
|
||||||
|
ERROR: Missing argument: Expected <value>"
|
||||||
|
```
|
||||||
|
|
||||||
### 7.09.00
|
### 7.09.00
|
||||||
|
|
||||||
Removed the overly broad service account `IAM and Access Management API` scope `https://www.googleapis.com/auth/cloud-platform`
|
Removed the overly broad service account `IAM and Access Management API` scope `https://www.googleapis.com/auth/cloud-platform`
|
||||||
|
|||||||
@@ -152,7 +152,7 @@ gam update group|groups <GroupEntity> create|add [<GroupRole>]
|
|||||||
[preview] [actioncsv]
|
[preview] [actioncsv]
|
||||||
<UserItem>|<UserTypeEntity>
|
<UserItem>|<UserTypeEntity>
|
||||||
```
|
```
|
||||||
To add a group as a memmber of another group, just specify its email address.
|
To add a group as a member of another group, just specify its email address.
|
||||||
```
|
```
|
||||||
gam update group group1@domain.com add member group2@domain.com
|
gam update group group1@domain.com add member group2@domain.com
|
||||||
```
|
```
|
||||||
@@ -208,7 +208,7 @@ gam update group|groups <GroupEntity> delete|remove [<GroupRole>]
|
|||||||
```
|
```
|
||||||
`<GroupRole>` is ignored, deletions take place regardless of role.
|
`<GroupRole>` is ignored, deletions take place regardless of role.
|
||||||
|
|
||||||
To remove a group as a memmber of another group, just specify its email address.
|
To remove a group as a member of another group, just specify its email address.
|
||||||
```
|
```
|
||||||
gam update group group1@domain.com remove group2@domain.com
|
gam update group group1@domain.com remove group2@domain.com
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -251,9 +251,9 @@ 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.09.00 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.10.00 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.4 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
Path: /Users/admin/bin/gam7
|
Path: /Users/admin/bin/gam7
|
||||||
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
||||||
@@ -989,9 +989,9 @@ 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.09.00 - https://github.com/GAM-team/GAM - pythonsource
|
GAM 7.10.00 - https://github.com/GAM-team/GAM - pythonsource
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.4 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
Windows-10-10.0.17134 AMD64
|
Windows-10-10.0.17134 AMD64
|
||||||
Path: C:\GAM7
|
Path: C:\GAM7
|
||||||
Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
||||||
|
|||||||
@@ -11,7 +11,7 @@
|
|||||||
- [Synchronize licenses](#synchronize-licenses)
|
- [Synchronize licenses](#synchronize-licenses)
|
||||||
|
|
||||||
## API documentation
|
## API documentation
|
||||||
* [License Manager API](https://developers.google.com/admin-sdk/licensing/rest/v1/licenseAssignments)
|
* [License Manager API](https://developers.google.com/workspace/admin/licensing/reference/rest/v1/licenseAssignments)
|
||||||
|
|
||||||
## License Products and SKUs
|
## License Products and SKUs
|
||||||
* [Product and SKU IDs](https://developers.google.com/admin-sdk/licensing/v1/how-tos/products)
|
* [Product and SKU IDs](https://developers.google.com/admin-sdk/licensing/v1/how-tos/products)
|
||||||
|
|||||||
@@ -12,6 +12,8 @@
|
|||||||
- [Manage Chat Messages](#manage-chat-messages)
|
- [Manage Chat Messages](#manage-chat-messages)
|
||||||
- [Display Chat Messages](#display-chat-messages)
|
- [Display Chat Messages](#display-chat-messages)
|
||||||
- [Display Chat Events](#display-chat-events)
|
- [Display Chat Events](#display-chat-events)
|
||||||
|
- [Manage Chat Emojis](#manage-chat-emojis)
|
||||||
|
- [Display Chat Emojis](#display-chat-emojis)
|
||||||
- [Bulk Operations](#bulk-operations)
|
- [Bulk Operations](#bulk-operations)
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
@@ -19,6 +21,7 @@ To use these commands you must update your service account authorization.
|
|||||||
```
|
```
|
||||||
gam user user@domain.com update serviceaccount
|
gam user user@domain.com update serviceaccount
|
||||||
|
|
||||||
|
[*] 3) Chat API - Custom Emojis (supports readonly)
|
||||||
[*] 4) Chat API - Memberships (supports readonly)
|
[*] 4) Chat API - Memberships (supports readonly)
|
||||||
[*] 5) Chat API - Memberships Admin (supports readonly)
|
[*] 5) Chat API - Memberships Admin (supports readonly)
|
||||||
[*] 6) Chat API - Messages (supports readonly)
|
[*] 6) Chat API - Messages (supports readonly)
|
||||||
@@ -51,10 +54,12 @@ Google requires that you have a Chat Bot configured in order to use the Chat API
|
|||||||
## API documentation
|
## API documentation
|
||||||
* [Overview](https://developers.google.com/workspace/chat/overview)
|
* [Overview](https://developers.google.com/workspace/chat/overview)
|
||||||
* [Chat API](https://developers.google.com/workspace/chat/api/reference/rest)
|
* [Chat API](https://developers.google.com/workspace/chat/api/reference/rest)
|
||||||
|
* [Chat API - Custom Emojis](https://developers.google.com/workspace/chat/api/reference/rest/v1/customEmojis)
|
||||||
* [Chat API - Members](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members/list)
|
* [Chat API - Members](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.members/list)
|
||||||
* [Chat API - Messages](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/list)
|
* [Chat API - Messages](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.messages/list)
|
||||||
* [Chat API - Events](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents/list)
|
* [Chat API - Events](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces.spaceEvents/list)
|
||||||
* [Apps in Google Chat](https://support.google.com/chat/answer/7655820)
|
* [Apps in Google Chat](https://support.google.com/chat/answer/7655820)
|
||||||
|
* [Manage customemoji permissions](https://support.google.com/a/answer/12850085)
|
||||||
* [Manage Spaces in Admin Console](https://support.google.com/a/answer/13369245)
|
* [Manage Spaces in Admin Console](https://support.google.com/a/answer/13369245)
|
||||||
* [Predefined permission settings](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces#Space.FIELDS.predefined_permission_settings)
|
* [Predefined permission settings](https://developers.google.com/workspace/chat/api/reference/rest/v1/spaces#Space.FIELDS.predefined_permission_settings)
|
||||||
|
|
||||||
@@ -83,6 +88,8 @@ Google requires that you have a Chat Bot configured in order to use the Chat API
|
|||||||
(gdoc <UserGoogleDoc>)|
|
(gdoc <UserGoogleDoc>)|
|
||||||
(gcsdoc <StorageBucketObjectName>))
|
(gcsdoc <StorageBucketObjectName>))
|
||||||
|
|
||||||
|
<ChatEmojiName> ::= :[0-9a-z_-]+:
|
||||||
|
<ChatEmoji> ::= emojiname <ChatEmojiName> | customemojis/<String>
|
||||||
<ChatEvent> ::= spaces/<String>/spaceEvents/<String>
|
<ChatEvent> ::= spaces/<String>/spaceEvents/<String>
|
||||||
<ChatMember> ::= spaces/<String>/members/<String>
|
<ChatMember> ::= spaces/<String>/members/<String>
|
||||||
<ChatMemberList> ::= "<ChatMember>(,<ChatMember>)*"
|
<ChatMemberList> ::= "<ChatMember>(,<ChatMember>)*"
|
||||||
@@ -896,6 +903,75 @@ filter 'start_time=\"2024-03-15T11:30:00-04:00\" AND event_types:\"google.worksp
|
|||||||
filter 'start_time=\"2024-03-15T11:30:00+00:00\" AND end_time=\"2024-03-3100:00:00+00:00\" AND event_types:\"google.workspace.chat.message.v1.created\"'
|
filter 'start_time=\"2024-03-15T11:30:00+00:00\" AND end_time=\"2024-03-3100:00:00+00:00\" AND event_types:\"google.workspace.chat.message.v1.created\"'
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Manage Chat Emojis
|
||||||
|
|
||||||
|
### Create a Chat Emoji
|
||||||
|
```
|
||||||
|
gam <UserTypeEntity> create chatemoji <ChatEmojiName>
|
||||||
|
([drivedir|(sourcefolder <FilePath>)] [filename <FileNamePattern>])
|
||||||
|
[formatjson]
|
||||||
|
```
|
||||||
|
Emoji names must start and end with colons, must be lowercase and can only contain alphanumeric characters, hyphens, and underscores.
|
||||||
|
Hyphens and underscores should be used to separate words and cannot be used consecutively.
|
||||||
|
|
||||||
|
By default, the emoji file will be uploaded from the current working directory.
|
||||||
|
* `drivedir` - The emoji file will be uploaded from the directory specified by `drive_dir` in gam.cfg
|
||||||
|
* `sourcefolder <FilePath>` - The emoji file will be uploaded from `<FilePath>`
|
||||||
|
|
||||||
|
Specify the emoji file name; the following substitutions will be made:
|
||||||
|
* `#email#` and `#user#` will be replaced by the user's full email address
|
||||||
|
* `#username#` will be replaced by the local part of the user's email address
|
||||||
|
|
||||||
|
### Delete a Chat Emoji
|
||||||
|
Deletes the given Chat emoji.
|
||||||
|
|
||||||
|
```
|
||||||
|
gam <UserTypeEntity> delete chatemoji <Chatemoji>
|
||||||
|
```
|
||||||
|
|
||||||
|
## Display Chat Emojis
|
||||||
|
### Display a specific Chat emoji
|
||||||
|
|
||||||
|
```
|
||||||
|
gam <UserTypeEntity> info chatemoji <Chatemoji>
|
||||||
|
[formatjson]
|
||||||
|
```
|
||||||
|
By default, Gam displays the information as an indented list of keys and values.
|
||||||
|
* `formatjson` - Display the fields in JSON format.
|
||||||
|
|
||||||
|
### Display information about all chat emojis
|
||||||
|
```
|
||||||
|
gam <UserTypeEntity> show chatemojis
|
||||||
|
[showcreatedby any|me|others]
|
||||||
|
[formatjson]
|
||||||
|
```
|
||||||
|
Select emojis to display:
|
||||||
|
* `showcreatedby any` - Display all emojis regardless of creator
|
||||||
|
* `showcreatedby ` - Display all emojis created by the user; this is the default
|
||||||
|
* `showcreatedby others` - Display all emojis not created by the user
|
||||||
|
|
||||||
|
By default, Gam displays the information as an indented list of keys and values.
|
||||||
|
* `formatjson` - Display the fields in JSON format.
|
||||||
|
|
||||||
|
```
|
||||||
|
gam <UserTypeEntity> print chatemojis [todrive <ToDriveAttribute>*]
|
||||||
|
[showcreatedby any|me|others]
|
||||||
|
[formatjson [quotechar <Character>]]
|
||||||
|
```
|
||||||
|
Select emojis to display:
|
||||||
|
* `showcreatedby any` - Display all emojis regardless of creator
|
||||||
|
* `showcreatedby ` - Display all emojis created by the user; this is the default
|
||||||
|
* `showcreatedby others` - Display all emojis not created by the user
|
||||||
|
|
||||||
|
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.
|
||||||
|
|
||||||
|
By default, when writing CSV files, Gam uses a quote character of double quote `"`. The quote character is used to enclose columns that contain
|
||||||
|
the quote character itself, the column delimiter (comma by default) and new-line characters. Any quote characters within the column are doubled.
|
||||||
|
When using the `formatjson` option, double quotes are used extensively in the data resulting in hard to read/process output.
|
||||||
|
The `quotechar <Character>` 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.
|
||||||
|
|
||||||
## 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
|
||||||
```
|
```
|
||||||
|
|||||||
@@ -968,7 +968,8 @@ Display a list of file/folder names indented to show structure.
|
|||||||
owners|
|
owners|
|
||||||
parents|
|
parents|
|
||||||
size|
|
size|
|
||||||
trashed
|
trashed|
|
||||||
|
webviewlink
|
||||||
<FileTreeFieldNameList> ::= "<FileTreeFieldName>(,<FileTreeFieldName>)*"
|
<FileTreeFieldNameList> ::= "<FileTreeFieldName>(,<FileTreeFieldName>)*"
|
||||||
|
|
||||||
gam <UserTypeEntity> print filetree [todrive <ToDriveAttribute>*]
|
gam <UserTypeEntity> print filetree [todrive <ToDriveAttribute>*]
|
||||||
|
|||||||
@@ -3,9 +3,9 @@
|
|||||||
Print the current version of Gam with details
|
Print the current version of Gam with details
|
||||||
```
|
```
|
||||||
gam version
|
gam version
|
||||||
GAM 7.09.00 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.10.00 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.4 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
Path: /Users/Admin/bin/gam7
|
Path: /Users/Admin/bin/gam7
|
||||||
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
||||||
@@ -15,9 +15,9 @@ 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.09.00 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.10.00 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.4 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
Path: /Users/Admin/bin/gam7
|
Path: /Users/Admin/bin/gam7
|
||||||
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
||||||
@@ -27,9 +27,9 @@ 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.09.00 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.10.00 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.4 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
Path: /Users/Admin/bin/gam7
|
Path: /Users/Admin/bin/gam7
|
||||||
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
||||||
@@ -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.09.00
|
Latest: 7.10.00
|
||||||
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.09.00
|
7.10.00
|
||||||
```
|
```
|
||||||
In Linux/MacOS you can do:
|
In Linux/MacOS you can do:
|
||||||
```
|
```
|
||||||
@@ -82,9 +82,9 @@ 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.09.00 - https://github.com/GAM-team/GAM
|
GAM 7.10.00 - https://github.com/GAM-team/GAM
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.4 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
Path: /Users/Admin/bin/gam7
|
Path: /Users/Admin/bin/gam7
|
||||||
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, customer_id: my_customer, domain: domain.com
|
||||||
|
|||||||
@@ -337,7 +337,7 @@ enforce_expansive_access
|
|||||||
gam <UserTypeEntity> move drivefile
|
gam <UserTypeEntity> move drivefile
|
||||||
gam <UserTypeEntity> transfer ownership
|
gam <UserTypeEntity> transfer ownership
|
||||||
gam <UserTypeEntity> claim ownership
|
gam <UserTypeEntity> claim ownership
|
||||||
Default: False
|
Default: True
|
||||||
event_max_results
|
event_max_results
|
||||||
When retrieving lists of Calendar events from API,
|
When retrieving lists of Calendar events from API,
|
||||||
how many should be retrieved in each API call
|
how many should be retrieved in each API call
|
||||||
|
|||||||
Reference in New Issue
Block a user