Classification labels are now available for Gmail in addition to Drive.

GAM-team · Nov 2, 2024 · 31e8ac1 · 31e8ac1
1 parent a9c4c00
commit 31e8ac1
Show file tree

Hide file tree

Showing 105 changed files with 290 additions and 260 deletions.
diff --git a/docs/Addresses.md b/docs/Addresses.md
@@ -1,4 +1,4 @@
-!# Addresses
+# Addresses
 - [API documentation](#api-documentation)
 - [Display addresses](#display-addresses)
 

diff --git a/docs/Administrators.md b/docs/Administrators.md
@@ -1,4 +1,4 @@
-!# Administrators
+# Administrators
 - [Administrator roles documentation](#administrator-roles-documentation)
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)

diff --git a/docs/Alert-Center.md b/docs/Alert-Center.md
@@ -1,4 +1,4 @@
-!# Alert Center
+# Alert Center
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Introduction](#introduction)

diff --git a/docs/Authorization.md b/docs/Authorization.md
@@ -973,8 +973,8 @@ gam user [email protected] update serviceaccount
 [*] 18)  Drive API (supports readonly)
 [*] 19)  Drive API - todrive
 [*] 20)  Drive Activity API v2 - must pair with Drive API
-[*] 21)  Drive Labels API v2beta - Admin (supports readonly)
-[*] 22)  Drive Labels API v2beta - User (supports readonly)
+[*] 21)  Drive Labels API - Admin (supports readonly)
+[*] 22)  Drive Labels API - User (supports readonly)
 [*] 23)  Forms API
 [*] 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)

diff --git a/docs/BNF-Syntax.md b/docs/BNF-Syntax.md
@@ -1,4 +1,4 @@
-!# Syntax
+# Syntax
 
 ## BNF Syntax
 This Wiki describes the GAM7 command line syntax in modified BNF.

diff --git a/docs/Basic-Items.md b/docs/Basic-Items.md
@@ -283,6 +283,11 @@
 <GIGroupItem> ::= <EmailAddress>|<UniqueID>|groups/<String>
 <CIGroupType> ::= customer|group|other|serviceaccount|user
 <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>
 <ClientID> ::= <String>
 <CommandID> ::= <String>
@@ -352,11 +357,6 @@
 <DriveFilePermissionID> ::= anyone|anyonewithlink|id:<String>
 <DriveFilePermissionIDorEmail> ::= <DriveFilePermissionID>|<EmailAddress>
 <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>
 <EmailItem> ::= <EmailAddress>|<UniqueID>|<String>
 <EmailReplacement> ::= <String>

diff --git a/docs/Bulk-Processing.md b/docs/Bulk-Processing.md
@@ -1,4 +1,4 @@
-!# Bulk Processing
+# Bulk Processing
 - [Introduction](#introduction)
 - [Python Regular Expressions](Python-Regular-Expressions)
 - [GAM Configuration](gam.cfg)

diff --git a/docs/CSV-Special-Characters.md b/docs/CSV-Special-Characters.md
@@ -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 variables that control CSV file reading/writing:

diff --git a/docs/Chat-Bot.md b/docs/Chat-Bot.md
@@ -1,4 +1,4 @@
-!# Chat Bot
+# Chat Bot
 
 - [Notes](#notes)
 - [API documentation](#api-documentation)

diff --git a/docs/Chrome-AUE-Counts.md b/docs/Chrome-AUE-Counts.md
@@ -1,4 +1,4 @@
-!# Chrome Auto Update Expiration Counts
+# Chrome Auto Update Expiration Counts
 
 - [Chrome Auto Update Expiration Counts](#chrome-auto-update-expiration-counts)
   - [API documentation](#api-documentation)

diff --git a/docs/Chrome-Installed-Apps.md b/docs/Chrome-Installed-Apps.md
@@ -1,4 +1,4 @@
-!# Chrome Installed Apps Counts
+# Chrome Installed Apps Counts
 
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)

diff --git a/docs/Chrome-Needs-Attention-Counts.md b/docs/Chrome-Needs-Attention-Counts.md
@@ -1,4 +1,4 @@
-!# Chrome Device Needs Attention Counts
+# Chrome Device Needs Attention Counts
 
 - [Chrome Device Needs Attention Counts](#chrome-device-needs-attention-counts)
   - [API documentation](#api-documentation)

diff --git a/docs/Chrome-Policies.md b/docs/Chrome-Policies.md
@@ -1,4 +1,4 @@
-!# Chrome Policies
+# Chrome Policies
 
 - [Chrome Policies](#chrome-policies)
   - [Chrome Version History](Chrome-Version-History)

diff --git a/docs/Chrome-Printers.md b/docs/Chrome-Printers.md
@@ -1,4 +1,4 @@
-!# Chrome Printers
+# Chrome Printers
 - [API documentation](#api-documentation)
 - [Notes](#notes)
 - [Definitions](#definitions)

diff --git a/docs/Chrome-Version-Counts.md b/docs/Chrome-Version-Counts.md
@@ -1,4 +1,4 @@
-!# Chrome Version Counts
+# Chrome Version Counts
 
 - [Chrome Version Counts](#chrome-version-counts)
   - [API documentation](#api-documentation)

diff --git a/docs/Chrome-Version-History.md b/docs/Chrome-Version-History.md
@@ -1,4 +1,4 @@
-!# Chrome Version History
+# Chrome Version History
 
 - [Chrome Version History](#chrome-version-history)
   - [API documentation](#api-documentation)

diff --git a/docs/Cloud-Channel.md b/docs/Cloud-Channel.md
@@ -1,4 +1,4 @@
-!# Cloud Channel
+# Cloud Channel
 - [API documentation](#api-documentation)
 - [Notes](#notes)
 - [Definitions](#definitions)

diff --git a/docs/Cloud-Identity-Devices.md b/docs/Cloud-Identity-Devices.md
@@ -1,4 +1,4 @@
-!# Cloud Identity Devices
+# Cloud Identity Devices
 - [API documentation](#api-documentation)
 - [Query documentation](#query-documentation)
 - [Definitions](#definitions)

diff --git a/docs/Cloud-Storage.md b/docs/Cloud-Storage.md
@@ -1,4 +1,4 @@
-!# Cloud Storage
+# Cloud Storage
 - [API documentation](#api-documentation)
 - [Notes](#notes)
 - [Definitions](#definitions)

diff --git a/docs/Collections-of-ChromeOS-Devices.md b/docs/Collections-of-ChromeOS-Devices.md
@@ -1,4 +1,4 @@
-!# Collections of ChromeOS Devices
+# Collections of ChromeOS Devices
 - [Python Regular Expressions](Python-Regular-Expressions) Match function
 - [Definitions](#definitions)
 - [Organization Unit Quoting](#organization-unit-quoting)

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

diff --git a/docs/Collections-of-Users.md b/docs/Collections-of-Users.md
@@ -1,4 +1,4 @@
-!# Collections of Users
+# Collections of Users
 - [Python Regular Expressions](Python-Regular-Expressions) Match function
 - [Definitions](#definitions)
 - [List quoting rules](#list-quoting-rules)

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

diff --git a/docs/Command-Line-Parsing.md b/docs/Command-Line-Parsing.md
@@ -1,4 +1,4 @@
-!# Command Line Parsing
+# Command Line Parsing
 - [Linux and MacOS](#linux-and-macos)
 - [Windows Command Prompt](#windows-command-prompt)
 - [Windows PowerShell](#windows-powershell)

diff --git a/docs/Command-Logging-Progress.md b/docs/Command-Logging-Progress.md
@@ -1,4 +1,4 @@
-!# Command Logging and Progress
+# Command Logging and Progress
 - [Introduction](#introduction)
 - [GAM Configuration](gam.cfg)
 - [Command Logging](#command-logging)

diff --git a/docs/Customer.md b/docs/Customer.md
@@ -1,4 +1,4 @@
-!# Customer
+# Customer
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Update customer](#update-customer)

diff --git a/docs/Domains-Verification.md b/docs/Domains-Verification.md
@@ -1,4 +1,4 @@
-!# Domains - Verification
+# Domains - Verification
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Introduction](#introduction)

diff --git a/docs/Domains.md b/docs/Domains.md
@@ -1,4 +1,4 @@
-!# Domains
+# Domains
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Create a domain](#create-a-domain)

diff --git a/docs/Downloads-Installs.md b/docs/Downloads-Installs.md
@@ -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.
 Choose one of the following:
 

diff --git a/docs/Drive-Items.md b/docs/Drive-Items.md
@@ -1,4 +1,4 @@
-!# Drive Items
+# Drive Items
 - [Basic Items](Basic-Items)
 - [List Items](List-Items)
 ```

diff --git a/docs/Email-Audit-Monitor.md b/docs/Email-Audit-Monitor.md
@@ -1,4 +1,4 @@
-!# Email Audit Monitor
+# Email Audit Monitor
 - [API documentation](#api-documentation)
 - [Notes](#notes)
 - [Definitions](#definitions)

diff --git a/docs/Find-File-Owner.md b/docs/Find-File-Owner.md
@@ -1,4 +1,4 @@
-!# Find File Owner
+# Find File Owner
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Display File Ownership](#display-file-ownership)

diff --git a/docs/GAM-Return-Codes.md b/docs/GAM-Return-Codes.md
@@ -1,4 +1,4 @@
-!# GAM Return Codes
+# GAM Return Codes
 
 These are the return codes used by GAM7.
 

diff --git a/docs/GAM-with-minimal-GCP-rights.md b/docs/GAM-with-minimal-GCP-rights.md
@@ -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.
 

diff --git a/docs/GAM7-on-Android-Devices.md b/docs/GAM7-on-Android-Devices.md
@@ -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).
 
 _Note: Chromebooks / Chrome OS devices should install GAM7 using [these instructions](GAM7-on-Chrome-OS-Devices)._

diff --git a/docs/GAM7-on-Chrome-OS-Devices.md b/docs/GAM7-on-Chrome-OS-Devices.md
@@ -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.
 
 1. [Set up Linux on your Chromebook](https://support.google.com/chromebook/answer/9145439?hl=en).

diff --git a/docs/GamUpdates.md b/docs/GamUpdates.md
@@ -10,6 +10,24 @@ Add the `-s` option to the end of the above commands to suppress creating the `g
 
 See [Downloads-Installs-GAM7](https://github.com/GAM-team/GAM/wiki/Downloads-Installs) for Windows or other options, including manual installation
 
+### 7.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.

diff --git a/docs/Google-Data-Transfers.md b/docs/Google-Data-Transfers.md
@@ -1,4 +1,4 @@
-!# Google Data Transfers
+# Google Data Transfers
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Display transfer apps](#display-transfer-apps)

diff --git a/docs/Google-Network-Addresses.md b/docs/Google-Network-Addresses.md
@@ -1,4 +1,4 @@
-!# Google Network Addresses
+# Google Network Addresses
 
 All GAM calls are made on port 443 (HTTPS) to the following addresses:
 ```

diff --git a/docs/HTTPS-Proxy.md b/docs/HTTPS-Proxy.md
@@ -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.
 However, if you must push GAM traffic through an HTTPS proxy this can be done by setting the HTTPS_PROXY environment variable.

diff --git a/docs/How-to-Install-GAM7.md b/docs/How-to-Install-GAM7.md
@@ -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
 and all necessary authentications.
 

diff --git a/docs/How-to-Uninstall-GAM7.md b/docs/How-to-Uninstall-GAM7.md
@@ -1,4 +1,4 @@
-!# Uninstalling GAM7
+# Uninstalling GAM7
 
 - [Get Project Info](#get-project-info)
 - [Remove Client API access](#remove-client-api-access)

diff --git a/docs/How-to-Update-GAM7.md b/docs/How-to-Update-GAM7.md
@@ -1,4 +1,4 @@
-!# Updating GAM7
+# Updating GAM7
 Use these steps to update your version of GAM7.
 
 - [Downloads-Installs](Downloads-Installs)

diff --git a/docs/How-to-Upgrade-Legacy-GAM-to-GAM7.md b/docs/How-to-Upgrade-Legacy-GAM-to-GAM7.md
@@ -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$ gam version
 WARNING: Config File: /Users/admin/GAMConfig/gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: /Users/admin/GAMConfig/oauth2.txt, Not Found
-GAM 7.00.34 - https://github.com/GAM-team/GAM - pyinstaller
+GAM 7.00.35 - https://github.com/GAM-team/GAM - pyinstaller
 GAM Team <[email protected]>
 Python 3.13.0 64-bit final
 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:\>gam version
 WARNING: Config File: C:\GAMConfig\gam.cfg, Section: DEFAULT, Item: oauth2_txt, Value: C:\GAMConfig\oauth2.txt, Not Found
-GAM7 7.00.34 - https://github.com/GAM-team/GAM - pythonsource
+GAM7 7.00.35 - https://github.com/GAM-team/GAM - pythonsource
 GAM Team <[email protected]>
 Python 3.13.0 64-bit final
 Windows-10-10.0.17134 AMD64

diff --git a/docs/Inbound-SSO.md b/docs/Inbound-SSO.md
@@ -1,4 +1,4 @@
-!# Inbound SSO
+# Inbound SSO
 - [Admin Console](#admin-console)
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)

diff --git a/docs/Licenses.md b/docs/Licenses.md
@@ -1,4 +1,4 @@
-!# Licenses
+# Licenses
 - [API documentation](#api-documentation)
 - [License Products and SKUs](#license-products-and-skus)
 - [Definitions](#definitions)

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

diff --git a/docs/List.md b/docs/List.md
@@ -1,4 +1,4 @@
-!# List
+# List
 
 The list command is used to verify collections of objects.
 

diff --git a/docs/Meta-Commands-and-File-Redirection.md b/docs/Meta-Commands-and-File-Redirection.md
@@ -1,4 +1,4 @@
-!# Meta Commands and File Redirection
+# Meta Commands and File Redirection
 
 - [GAM Configuration](gam.cfg)
 - [Todrive](Todrive)

diff --git a/docs/Mobile-Devices.md b/docs/Mobile-Devices.md
@@ -1,4 +1,4 @@
-!# Mobile Devices
+# Mobile Devices
 - [API documentation](#api-documentation)
 - [Query documentation](#query-documentation)
 - [Definitions](#definitions)

diff --git a/docs/Organizational-Units.md b/docs/Organizational-Units.md
@@ -1,4 +1,4 @@
-!# Organizational Units
+# Organizational Units
 - [API documentation](#api-documentation)
 - [Definitions](#definitions)
 - [Special quoting](#special-quoting)

diff --git a/docs/Other-Resources.md b/docs/Other-Resources.md
@@ -1,4 +1,4 @@
-!# Other Resources
+# Other Resources
 
 The following are links to contributions of others in support of GAM7.