Compare commits

..

10 Commits

Author SHA1 Message Date
Jay Lee
6fe196bd97 GAM 7.00.39
Some checks are pending
Build and test GAM / build (Win64, build, 9, VC-WIN64A, windows-2022) (push) Waiting to run
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Waiting to run
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Waiting to run
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Waiting to run
Build and test GAM / build (aarch64, build, 8, darwin64-arm64, macos-15) (push) Waiting to run
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Waiting to run
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Waiting to run
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.9) (push) Waiting to run
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.10) (push) Waiting to run
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.11) (push) Waiting to run
Build and test GAM / build (x86_64, test, 13, ubuntu-24.04, 3.12) (push) Waiting to run
Build and test GAM / merge (push) Blocked by required conditions
Build and test GAM / publish (push) Blocked by required conditions
CodeQL / Analyze (python) (push) Waiting to run
Check for Google Root CA Updates / check-apis (push) Waiting to run
2024-11-15 19:18:09 +00:00
Jay Lee
e2bbb95591 Install script handling of MacOS versions 2024-11-15 19:15:01 +00:00
Jay Lee
8568b24db2 restore overwritten install script upgrade
Some checks are pending
Build and test GAM / build (Win64, build, 9, VC-WIN64A, windows-2022) (push) Waiting to run
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Waiting to run
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Waiting to run
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Waiting to run
Build and test GAM / build (aarch64, build, 8, darwin64-arm64, macos-15) (push) Waiting to run
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Waiting to run
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Waiting to run
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.9) (push) Waiting to run
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.10) (push) Waiting to run
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.11) (push) Waiting to run
Build and test GAM / build (x86_64, test, 13, ubuntu-24.04, 3.12) (push) Waiting to run
Build and test GAM / merge (push) Blocked by required conditions
Build and test GAM / publish (push) Blocked by required conditions
CodeQL / Analyze (python) (push) Waiting to run
Check for Google Root CA Updates / check-apis (push) Waiting to run
2024-11-14 15:08:51 -05:00
Jay Lee
d8f10dc72a actions: include MacOS version in package file, rebuild for MacOS 15
Some checks are pending
Build and test GAM / build (Win64, build, 9, VC-WIN64A, windows-2022) (push) Waiting to run
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Waiting to run
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Waiting to run
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Waiting to run
Build and test GAM / build (aarch64, build, 8, darwin64-arm64, macos-15) (push) Waiting to run
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Waiting to run
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Waiting to run
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.9) (push) Waiting to run
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.10) (push) Waiting to run
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.11) (push) Waiting to run
Build and test GAM / build (x86_64, test, 13, ubuntu-24.04, 3.12) (push) Waiting to run
Build and test GAM / merge (push) Blocked by required conditions
Build and test GAM / publish (push) Blocked by required conditions
CodeQL / Analyze (python) (push) Waiting to run
Check for Google Root CA Updates / check-apis (push) Waiting to run
2024-11-14 08:04:30 -05:00
Ross Scroggs
98ef879a34 Fixed logic flaw in gam print|show policies where non-matching policies were displayed.
Some checks failed
Build and test GAM / build (Win64, build, 8, VC-WIN64A, windows-2022) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.10) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.11) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.12) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 9, ubuntu-24.04, 3.9) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Check for Google Root CA Updates / check-apis (push) Has been cancelled
Build and test GAM / merge (push) Has been cancelled
Build and test GAM / publish (push) Has been cancelled
2024-11-10 18:57:22 -08:00
Ross Scroggs
95b3a97925 Added group/ou filtering to print|show policies
Some checks are pending
Build and test GAM / build (Win64, build, 8, VC-WIN64A, windows-2022) (push) Waiting to run
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Waiting to run
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Waiting to run
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Waiting to run
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Waiting to run
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Waiting to run
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Waiting to run
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.10) (push) Waiting to run
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.11) (push) Waiting to run
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.12) (push) Waiting to run
Build and test GAM / build (x86_64, test, 9, ubuntu-24.04, 3.9) (push) Waiting to run
Build and test GAM / merge (push) Blocked by required conditions
Build and test GAM / publish (push) Blocked by required conditions
CodeQL / Analyze (python) (push) Waiting to run
Check for Google Root CA Updates / check-apis (push) Waiting to run
Updated `gam get|update|delete contactphotos` to use the People API
2024-11-10 08:18:43 -08:00
Ross Scroggs
f24629602c Updated gam print chromeapps to correct a trap caused by an API change.
Some checks failed
Build and test GAM / build (Win64, build, 8, VC-WIN64A, windows-2022) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.10) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.11) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.12) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 9, ubuntu-24.04, 3.9) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Check for Google Root CA Updates / check-apis (push) Has been cancelled
Build and test GAM / merge (push) Has been cancelled
Build and test GAM / publish (push) Has been cancelled
2024-11-05 12:34:20 -08:00
Ross Scroggs
e5125b6853 Update Users-Classification-Labels.md
Some checks failed
Build and test GAM / build (Win64, build, 8, VC-WIN64A, windows-2022) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.10) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.11) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.12) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 9, ubuntu-24.04, 3.9) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Check for Google Root CA Updates / check-apis (push) Has been cancelled
Build and test GAM / merge (push) Has been cancelled
Build and test GAM / publish (push) Has been cancelled
2024-11-02 15:03:40 -07:00
Ross Scroggs
31e8ac11a2 Classification labels are now available for Gmail in addition to Drive. 2024-11-02 12:41:22 -07:00
Ross Scroggs
a9c4c006b2 Fixed bug introduced in 7.00.33 in gam print group-members that caused a trap.
Some checks failed
Build and test GAM / build (Win64, build, 8, VC-WIN64A, windows-2022) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 3, linux-aarch64, [self-hosted linux arm64]) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 5, linux-aarch64, [self-hosted linux arm64], yes) (push) Has been cancelled
Build and test GAM / build (aarch64, build, 7, darwin64-arm64, macos-14) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 1, linux-x86_64, ubuntu-22.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 2, linux-x86_64, ubuntu-24.04) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 4, linux-x86_64, ubuntu-22.04, yes) (push) Has been cancelled
Build and test GAM / build (x86_64, build, 6, darwin64-x86_64, macos-13) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 10, ubuntu-24.04, 3.10) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 11, ubuntu-24.04, 3.11) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 12, ubuntu-24.04, 3.12) (push) Has been cancelled
Build and test GAM / build (x86_64, test, 9, ubuntu-24.04, 3.9) (push) Has been cancelled
CodeQL / Analyze (python) (push) Has been cancelled
Check for Google Root CA Updates / check-apis (push) Has been cancelled
Build and test GAM / merge (push) Has been cancelled
Build and test GAM / publish (push) Has been cancelled
2024-10-31 11:27:56 -07:00
111 changed files with 752 additions and 604 deletions

View File

@@ -68,31 +68,36 @@ jobs:
goal: build goal: build
arch: aarch64 arch: aarch64
openssl_archs: darwin64-arm64 openssl_archs: darwin64-arm64
- os: windows-2022 - os: macos-15
jid: 8 jid: 8
goal: build goal: build
arch: aarch64
openssl_archs: darwin64-arm64
- os: windows-2022
jid: 9
goal: build
arch: Win64 arch: Win64
openssl_archs: VC-WIN64A openssl_archs: VC-WIN64A
- os: ubuntu-24.04 - os: ubuntu-24.04
goal: test goal: test
python: "3.9" python: "3.9"
jid: 9
arch: x86_64
- os: ubuntu-24.04
goal: test
python: "3.10"
jid: 10 jid: 10
arch: x86_64 arch: x86_64
- os: ubuntu-24.04 - os: ubuntu-24.04
goal: test goal: test
python: "3.11" python: "3.10"
jid: 11 jid: 11
arch: x86_64 arch: x86_64
- os: ubuntu-24.04 - os: ubuntu-24.04
goal: test goal: test
python: "3.12" python: "3.11"
jid: 12 jid: 12
arch: x86_64 arch: x86_64
- os: ubuntu-24.04
goal: test
python: "3.12"
jid: 13
arch: x86_64
steps: steps:
@@ -115,7 +120,7 @@ jobs:
with: with:
path: | path: |
cache.tar.xz cache.tar.xz
key: gam-${{ matrix.jid }}-20241022 key: gam-${{ matrix.jid }}-20241114
- 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'
@@ -677,7 +682,7 @@ jobs:
if: runner.os != 'Windows' && matrix.goal == 'build' if: runner.os != 'Windows' && matrix.goal == 'build'
run: | run: |
if [[ "${RUNNER_OS}" == "macOS" ]]; then if [[ "${RUNNER_OS}" == "macOS" ]]; then
GAM_ARCHIVE="${GITHUB_WORKSPACE}/gam-${GAMVERSION}-macos-${arch}.tar.xz" GAM_ARCHIVE="${GITHUB_WORKSPACE}/gam-${GAMVERSION}-macos${MACOSX_DEPLOYMENT_TARGET}-${arch}.tar.xz"
elif [[ "${RUNNER_OS}" == "Linux" ]]; then elif [[ "${RUNNER_OS}" == "Linux" ]]; then
if [[ "${staticx}" == "yes" ]]; then if [[ "${staticx}" == "yes" ]]; then
libver="legacy" libver="legacy"

View File

@@ -1,4 +1,4 @@
!# Addresses # Addresses
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Display addresses](#display-addresses) - [Display addresses](#display-addresses)

View File

@@ -1,4 +1,4 @@
!# Administrators # Administrators
- [Administrator roles documentation](#administrator-roles-documentation) - [Administrator roles documentation](#administrator-roles-documentation)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Alert Center # Alert Center
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Introduction](#introduction) - [Introduction](#introduction)

View File

@@ -973,8 +973,8 @@ gam user user@domain.com update serviceaccount
[*] 18) Drive API (supports readonly) [*] 18) Drive API (supports readonly)
[*] 19) Drive API - todrive [*] 19) Drive API - todrive
[*] 20) Drive Activity API v2 - must pair with Drive API [*] 20) Drive Activity API v2 - must pair with Drive API
[*] 21) Drive Labels API v2beta - Admin (supports readonly) [*] 21) Drive Labels API - Admin (supports readonly)
[*] 22) Drive Labels API v2beta - User (supports readonly) [*] 22) Drive Labels API - User (supports readonly)
[*] 23) Forms API [*] 23) Forms API
[*] 24) Gmail API - Basic Settings (Filters,IMAP, Language, POP, Vacation) - read/write, Sharing Settings (Delegates, Forwarding, SendAs) - read [*] 24) Gmail API - Basic Settings (Filters,IMAP, Language, POP, Vacation) - read/write, Sharing Settings (Delegates, Forwarding, SendAs) - read
[*] 25) Gmail API - Full Access (Labels, Messages) [*] 25) Gmail API - Full Access (Labels, Messages)

View File

@@ -1,4 +1,4 @@
!# Syntax # Syntax
## BNF Syntax ## BNF Syntax
This Wiki describes the GAM7 command line syntax in modified BNF. This Wiki describes the GAM7 command line syntax in modified BNF.

View File

@@ -283,6 +283,11 @@
<GIGroupItem> ::= <EmailAddress>|<UniqueID>|groups/<String> <GIGroupItem> ::= <EmailAddress>|<UniqueID>|groups/<String>
<CIGroupType> ::= customer|group|other|serviceaccount|user <CIGroupType> ::= customer|group|other|serviceaccount|user
<CIPolicyName> ::= policies/<String>|settings/<String>|<String> <CIPolicyName> ::= policies/<String>|settings/<String>|<String>
<ClassificationLabelID> ::= <String>
<ClassificationLabelFieldID> ::= <String>
<ClassificationLabelSelectionID> ::= <String>
<ClassificationLabelName> ::= labels/<ClassificationLabelID>[@latest|@published|@<Number>]
<ClassificationLabelPermissionName> ::= labels/<ClassificationLabelID>[@latest|@published|@<Number>]/permissions/(audiences|groups|people)/<String>
<ClassroomInvitationID> ::= <String> <ClassroomInvitationID> ::= <String>
<ClientID> ::= <String> <ClientID> ::= <String>
<CommandID> ::= <String> <CommandID> ::= <String>
@@ -352,11 +357,6 @@
<DriveFilePermissionID> ::= anyone|anyonewithlink|id:<String> <DriveFilePermissionID> ::= anyone|anyonewithlink|id:<String>
<DriveFilePermissionIDorEmail> ::= <DriveFilePermissionID>|<EmailAddress> <DriveFilePermissionIDorEmail> ::= <DriveFilePermissionID>|<EmailAddress>
<DriveFileRevisionID> ::= <String> <DriveFileRevisionID> ::= <String>
<DriveLabelID> ::= <String>
<DriveLabelFieldID> ::= <String>
<DriveLabelSelectionID> ::= <String>
<DriveLabelName> ::= labels/<DriveLabelID>[@latest|@published|@<Number>]
<DriveLabelPermissionName> ::= labels/<DriveLabelID>[@latest|@published|@<Number>]/permissions/(audiences|groups|people)/<String>
<EmailAddress> ::= <String>@<DomainName> <EmailAddress> ::= <String>@<DomainName>
<EmailItem> ::= <EmailAddress>|<UniqueID>|<String> <EmailItem> ::= <EmailAddress>|<UniqueID>|<String>
<EmailReplacement> ::= <String> <EmailReplacement> ::= <String>

View File

@@ -1,4 +1,4 @@
!# Bulk Processing # Bulk Processing
- [Introduction](#introduction) - [Introduction](#introduction)
- [Python Regular Expressions](Python-Regular-Expressions) - [Python Regular Expressions](Python-Regular-Expressions)
- [GAM Configuration](gam.cfg) - [GAM Configuration](gam.cfg)

View File

@@ -1,4 +1,4 @@
!# CSV Special Characters # CSV Special Characters
- [Python CSV documentation](https://docs.python.org/3/library/csv.html#dialects-and-formatting-parameters) - [Python CSV documentation](https://docs.python.org/3/library/csv.html#dialects-and-formatting-parameters)
## Python variables that control CSV file reading/writing: ## Python variables that control CSV file reading/writing:

View File

@@ -66,9 +66,12 @@ Client access works when accessing Resource calendars.
See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
<DomainName> ::= <String>(.<String>)+ <DomainName> ::= <String>(.<String>)+
<EmailAddress> ::= <String>@<DomainName> <EmailAddress> ::= <String>@<DomainName>
<EmailAddressList> ::= "<EmailAddess>(,<EmailAddress>)*" <EmailAddressList> ::= "<EmailAddress>(,<EmailAddress>)*"
<EmailAddressEntity> ::= <EmailAddressList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector> <EmailAddressEntity> ::=
<EmailAddressList> | <FileSelector> | <CSVFileSelector> |
<CSVkmdSelector> | <CSVDataSelector>
See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
<iCalUID> ::= <String>
<EventAttachmentsSubfieldName> ::= <EventAttachmentsSubfieldName> ::=
attachments.fileid| attachments.fileid|

View File

@@ -1,4 +1,4 @@
!# Chat Bot # Chat Bot
- [Notes](#notes) - [Notes](#notes)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)

View File

@@ -1,4 +1,4 @@
!# Chrome Auto Update Expiration Counts # Chrome Auto Update Expiration Counts
- [Chrome Auto Update Expiration Counts](#chrome-auto-update-expiration-counts) - [Chrome Auto Update Expiration Counts](#chrome-auto-update-expiration-counts)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)

View File

@@ -1,4 +1,4 @@
!# Chrome Installed Apps Counts # Chrome Installed Apps Counts
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Chrome Device Needs Attention Counts # Chrome Device Needs Attention Counts
- [Chrome Device Needs Attention Counts](#chrome-device-needs-attention-counts) - [Chrome Device Needs Attention Counts](#chrome-device-needs-attention-counts)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)

View File

@@ -1,4 +1,4 @@
!# Chrome Policies # Chrome Policies
- [Chrome Policies](#chrome-policies) - [Chrome Policies](#chrome-policies)
- [Chrome Version History](Chrome-Version-History) - [Chrome Version History](Chrome-Version-History)

View File

@@ -1,4 +1,4 @@
!# Chrome Printers # Chrome Printers
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Chrome Version Counts # Chrome Version Counts
- [Chrome Version Counts](#chrome-version-counts) - [Chrome Version Counts](#chrome-version-counts)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)

View File

@@ -1,4 +1,4 @@
!# Chrome Version History # Chrome Version History
- [Chrome Version History](#chrome-version-history) - [Chrome Version History](#chrome-version-history)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)

View File

@@ -1,4 +1,4 @@
!# Cloud Channel # Cloud Channel
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Cloud Identity Devices # Cloud Identity Devices
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](#query-documentation) - [Query documentation](#query-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,6 +1,7 @@
# Cloud Identity Policies # Cloud Identity Policies
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Python Regular Expressions](Python-Regular-Expressions) Match function
- [Definitions](#definitions) - [Definitions](#definitions)
- [Policies](#policies) - [Policies](#policies)
- [Display Cloud Identity Policies](#display-cloud-identity-policies) - [Display Cloud Identity Policies](#display-cloud-identity-policies)
@@ -322,8 +323,8 @@ gam info policies <CIPolicyEntity>
Select policies:: Select policies::
* `polices/<String>` - A policy name, `policies/ahv4hg7qc24kvaghb7zihwf4riid4` * `polices/<String>` - A policy name, `policies/ahv4hg7qc24kvaghb7zihwf4riid4`
* `settings/<String>` - A policy setting type, `settings/workspace_marketplace.apps_allowlist' * `settings/<String>` - A policy setting type, `settings/workspace_marketplace.apps_allowlist`
* `<String>` - A policy setting type, `workspace_marketplace.apps_allowlist' * `<String>` - A policy setting type, `workspace_marketplace.apps_allowlist`
By default, policy warnings are displayed, use the 'nowarnings` option to suppress their display. By default, policy warnings are displayed, use the 'nowarnings` option to suppress their display.
@@ -337,10 +338,13 @@ Display all or filtered policies.
``` ```
gam show policies gam show policies
[filter <String>] [nowarnings] [noappnames] [filter <String>] [nowarnings] [noappnames]
[group <RegularExpression>] [ou|org|orgunit <RegularExpression>]
[formatjson] [formatjson]
``` ```
By default, all policies are displayed. By default, all policies are displayed.
* `filter <String>` - Display filtered policies, See https://cloud.google.com/identity/docs/reference/rest/v1beta1/policies/list * `filter <String>` - Display filtered policies, See https://cloud.google.com/identity/docs/reference/rest/v1beta1/policies/list
* `group <RegularExpression>` - Only display policies whose group email address matches the `<RegularExpression>`
* `ou|org|orgunit <RegularExpression> - Only display policies whose OU path matches the `<RegularExpression>`
By default, policy warnings are displayed, use the 'nowarnings` option to suppress their display. By default, policy warnings are displayed, use the 'nowarnings` option to suppress their display.
@@ -353,10 +357,13 @@ By default, Gam displays the information as an indented list of keys and values.
``` ```
gam print policies [todrive <ToDriveAttribute>*] gam print policies [todrive <ToDriveAttribute>*]
[filter <String>] [nowarnings] [noappnames] [filter <String>] [nowarnings] [noappnames]
[group <RegularExpression>] [ou|org|orgunit <RegularExpression>]
[formatjson [quotechar <Character>]] [formatjson [quotechar <Character>]]
``` ```
By default, all policies are displayed: By default, all policies are displayed:
* `filter <String>` - Display filtered policies, See https://cloud.google.com/identity/docs/reference/rest/v1beta1/policies/list * `filter <String>` - Display filtered policies, See https://cloud.google.com/identity/docs/reference/rest/v1beta1/policies/list
* `group <RegularExpression>` - Only display policies whose group email address matches the `<RegularExpression>`
* `ou|org|orgunit <RegularExpression> - Only display policies whose OU path matches the `<RegularExpression>`
By default, policy warnings are displayed, use the 'nowarnings` option to suppress their display. By default, policy warnings are displayed, use the 'nowarnings` option to suppress their display.
@@ -371,3 +378,9 @@ the quote character itself, the column delimiter (comma by default) and new-line
When using the `formatjson` option, double quotes are used extensively in the data resulting in hard to read/process output. 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. 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. `quotechar` defaults to `gam.cfg/csv_output_quote_char`. When uploading CSV files to Google, double quote `"` should be used.
### Examples
Print all service status policies.
```
gam redirect csv ./ServiceStatusPolicies.csv print policies filter "setting.type.matches('.*service_status')"
```

View File

@@ -1,4 +1,4 @@
!# Cloud Storage # Cloud Storage
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Collections of ChromeOS Devices # Collections of ChromeOS Devices
- [Python Regular Expressions](Python-Regular-Expressions) Match function - [Python Regular Expressions](Python-Regular-Expressions) Match function
- [Definitions](#definitions) - [Definitions](#definitions)
- [Organization Unit Quoting](#organization-unit-quoting) - [Organization Unit Quoting](#organization-unit-quoting)

View File

@@ -146,6 +146,10 @@ Data fields identified in a `csvkmd` argument.
<CalendarList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector> <CalendarList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector>
<CIPolicyNameEntity> ::= <CIPolicyNameEntity> ::=
<CIPolicyNameList> | <FileSelector> | <CSVFileSelector> <CIPolicyNameList> | <FileSelector> | <CSVFileSelector>
<ClassificationLabelNameEntity> ::=
<ClassificationLabelNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector>
<ClassificationLabelPermissionNameEntity> ::=
<ClassificationLabelPermissionNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector>
<ClassroomInvitationIDEntity> ::= <ClassroomInvitationIDEntity> ::=
<ClassroomInvitationIDList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector> <ClassroomInvitationIDList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector>
<ContactEntity> ::= <ContactEntity> ::=
@@ -267,10 +271,6 @@ Data fields identified in a `csvkmd` argument.
(first|last|allexceptfirst|allexceptlast <Number>)| (first|last|allexceptfirst|allexceptlast <Number>)|
(before|after <Time>) | (range <Time> <Time>)| (before|after <Time>) | (range <Time> <Time>)|
<FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector> <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector>
<DriveLabelNameEntity> ::=
<DriveLabelNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector>
<DriveLabelPermissionNameEntity> ::=
<DriveLabelPermissionNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector>
<EmailAddressEntity> ::= <EmailAddressEntity> ::=
<EmailAddressList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector> <EmailAddressList> | <FileSelector> | <CSVFileSelector> | <CSVkmdSelector> | <CSVDataSelector>
<FilterIDEntity> ::= <FilterIDEntity> ::=

View File

@@ -1,4 +1,4 @@
!# Collections of Users # Collections of Users
- [Python Regular Expressions](Python-Regular-Expressions) Match function - [Python Regular Expressions](Python-Regular-Expressions) Match function
- [Definitions](#definitions) - [Definitions](#definitions)
- [List quoting rules](#list-quoting-rules) - [List quoting rules](#list-quoting-rules)

View File

@@ -1,4 +1,4 @@
!# Command data from Google Docs, Sheets and Cloud Storage # Command data from Google Docs, Sheets and Cloud Storage
- [Introduction](#introduction) - [Introduction](#introduction)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Read data from a Google Doc or Drive File](#read-data-from-a-google-doc-or-drive-file) - [Read data from a Google Doc or Drive File](#read-data-from-a-google-doc-or-drive-file)

View File

@@ -1,4 +1,4 @@
!# Command Line Parsing # Command Line Parsing
- [Linux and MacOS](#linux-and-macos) - [Linux and MacOS](#linux-and-macos)
- [Windows Command Prompt](#windows-command-prompt) - [Windows Command Prompt](#windows-command-prompt)
- [Windows PowerShell](#windows-powershell) - [Windows PowerShell](#windows-powershell)

View File

@@ -1,4 +1,4 @@
!# Command Logging and Progress # Command Logging and Progress
- [Introduction](#introduction) - [Introduction](#introduction)
- [GAM Configuration](gam.cfg) - [GAM Configuration](gam.cfg)
- [Command Logging](#command-logging) - [Command Logging](#command-logging)

View File

@@ -1,4 +1,4 @@
!# Customer # Customer
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Update customer](#update-customer) - [Update customer](#update-customer)

View File

@@ -1,4 +1,4 @@
!# Domains - Verification # Domains - Verification
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Introduction](#introduction) - [Introduction](#introduction)

View File

@@ -1,4 +1,4 @@
!# Domains # Domains
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Create a domain](#create-a-domain) - [Create a domain](#create-a-domain)

View File

@@ -1,4 +1,4 @@
!# Downloads-Installs-GAM7 # Downloads-Installs-GAM7
You can download and install the current GAM7 release from the [GitHub Releases](https://github.com/GAM-team/GAM/releases/latest) page. You can download and install the current GAM7 release from the [GitHub Releases](https://github.com/GAM-team/GAM/releases/latest) page.
Choose one of the following: Choose one of the following:

View File

@@ -1,4 +1,4 @@
!# Drive Items # Drive Items
- [Basic Items](Basic-Items) - [Basic Items](Basic-Items)
- [List Items](List-Items) - [List Items](List-Items)
``` ```

View File

@@ -1,4 +1,4 @@
!# Email Audit Monitor # Email Audit Monitor
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Find File Owner # Find File Owner
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Display File Ownership](#display-file-ownership) - [Display File Ownership](#display-file-ownership)

View File

@@ -1,4 +1,4 @@
!# GAM Return Codes # GAM Return Codes
These are the return codes used by GAM7. These are the return codes used by GAM7.

View File

@@ -1,4 +1,4 @@
!# GAM setup with minimal GCP permissions. # GAM setup with minimal GCP permissions.
- GCP Admin can create a project for the Workspace / GAM admin. - GCP Admin can create a project for the Workspace / GAM admin.

View File

@@ -1,4 +1,4 @@
!# GAM7 on Android Devices # GAM7 on Android Devices
GAM7 now runs on 64-bit Android devices such as Google's Pixel phones. The installation requires an app that adds the Linux environment to Android such as [UserLAnd](https://play.google.com/store/apps/details?id=tech.ula&hl=en_US). GAM7 now runs on 64-bit Android devices such as Google's Pixel phones. The installation requires an app that adds the Linux environment to Android such as [UserLAnd](https://play.google.com/store/apps/details?id=tech.ula&hl=en_US).
_Note: Chromebooks / Chrome OS devices should install GAM7 using [these instructions](GAM7-on-Chrome-OS-Devices)._ _Note: Chromebooks / Chrome OS devices should install GAM7 using [these instructions](GAM7-on-Chrome-OS-Devices)._

View File

@@ -1,4 +1,4 @@
!# GAM7 on Chrome OS Devices # GAM7 on Chrome OS Devices
Chrome OS devices that [support Linux apps](https://support.google.com/chromebook/answer/9145439?hl=en) can run GAM7. This includes Intel/AMD x86_64 Chromebooks as well as ARM-based Chromebooks with Mediatek or Rockchip 64-bit CPUs. Chrome OS devices that [support Linux apps](https://support.google.com/chromebook/answer/9145439?hl=en) can run GAM7. This includes Intel/AMD x86_64 Chromebooks as well as ARM-based Chromebooks with Mediatek or Rockchip 64-bit CPUs.
1. [Set up Linux on your Chromebook](https://support.google.com/chromebook/answer/9145439?hl=en). 1. [Set up Linux on your Chromebook](https://support.google.com/chromebook/answer/9145439?hl=en).

View File

@@ -10,6 +10,50 @@ 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.00.39
Supported MacOS versions are now in the download filename.
### 7.00.38
Fixed logic flaw in `gam print|show policies` where non-matching policies were displayed.
### 7.00.37
Added options `group <RegularExpression>` and `ou|org|orgunit <RegularExpression>`
to `gam print|show policies` that causes GAM to only display policies whose group email address
or OU path match the `<RegularExpression>`.
Updated `gam get|update|delete contactphotos` to use the People API for domain shared contact photos
as Google has deprecated the Domain Shared Contacts API for these commands. Unfortunately,
the People API fails with `gam update|delete contactphotos`.
### 7.00.36
Updated `gam print chromeapps` to correct a trap caused by an API change.
### 7.00.35
Classification labels are now available for Gmail in addition to Drive.
* See: https://workspaceupdates.googleblog.com/2024/11/open-beta-data-classification-labels-gmail.html
The following command synonyms are available, there is no change in functionality:
```
gam [<UserTypeEntity>] info classificationlabels|drivelabels
gam [<UserTypeEntity>] print classificationlabels|drivelabels
gam [<UserTypeEntity>] show classificationlabels|drivelabels
gam [<UserTypeEntity>] create classificationlabelpermission|drivelabelpermission
gam [<UserTypeEntity>] delete classificationlabelpermission|drivelabelpermission
gam [<UserTypeEntity>] remove classificationlabelpermission|drivelabelpermission
gam [<UserTypeEntity>] print classificationlabelpermissions|drivelabelpermission
gam [<UserTypeEntity>] show classificationlabelpermissions|drivelabelpermission
```
### 7.00.34
Fixed bug introduced in 7.00.33 in `gam print group-members` that caused a trap.
### 7.00.33 ### 7.00.33
Fixed bug in `gam print group-members ... cachememberinfo` that caused a trap. Fixed bug in `gam print group-members ... cachememberinfo` that caused a trap.

View File

@@ -1,4 +1,4 @@
!# Google Data Transfers # Google Data Transfers
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Display transfer apps](#display-transfer-apps) - [Display transfer apps](#display-transfer-apps)

View File

@@ -1,4 +1,4 @@
!# Google Network Addresses # Google Network Addresses
All GAM calls are made on port 443 (HTTPS) to the following addresses: All GAM calls are made on port 443 (HTTPS) to the following addresses:
``` ```

View File

@@ -1,4 +1,4 @@
!# HTTPS Proxy # HTTPS Proxy
GAM should be run on a server with direct access to talk to Google servers via the Internet. GAM should be run on a server with direct access to talk to Google servers via the Internet.
However, if you must push GAM traffic through an HTTPS proxy this can be done by setting the HTTPS_PROXY environment variable. However, if you must push GAM traffic through an HTTPS proxy this can be done by setting the HTTPS_PROXY environment variable.

View File

@@ -1,4 +1,4 @@
!# Installing GAM7 # Installing GAM7
Use these steps if you have never used any version of GAM in your domain. They will create your GAM project Use these steps if you have never used any version of GAM in your domain. They will create your GAM project
and all necessary authentications. and all necessary authentications.

View File

@@ -1,4 +1,4 @@
!# Uninstalling GAM7 # Uninstalling GAM7
- [Get Project Info](#get-project-info) - [Get Project Info](#get-project-info)
- [Remove Client API access](#remove-client-api-access) - [Remove Client API access](#remove-client-api-access)

View File

@@ -1,4 +1,4 @@
!# Updating GAM7 # Updating GAM7
Use these steps to update your version of GAM7. Use these steps to update your version of GAM7.
- [Downloads-Installs](Downloads-Installs) - [Downloads-Installs](Downloads-Installs)

View File

@@ -1,4 +1,4 @@
!# Installation - Upgrading from Legacy GAM # Installation - Upgrading from Legacy GAM
Use these steps if you have used any version of GAM in your domain. They will update your GAM project Use these steps if you have used any version of GAM in your domain. They will update your GAM project
and all necessary authentications. and all necessary authentications.
@@ -251,7 +251,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.00.33 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.00.38 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.0 64-bit final Python 3.13.0 64-bit final
MacOS Sonoma 14.5 x86_64 MacOS Sonoma 14.5 x86_64
@@ -923,7 +923,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
GAM7 7.00.33 - https://github.com/GAM-team/GAM - pythonsource GAM7 7.00.38 - https://github.com/GAM-team/GAM - pythonsource
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.13.0 64-bit final Python 3.13.0 64-bit final
Windows-10-10.0.17134 AMD64 Windows-10-10.0.17134 AMD64

View File

@@ -1,4 +1,4 @@
!# Inbound SSO # Inbound SSO
- [Admin Console](#admin-console) - [Admin Console](#admin-console)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Licenses # Licenses
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [License Products and SKUs](#license-products-and-skus) - [License Products and SKUs](#license-products-and-skus)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -14,6 +14,11 @@
<CIGroupAliasList> ::= "<CIGroupAlias>(,<CIGroupAlias>)*" <CIGroupAliasList> ::= "<CIGroupAlias>(,<CIGroupAlias>)*"
<CIGroupTypeList> ::= "<CIGroupType>(,<CIGroupType>)*" <CIGroupTypeList> ::= "<CIGroupType>(,<CIGroupType>)*"
<CIPolicyNameList> ::= "<CIPolicyName>(,<CIPolicyName>)*" <CIPolicyNameList> ::= "<CIPolicyName>(,<CIPolicyName>)*"
<ClassificationLabelIDList> ::= "<ClassificationLabelID>(,<ClassificationLabelID>)*"
<ClassificationLabelNameList> ::= "<ClassificationLabelName>(,<ClassificationLabelName>)*"
<ClassificationLabelPermissionNameList> ::= "<ClassificationLabelPermissionName>(,<ClassificationLabelPermissionName>)*"
<ClassificationLabelFieldIDList> ::= "<ClassificationLabelFieldID>(,<ClassificationLabelFieldID>)*"
<ClassificationLabelSelectionIDList> ::= "<ClassificationLabelSelectionID>(,<ClassificationLabelSelectionID>)*"
<ClassroomInvitationIDList> ::= "<ClassroomInvitationID>(,<ClassroomInvitationID>)*" <ClassroomInvitationIDList> ::= "<ClassroomInvitationID>(,<ClassroomInvitationID>)*"
<ContactGroupList> ::= "<ContactGroupItem>(,<ContactGroupItem>)*" <ContactGroupList> ::= "<ContactGroupItem>(,<ContactGroupItem>)*"
<ContactIDList> ::= "<ContactID>(,<ContactID>)*" <ContactIDList> ::= "<ContactID>(,<ContactID>)*"
@@ -42,11 +47,6 @@
<DriveFileRevisionIDList> ::= "<DriveFileRevisionID>(,<DriveFileRevisionID>)*" <DriveFileRevisionIDList> ::= "<DriveFileRevisionID>(,<DriveFileRevisionID>)*"
<DriveFolderIDList> ::= "<DriveFolderID>(,<DriveFolderID>)*" <DriveFolderIDList> ::= "<DriveFolderID>(,<DriveFolderID>)*"
<DriveFolderNameList> ::= "<DriveFolderName>(,<DriveFolderName>)*" <DriveFolderNameList> ::= "<DriveFolderName>(,<DriveFolderName>)*"
<DriveLabelIDList> ::= "<DriveLabelID>(,<DriveLabelID>)*"
<DriveLabelNameList> ::= "<DriveLabelName>(,<DriveLabelName>)*"
<DriveLabelPermissionNameList> ::= "<DriveLabelPermissionName>(,<DriveLabelPermissionName>)*"
<DriveLabelFieldIDList> ::= "<DriveLabelFieldID>(,<DriveLabelFieldID>)*"
<DriveLabelSelectionIDList> ::= "<DriveLabelSelectionID>(,<DriveLabelSelectionID>)*"
<EmailAddressList> ::= "<EmailAddress>(,<EmailAddress>)*" <EmailAddressList> ::= "<EmailAddress>(,<EmailAddress>)*"
<EmailItemList> ::= "<EmailItem>(,<EmailItem>)*" <EmailItemList> ::= "<EmailItem>(,<EmailItem>)*"
<EventIDList> ::= "<EventID>(,<EventID>)*" <EventIDList> ::= "<EventID>(,<EventID>)*"

View File

@@ -1,4 +1,4 @@
!# List # List
The list command is used to verify collections of objects. The list command is used to verify collections of objects.

View File

@@ -1,4 +1,4 @@
!# Meta Commands and File Redirection # Meta Commands and File Redirection
- [GAM Configuration](gam.cfg) - [GAM Configuration](gam.cfg)
- [Todrive](Todrive) - [Todrive](Todrive)

View File

@@ -1,4 +1,4 @@
!# Mobile Devices # Mobile Devices
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](#query-documentation) - [Query documentation](#query-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Organizational Units # Organizational Units
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Special quoting](#special-quoting) - [Special quoting](#special-quoting)

View File

@@ -1,4 +1,4 @@
!# Other Resources # Other Resources
The following are links to contributions of others in support of GAM7. The following are links to contributions of others in support of GAM7.

View File

@@ -1,4 +1,4 @@
!# Permission Matches # Permission Matches
- [Python Regular Expressions](Python-Regular-Expressions) Match function - [Python Regular Expressions](Python-Regular-Expressions) Match function
- [Definitions](#definitions) - [Definitions](#definitions)
- [File Selection](#file-selection) - [File Selection](#file-selection)

View File

@@ -1,4 +1,4 @@
!# Python Regular Expressions # Python Regular Expressions
- [Documentation](#documentation) - [Documentation](#documentation)
- [Match function](#match-function) - [Match function](#match-function)
- [Sub function](#sub-function) - [Sub function](#sub-function)

View File

@@ -1,4 +1,4 @@
!# Rclone # Rclone
GAM7 has the capability to upload and download single files between your local computer and Google Drive; GAM7 has the capability to upload and download single files between your local computer and Google Drive;
it has no capability for uploading and dowloading folders. For this you can use Rclone: https://rclone.org/ it has no capability for uploading and dowloading folders. For this you can use Rclone: https://rclone.org/

View File

@@ -1,4 +1,4 @@
!# Reseller # Reseller
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Manage Multiple Domains](#manage-multiple-domains) - [Manage Multiple Domains](#manage-multiple-domains)

View File

@@ -1,4 +1,4 @@
!# SSL Root CA Certificates # SSL Root CA Certificates
For an overall discussion of SSL, see: https://sites.google.com/site/x509certificateusage/ For an overall discussion of SSL, see: https://sites.google.com/site/x509certificateusage/

View File

@@ -1,4 +1,4 @@
!# Scripts # Scripts
These scripts can be used to enhance GAM's capabilities; all are supported with Advanced GAM, These scripts can be used to enhance GAM's capabilities; all are supported with Advanced GAM,
many are supported with Legacy GAM. They require that Python 3 be installed on you computer. many are supported with Legacy GAM. They require that Python 3 be installed on you computer.

View File

@@ -1,4 +1,4 @@
!# Tag Replace # Tag Replace
- [Python Regular Expressions](Python-Regular-Expressions) Sub function - [Python Regular Expressions](Python-Regular-Expressions) Sub function
- [Definitions](#definitions) - [Definitions](#definitions)
- [Introduction](#introduction) - [Introduction](#introduction)

View File

@@ -1,4 +1,4 @@
!# Todrive # Todrive
- [Introduction](#introduction) - [Introduction](#introduction)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Config file options](#config-file-options) - [Config file options](#config-file-options)

View File

@@ -1,4 +1,4 @@
!# Unmanaged Accounts # Unmanaged Accounts
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Collections of Users](Collections-of-Users) - [Collections of Users](Collections-of-Users)

View File

@@ -1,4 +1,4 @@
!# Upgrade Benefits # Upgrade Benefits
- [Configuration](#Configuration) - [Configuration](#Configuration)
- [Syntax Checking](#syntax-checking) - [Syntax Checking](#syntax-checking)
- [API error checking](#api-error-checking) - [API error checking](#api-error-checking)

View File

@@ -1,4 +1,4 @@
!# Users - Analytics Admin # Users - Analytics Admin
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Application Specific Passwords # Users - Application Specific Passwords
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Manage application specific passwords](#manage-application-specific-passwords) - [Manage application specific passwords](#manage-application-specific-passwords)

View File

@@ -1,4 +1,4 @@
!# Users - Backup Verification Codes # Users - Backup Verification Codes
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Manage backup verification codes](#manage-backup-verification-codes) - [Manage backup verification codes](#manage-backup-verification-codes)

View File

@@ -1,4 +1,4 @@
!# Users - Calendars - Access # Users - Calendars - Access
- [Notes](#Notes) - [Notes](#Notes)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -91,20 +91,23 @@
<JSONData> ::= (json [charset <Charset>] <String>) | (json file <FileName> [charset <Charset>]) | <JSONData> ::= (json [charset <Charset>] <String>) | (json file <FileName> [charset <Charset>]) |
<CalendarItem> ::= <EmailAddress>
<CalendarList> ::= "<CalendarItem>(,<CalendarItem>)*"
<CalendarEntity> ::= <CalendarList> | <FileSelector> | <CSVkmdSelector> | <CSVDataSelector>
See: https://github.com/GAM-team/GAM/wiki/Collections-of-Items
<DomainName> ::= <String>(.<String>)+ <DomainName> ::= <String>(.<String>)+
<EmailAddress> ::= <String>@<DomainName> <EmailAddress> ::= <String>@<DomainName>
<EmailAddressList> ::= "<EmailAddress>(,<EmailAddress>)*" <EmailAddressList> ::= "<EmailAddress>(,<EmailAddress>)*"
<EmailAddressEntity> ::= <EmailAddressEntity> ::=
<EmailAddressList> | <FileSelector> | <CSVFileSelector> | <EmailAddressList> | <FileSelector> | <CSVFileSelector> |
<CSVkmdSelector> | <CSVDataSelector> <CSVkmdSelector> | <CSVDataSelector>
See: https://github.com/GAM-team/GAM/wiki/Collections-of-Users See: https://github.com/GAM-team/GAM/wiki/Collections-of-Users
<CalendarItem> ::= <EmailAddress>
<CalendarList> ::= "<CalendarItem>(,<CalendarItem>)*"
<CourseAlias> ::= <String> <CourseAlias> ::= <String>
<CourseID> ::= <Number>|d:<CourseAlias> <CourseID> ::= <Number>|d:<CourseAlias>
<CourseIDList> ::= "<CourseID>(,<CourseID>)*" <CourseIDList> ::= "<CourseID>(,<CourseID>)*"
<CourseState> ::= active|archived|provisioned|declined <CourseState> ::= active|archived|provisioned|declined
<CourseStateList> ::= all|"<CourseState>(,<CourseState>)*" <CourseStateList> ::= all|"<CourseState>(,<CourseState>)*"
<iCalUID> ::= <String>
<ResourceID> ::= <String> <ResourceID> ::= <String>
<ResourceIDList> ::= "<ResourceID>(,<ResourceID>)*" <ResourceIDList> ::= "<ResourceID>(,<ResourceID>)*"
<UniqueID> ::= id:<String> <UniqueID> ::= id:<String>
@@ -122,7 +125,7 @@
allcalendars| allcalendars|
primary| primary|
<EmailAddress>| <EmailAddress>|
<UniqueUD>| <UniqueID>|
(courses <CourseIDList>)| (courses <CourseIDList>)|
((courses_with_teacher <UserItem>)|my_courses_as_teacher ((courses_with_teacher <UserItem>)|my_courses_as_teacher
[coursestates <CourseStateList>])| [coursestates <CourseStateList>])|

View File

@@ -6,8 +6,8 @@
- [Display calendar UI settings](#display-calendar-ui-settings) - [Display calendar UI settings](#display-calendar-ui-settings)
- [Manage calendars](#manage-calendars) - [Manage calendars](#manage-calendars)
- [Create and remove calendars](#create-and-remove-calendars) - [Create and remove calendars](#create-and-remove-calendars)
- [Display calendar settings](#display-calendar-settings)
- [Modify calendar settings](#modify-calendar-settings) - [Modify calendar settings](#modify-calendar-settings)
- [Display calendar settings](#display-calendar-settings)
- [Manage calendar lists](#manage-calendar-lists) - [Manage calendar lists](#manage-calendar-lists)
- [Display specific calendars from list](#display-specific-calendars-from-list) - [Display specific calendars from list](#display-specific-calendars-from-list)
- [Display calendar lists](#display-calendar-lists) - [Display calendar lists](#display-calendar-lists)
@@ -23,6 +23,8 @@
<EmailAddress> ::= <String>@<DomainName> <EmailAddress> ::= <String>@<DomainName>
<CalendarItem> ::= <EmailAddress> <CalendarItem> ::= <EmailAddress>
<CalendarList> ::= "<CalendarItem>(,<CalendarItem>)*" <CalendarList> ::= "<CalendarItem>(,<CalendarItem>)*"
<CalendarEntity> ::= <CalendarList> | <FileSelector> | <CSVkmdSelector> | <CSVDataSelector>
See: https://github.com/taers232c/GAMADV-XTD3/wiki/Collections-of-Items
<CourseAlias> ::= <String> <CourseAlias> ::= <String>
<CourseID> ::= <Number>|d:<CourseAlias> <CourseID> ::= <Number>|d:<CourseAlias>
<CourseIDList> ::= "<CourseID>(,<CourseID>)*" <CourseIDList> ::= "<CourseID>(,<CourseID>)*"
@@ -38,6 +40,21 @@
<CalendarACLRole> ::= <CalendarACLRole> ::=
editor|freebusy|freebusyreader|owner|reader|writer editor|freebusy|freebusyreader|owner|reader|writer
<CalendarSettings> ::=
(description <String>)|
(location <String>)|
(summary <String>)|
(timezone <TimeZone>)
<CalendarSettingsField> ::=
conferenceproperties|
description|
id|
location|
summary|
timezone
<CalendarSettingsFieldList> ::= "<CalendarSettingsField>(,<CalendarSettingsField>)*"
<CalendarSelectProperty> ::= <CalendarSelectProperty> ::=
minaccessrole <CalendarACLRole>| minaccessrole <CalendarACLRole>|
showdeleted| showdeleted|
@@ -111,12 +128,6 @@
(selected <Boolean>)| (selected <Boolean>)|
(summary <String>) (summary <String>)
<CalendarSettings> ::=
(description <String>)|
(location <String>)|
(summary <String>)|
(timezone <TimeZone>)
<CalendarListField> ::= <CalendarListField> ::=
accessrole| accessrole|
backgroundcolor| backgroundcolor|
@@ -189,18 +200,30 @@ gam <UserTypeEntity> create calendar <CalendarSettings>
gam <UserTypeEntity> remove calendars <UserCalendarEntity> gam <UserTypeEntity> remove calendars <UserCalendarEntity>
``` ```
### Display calendar settings
```
gam <UserTypeEntity> info calendars <UserCalendarEntity> [formatjson]
```
By default, Gam displays the information as an indented list of keys and values.
* `formatjson` - Display the fields in JSON format.
### Modify calendar settings ### Modify calendar settings
``` ```
gam <UserTypeEntity> modify calendars <UserCalendarEntity> <CalendarSettings> gam <UserTypeEntity> modify calendars <UserCalendarEntity> <CalendarSettings>
``` ```
### Display calendar settings
```
gam calendar <CalendarEntity> show settings
[fields <CalendarSettingsFieldList>]
[formatjson]
```
By default, Gam displays the information as an indented list of keys and values.
* `formatjson` - Display the fields in JSON format.
```
gam calendar <CalendarEntity> print settings [todrive <ToDriveAttribute>*]
[fields <CalendarSettingsFieldList>]
[formatjson [quotechar <Character>]]
```
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.
## Manage calendar lists ## Manage calendar lists
These commands manage a user's list of calendars. These commands manage a user's list of calendars.
``` ```

View File

@@ -1,4 +1,4 @@
!# Users - Chat # Users - Chat
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Introduction](#introduction) - [Introduction](#introduction)
- [Set up a Chat Bot](#set-up-a-chat-bot) - [Set up a Chat Bot](#set-up-a-chat-bot)

View File

@@ -1,20 +1,20 @@
!# Users - Drive - Labels # Users - Classification Labels
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](Users-Drive-Query) - [Query documentation](Users-Drive-Query)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Introduction](#introduction) - [Introduction](#introduction)
- [Display Drive Labels](#display-drive-labels) - [Display Classification Labels](#display-classification-labels)
- [Process File Drive Labels](#process-file-drive-labels) - [Manage Classification Label Permissions](#manage-classification-label-permissions)
- [Manage Drive Label Permissions](#manage-drive-label-permissions) - [Display Classification Label Permissions](#display-classification-label-permissions)
- [Display Drive Label Permissions](#display-drive-label-permissions) - [Process Drive File Classification Labels](#process-drive-file-classification-labels)
## API documentation ## API documentation
* https://support.google.com/a/answer/9292382 * https://support.google.com/a/answer/9292382
* https://developers.google.com/drive/labels/guides/overview * https://developers.google.com/drive/labels/guides/overview
* https://developers.google.com/drive/labels/guides/authorize * https://developers.google.com/drive/labels/guides/authorize
* https://developers.google.com/drive/labels/reference/rest/v2beta/labels * https://developers.google.com/drive/labels/reference/rest/v2/labels
* https://developers.google.com/drive/labels/reference/rest/v2beta/labels.permissions * https://developers.google.com/drive/labels/reference/rest/v2/labels.permissions
* https://developers.google.com/drive/api/guides/about-labels * https://developers.google.com/drive/api/guides/about-labels
* https://developers.google.com/drive/api/v3/reference/files * https://developers.google.com/drive/api/v3/reference/files
@@ -24,31 +24,39 @@ To use these commands you must add the 'Drive Labels API' to your project and up
gam update project gam update project
gam user user@domain.com update serviceaccount gam user user@domain.com update serviceaccount
``` ```
Supported editions for this feature: Business Standard and Business Plus; Enterprise; Education Standard and Education Plus; G Suite Business; Essentials. Supported editions for this feature:
```
Frontline Starter and Frontline Standard
Business Standard and Business Plus
Enterprise Standard and Enterprise Plus
Education Standard and Education Plus
Essentials, Enterprise Essentials, and Enterprise Essentials Plus
G Suite Business
```
## Definitions ## Definitions
* [`<DriveFileEntity>`](Drive-File-Selection) * [`<DriveFileEntity>`](Drive-File-Selection)
* [`<UserTypeEntity>`](Collections-of-Users) * [`<UserTypeEntity>`](Collections-of-Users)
* [`<DriveLabelNameEntity>`, `<DriveLabelPermissionNameEntity'](Collections-of-Items) * [`<ClassificationLabelNameEntity>`, `<ClassificationLabelPermissionNameEntity`](Collections-of-Items)
* [`<UserTypeEntity>`](Collections-of-Items) * [`<UserTypeEntity>`](Collections-of-Items)
``` ```
<DriveLabelID> ::= <String> <ClassificationLabelID> ::= <String>
<DriveLabelIDList> ::= "<DriveLabelID>(,<DriveLabelID)*" <ClassificationLabelIDList> ::= "<ClassificationLabelID>(,<ClassificationLabelID)*"
<DriveLabelName> ::= labels/<DriveLabelID>[@latest|@published|@<Number>] <ClassificationLabelName> ::= labels/<ClassificationLabelID>[@latest|@published|@<Number>]
<DriveLabelNameList> ::= "<DriveLabelName>(,<DriveLabelName)*" <ClassificationLabelNameList> ::= "<ClassificationLabelName>(,<ClassificationLabelName)*"
<DriveLabelNameEntity> ::= <ClassificationLabelNameEntity> ::=
<DriveLabelNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector> <ClassificationLabelNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector>
<DriveLabelPermissionName> ::= labels/<DriveLabelID>[@latest|@published|@<Number>]/permissions/(audiences|groups|people)/<String> <ClassificationLabelPermissionName> ::= labels/<ClassificationLabelID>[@latest|@published|@<Number>]/permissions/(audiences|groups|people)/<String>
<DriveLabelPermissionNameList> ::= "<DriveLabelPermissionName>(,<DriveLabelPermissionName>)*" <ClassificationLabelPermissionNameList> ::= "<ClassificationLabelPermissionName>(,<ClassificationLabelPermissionName>)*"
<DriveLabelPermissionNameEntity> ::= <ClassificationLabelPermissionNameEntity> ::=
<DriveLabelPermissionNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector> <ClassificationLabelPermissionNameList> | <FileSelector> | <CSVFileSelector> | <CSVDataSelector>
<DriveLabelFieldID> ::= <String> <ClassificationLabelFieldID> ::= <String>
<DriveLabelSelectionID> ::= <String> <ClassificationLabelSelectionID> ::= <String>
<DriveLabelSelectionIDList> ::= "<DriveLabelSelectionID>(,<DriveLabelSelectionID)*" <ClassificationLabelSelectionIDList> ::= "<ClassificationLabelSelectionID>(,<ClassificationLabelSelectionID)*"
<BCP47LanguageCode> ::= <BCP47LanguageCode> ::=
ar-sa| # Arabic Saudi Arabia ar-sa| # Arabic Saudi Arabia
@@ -99,10 +107,10 @@ Three forms of the commands are available:
* `gam <UserTypeEntity> action ... adminaccess` - The user named in `<UserTypeEntty>` is used, adminaccess indicates that labels of type `SHARED` and `ADMIN`can be processed * `gam <UserTypeEntity> action ... adminaccess` - The user named in `<UserTypeEntty>` is used, adminaccess indicates that labels of type `SHARED` and `ADMIN`can be processed
* `gam <UserTypeEntity> action ...` - The user named in `<UserTypeEntty>` is used, access is limited, onlylabels of type `SHARED` can be processed * `gam <UserTypeEntity> action ...` - The user named in `<UserTypeEntty>` is used, access is limited, onlylabels of type `SHARED` can be processed
## Display Drive Labels ## Display Classification Labels
``` ```
gam [<UserTypeEntity>] info drivelabels <DriveLabelNameEntity> gam [<UserTypeEntity>] info classificationlabels <ClassificationLabelNameEntity>
[[basic|full] [languagecode <BCP47LanguageCode>] [[basic|full] [languagecode <BCP47LanguageCode>]
[formatjson] [adminaccess|asadmin] [formatjson] [adminaccess|asadmin]
``` ```
@@ -115,7 +123,7 @@ 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>] show drivelabels gam [<UserTypeEntity>] show classificationlabels
[basic|full] [languagecode <BCP47LanguageCode>] [basic|full] [languagecode <BCP47LanguageCode>]
[publishedonly [<Boolean>]] [minimumrole applier|editor|organizer|reader] [publishedonly [<Boolean>]] [minimumrole applier|editor|organizer|reader]
[formatjson] [adminaccess|asadmin] [formatjson] [adminaccess|asadmin]
@@ -130,7 +138,7 @@ 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 drivelabels [todrive <ToDriveAttribute>*] gam [<UserTypeEntity>] print classificationlabels [todrive <ToDriveAttribute>*]
[basic|full] [languagecode <BCP47LanguageCode>] [basic|full] [languagecode <BCP47LanguageCode>]
[publishedonly [<Boolean>]] [minimumrole applier|editor|organizer|reader] [publishedonly [<Boolean>]] [minimumrole applier|editor|organizer|reader]
[formatjson [quotechar <Character>]] [adminaccess|asadmin] [formatjson [quotechar <Character>]] [adminaccess|asadmin]
@@ -150,25 +158,10 @@ When using the `formatjson` option, double quotes are used extensively in the da
The `quotechar <Character>` option allows you to choose an alternate quote character, single quote for instance, that makes for readable/processable 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. `quotechar` defaults to `gam.cfg/csv_output_quote_char`. When uploading CSV files to Google, double quote `"` should be used.
## Process File Drive Labels ## Manage Classification Label Permissions
`<DriveLabelID>`, `<DriveLabelFieldID>` and `<DriveLabelSelectionID>` values are obtained from the commands above. Create a permission for a Classification Label by specifying the label name and the principal.
``` ```
gam <UserTypeEntity> process filedrivelabels <DriveFileEntity> gam [<UserTypeEntity>] create classificationlabelpermission <ClassificationLabelNameEntity>
(addlabel <DriveLabelIDList>)*
(deletelabel <DriveLabelIDList>)*
(addlabelfield <DriveLabelID> <DriveLabelFieldID>
(text <String>)|selection <DriveLabelSelectionIDList>)|
(integer <Number>)|(date <Date>)|(user <EmailAddressList>))*
(deletelabelfield <DriveLabelID> <DriveLabelFieldID>)*
[nodetails]
```
By default, details of the process labels are displayed, use `nodetails` to suppress this display.
## Manage Drive Label Permissions
Create a permission for a Drive Label by specifying the label name and the principal.
```
gam [<UserTypeEntity>] create drivelabelpermission <DriveLabelNameEntity>
(user <UserItem>) | (group <GroupItem) | (audience <String>) (user <UserItem>) | (group <GroupItem) | (audience <String>)
role applier|editor|organizer|reader role applier|editor|organizer|reader
[nodetails|formatjson] [adminaccess|asadmin] [nodetails|formatjson] [adminaccess|asadmin]
@@ -178,22 +171,22 @@ By default, when a permission is created, GAM outputs details of the permission
* `nodetails` - Suppress the details output. * `nodetails` - Suppress the details output.
* `formatjson` - Output the details in JSON format. * `formatjson` - Output the details in JSON format.
Delete a Drive Label permission by specifying the label name and the principal. Delete a Classification Label permission by specifying the label name and the principal.
``` ```
gam [<UserTypeEntity>] delete drivelabelpermission <DriveLabelNameEntity> gam [<UserTypeEntity>] delete classificationlabelpermission <ClassificationLabelNameEntity>
(user <UserItem>) | (group <GroupItem) | (audience <String>) (user <UserItem>) | (group <GroupItem) | (audience <String>)
[adminaccess|asadmin] [adminaccess|asadmin]
``` ```
Delete a Drive Label permission by specifying the label permission name. Delete a Classification Label permission by specifying the label permission name.
``` ```
gam [<UserTypeEntity>] remove drivelabelpermission <DriveLabelPermissionNameEntity> gam [<UserTypeEntity>] remove classificationlabelpermission <ClassificationLabelPermissionNameEntity>
[adminaccess|asadmin] [adminaccess|asadmin]
``` ```
## Display Drive Label Permissions ## Display Classification Label Permissions
Display permissions for a collection of Drive Label permission names. Display permissions for a collection of Classification Label permission names.
``` ```
gam [<UserTypeEntity>] show drivelabelpermissions <DriveLabelNameEntity> gam [<UserTypeEntity>] show classificationlabelpermissions <ClassificationLabelNameEntity>
[formatjson] [adminaccess|asadmin] [formatjson] [adminaccess|asadmin]
``` ```
@@ -201,7 +194,7 @@ 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 drivelabelpermissions <DriveLabelNameEntity> [todrive <ToDriveAttribute>*] gam [<UserTypeEntity>] print classificationlabelpermissions <ClassificationLabelNameEntity> [todrive <ToDriveAttribute>*]
[formatjson [quotechar <Character>]] [adminaccess|asadmin] [formatjson [quotechar <Character>]] [adminaccess|asadmin]
``` ```
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,
@@ -213,3 +206,17 @@ When using the `formatjson` option, double quotes are used extensively in the da
The `quotechar <Character>` option allows you to choose an alternate quote character, single quote for instance, that makes for readable/processable 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. `quotechar` defaults to `gam.cfg/csv_output_quote_char`. When uploading CSV files to Google, double quote `"` should be used.
## Process Drive File Classification Labels
`<ClassificationLabelID>`, `<ClassificationLabelFieldID>` and `<ClassificationLabelSelectionID>` values are obtained from the commands above.
```
gam <UserTypeEntity> process filedrivelabels <DriveFileEntity>
(addlabel <ClassificationLabelIDList>)*
(deletelabel <ClassificationLabelIDList>)*
(addlabelfield <ClassificationLabelID> <ClassificationLabelFieldID>
(text <String>)|selection <ClassificationLabelSelectionIDList>)|
(integer <Number>)|(date <Date>)|(user <EmailAddressList>))*
(deletelabelfield <ClassificationLabelID> <ClassificationLabelFieldID>)*
[nodetails]
```
By default, details of the process labels are displayed, use `nodetails` to suppress this display.

View File

@@ -1,4 +1,4 @@
!# Users - Classroom - Profile # Users - Classroom - Profile
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Display Classroom profile](#display-classroom-profile) - [Display Classroom profile](#display-classroom-profile)

View File

@@ -1,4 +1,4 @@
!# User Contacts # User Contacts
- [Notes](#notes) - [Notes](#notes)
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](#query-documentation) - [Query documentation](#query-documentation)

View File

@@ -1,4 +1,4 @@
!# Users - Deprovision # Users - Deprovision
- [Introduction](#introduction) - [Introduction](#introduction)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Deprovision a user](#deprovision-a-user) - [Deprovision a user](#deprovision-a-user)

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Activity/Settings # Users - Drive - Activity/Settings
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](Users-Drive-Query) - [Query documentation](Users-Drive-Query)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Cleanup # Users - Drive - Cleanup
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Display empty folders](#display-empty-folders) - [Display empty folders](#display-empty-folders)

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Comments # Users - Drive - Comments
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](Users-Drive-Query) - [Query documentation](Users-Drive-Query)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -416,7 +416,7 @@ gam <UserTypeEntity> show fileinfo <DriveFileEntity>
[allfields|<DriveFieldName>*|(fields <DriveFieldNameList>)] [allfields|<DriveFieldName>*|(fields <DriveFieldNameList>)]
(orderby <DriveFileOrderByFieldName> [ascending|descending])* (orderby <DriveFileOrderByFieldName> [ascending|descending])*
[showdrivename] [showshareddrivepermissions] [showdrivename] [showshareddrivepermissions]
[(showlabels details|ids)|(includelabels <DriveLabelIDList>)] [(showlabels details|ids)|(includelabels <ClassificationLabelIDList>)]
[showparentsidsaslist] [followshortcuts [<Boolean>]] [showparentsidsaslist] [followshortcuts [<Boolean>]]
[stripcrsfromname] [stripcrsfromname]
[formatjson] [formatjson]
@@ -426,7 +426,7 @@ gam <UserTypeEntity> info drivefile <DriveFileEntity>
[allfields|<DriveFieldName>*|(fields <DriveFieldNameList>)] [allfields|<DriveFieldName>*|(fields <DriveFieldNameList>)]
(orderby <DriveFileOrderByFieldName> [ascending|descending])* (orderby <DriveFileOrderByFieldName> [ascending|descending])*
[showdrivename] [showshareddrivepermissions] [showdrivename] [showshareddrivepermissions]
[(showlabels details|ids)|(includelabels <DriveLabelIDList>)] [(showlabels details|ids)|(includelabels <ClassificationLabelIDList>)]
[showparentsidsaslist] [followshortcuts [<Boolean>]] [showparentsidsaslist] [followshortcuts [<Boolean>]]
[stripcrsfromname] [stripcrsfromname]
[formatjson] [formatjson]
@@ -471,18 +471,18 @@ an API call per file is required to get the information.
* `showlabels details` * `showlabels details`
``` ```
labels: labels:
id: <DriveLabelID> id: <ClassificationLabelID>
revisionId: <Number> revisionId: <Number>
id: <DriveLabelID> id: <ClassificationLabelID>
revisionId: <Number> revisionId: <Number>
``` ```
* `showlabels ids` * `showlabels ids`
``` ```
labelsIds: <DriveLabelID> <DriveLabelID> ... labelsIds: <ClassificationLabelID> <ClassificationLabelID> ...
``` ```
Starting in version 6.27.02, you can get Drive label information without an extra API call Starting in version 6.27.02, you can get Drive label information without an extra API call
if you know the `<DriveLabelID>`s. Add `labelinfo` to your `fields` list and use `includelabels <DriveLabelIDList>` if you know the `<ClassificationLabelID>`s. Add `labelinfo` to your `fields` list and use `includelabels <ClassificationLabelIDList>`
to specify the Drive labels. to specify the Drive labels.
``` ```
gam user user@domain.com show fileinfo <DriveFileEntity> fields id,name,mimetype,labelinfo includelabels "mRoha85IbwCRl490E00xGLvBsSbkwIiuZ6PRNNEbbFcb" gam user user@domain.com show fileinfo <DriveFileEntity> fields id,name,mimetype,labelinfo includelabels "mRoha85IbwCRl490E00xGLvBsSbkwIiuZ6PRNNEbbFcb"
@@ -1079,7 +1079,7 @@ gam <UserTypeEntity> print|show filelist [todrive <ToDriveAttribute>*]
[filepath|fullpath [folderpathonly [<Boolean>]] [pathdelimiter <Character>] [addpathstojson] [showdepth]] [buildtree] [filepath|fullpath [folderpathonly [<Boolean>]] [pathdelimiter <Character>] [addpathstojson] [showdepth]] [buildtree]
[allfields|<DriveFieldName>*|(fields <DriveFieldNameList>)] [allfields|<DriveFieldName>*|(fields <DriveFieldNameList>)]
[showdrivename] [showshareddrivepermissions] [showdrivename] [showshareddrivepermissions]
[(showlabels details|ids)|(includelabels <DriveLabelIDList>)] [(showlabels details|ids)|(includelabels <ClassificationLabelIDList>)]
[showparentsidsaslist] [showpermissionslast] [showparentsidsaslist] [showpermissionslast]
(orderby <DriveFileOrderByFieldName> [ascending|descending])* [delimiter <Character>] (orderby <DriveFileOrderByFieldName> [ascending|descending])* [delimiter <Character>]
[stripcrsfromname] [stripcrsfromname]

View File

@@ -18,7 +18,7 @@
- [Purge files](#purge-files) - [Purge files](#purge-files)
- [Copy/Move Files](Users-Drive-Copy-Move) - [Copy/Move Files](Users-Drive-Copy-Move)
- [Shortcuts](Users-Drive-Shortcuts) - [Shortcuts](Users-Drive-Shortcuts)
- [Drive Labels](Users-Drive-Labels) - [Classification Labels](Users-Classification-Labels)
- [Download Google Documents as JSON](#download-google-documents-as-json) - [Download Google Documents as JSON](#download-google-documents-as-json)
- [Upload changes to Google Documents](#upload-changes-to-google-documents) - [Upload changes to Google Documents](#upload-changes-to-google-documents)

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Orphans # Users - Drive - Orphans
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Collect orphaned files](#collect-orphaned-files) - [Collect orphaned files](#collect-orphaned-files)

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Ownership # Users - Drive - Ownership
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](Users-Drive-Query) - [Query documentation](Users-Drive-Query)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Query # Users - Drive - Query
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](#query-documentation) - [Query documentation](#query-documentation)

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Revisions # Users - Drive - Revisions
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](Users-Drive-Query) - [Query documentation](Users-Drive-Query)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Drive Shortcuts # Users - Drive Shortcuts
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](Users-Drive-Query) - [Query documentation](Users-Drive-Query)
- [Python Regular Expressions](Python-Regular-Expressions) Sub function - [Python Regular Expressions](Python-Regular-Expressions) Sub function

View File

@@ -1,4 +1,4 @@
!# Users - Drive - Transfer # Users - Drive - Transfer
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](Users-Drive-Query) - [Query documentation](Users-Drive-Query)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Forms # Users - Forms
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Create a Form](#create-a-form) - [Create a Form](#create-a-form)

View File

@@ -1,4 +1,4 @@
!# Users - Gmail - Client Side Encryption # Users - Gmail - Client Side Encryption
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Gmail - Profile # Users - Gmail - Profile
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Display Gmail profile](#display-gmail-profile) - [Display Gmail profile](#display-gmail-profile)

View File

@@ -1,4 +1,4 @@
!# Users - Gmail - S/MIME # Users - Gmail - S/MIME
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Create Gmail S/MIME configuration](#create-gmail-smime-configuration) - [Create Gmail S/MIME configuration](#create-gmail-smime-configuration)

View File

@@ -1,4 +1,4 @@
!# Users - Gmail - Settings # Users - Gmail - Settings
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Manage IMAP/POP](#manage-imappop) - [Manage IMAP/POP](#manage-imappop)

View File

@@ -1,4 +1,4 @@
!# Users - Meet # Users - Meet
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](#query-documentation) - [Query documentation](#query-documentation)
- [Introduction](#introduction) - [Introduction](#introduction)

View File

@@ -1,4 +1,4 @@
!# Users - Photo # Users - Photo
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Upload a user's photo from a default file](#upload-a-users-photo-from-a-default-file) - [Upload a user's photo from a default file](#upload-a-users-photo-from-a-default-file)

View File

@@ -1,4 +1,4 @@
!# Users - Profile Sharing # Users - Profile Sharing
- [Definitions](#definitions) - [Definitions](#definitions)
- [Manage user's profile sharing](#manage-users-profile-sharing) - [Manage user's profile sharing](#manage-users-profile-sharing)
- [Display user's profile sharing](#display-users-profile-sharing) - [Display user's profile sharing](#display-users-profile-sharing)

View File

@@ -1,4 +1,4 @@
!# Users - Shared Drives # Users - Shared Drives
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](#query-documentation) - [Query documentation](#query-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Signout and Turn off 2-Step Verification # Users - Signout and Turn off 2-Step Verification
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Signout Users](#signout-users) - [Signout Users](#signout-users)

View File

@@ -1,4 +1,4 @@
!# Users - Spreadsheets # Users - Spreadsheets
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Query documentation](#query-documentation) - [Query documentation](#query-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Tasks # Users - Tasks
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Notes](#notes) - [Notes](#notes)
- [Definitions](#definitions) - [Definitions](#definitions)

View File

@@ -1,4 +1,4 @@
!# Users - Tokens # Users - Tokens
- [API documentation](#api-documentation) - [API documentation](#api-documentation)
- [Definitions](#definitions) - [Definitions](#definitions)
- [Delete a user's token](#delete-a-users-token) - [Delete a user's token](#delete-a-users-token)

Some files were not shown because too many files have changed in this diff Show More