Validate device queries

This commit is contained in:
Ross Scroggs
2026-05-18 16:56:56 -07:00
parent e25c302616
commit dfe01e5272
7 changed files with 21 additions and 14 deletions

View File

@@ -456,9 +456,9 @@
See: https://cloud.google.com/access-context-manager/docs/custom-access-level-spec See: https://cloud.google.com/access-context-manager/docs/custom-access-level-spec
<QueryContact> ::= <String> <QueryContact> ::= <String>
See: https://developers.google.com/google-apps/contacts/v3/reference#contacts-query-parameters-reference See: https://developers.google.com/google-apps/contacts/v3/reference#contacts-query-parameters-reference
<QueryCrOS> ::= <String> <QueryCrOS> ::= <String>:<String>
See: https://support.google.com/chrome/a/answer/1698333 See: https://support.google.com/chrome/a/answer/1698333
<QueryDevice> ::= <String> <QueryDevice> ::= <String>:<String>
See: https://support.google.com/a/answer/7549103 See: https://support.google.com/a/answer/7549103
<QueryDriveFile> ::= <String> <QueryDriveFile> ::= <String>
See: https://developers.google.com/drive/api/v3/search-files See: https://developers.google.com/drive/api/v3/search-files
@@ -471,7 +471,7 @@
<QueryItem> ::= <UniqueID>|<String> <QueryItem> ::= <UniqueID>|<String>
<QueryMemberRestrictions> ::= <String> <QueryMemberRestrictions> ::= <String>
See: https://cloud.google.com/identity/docs/reference/rest/v1beta1/SecuritySettings#MemberRestriction See: https://cloud.google.com/identity/docs/reference/rest/v1beta1/SecuritySettings#MemberRestriction
<QueryMobile> ::= <String> <QueryMobile> ::= <String>:<String>
See: https://support.google.com/a/answer/7549103 See: https://support.google.com/a/answer/7549103
<QueryTeamDrive> ::= <String> <QueryTeamDrive> ::= <String>
See: https://developers.google.com/drive/api/v3/search-parameters See: https://developers.google.com/drive/api/v3/search-parameters

View File

@@ -68,7 +68,8 @@ gam oauth create
``` ```
<OrgUnitPath> ::= /|(/<String)+ <OrgUnitPath> ::= /|(/<String)+
<QueryCrOS> ::= <String> See: https://support.google.com/chrome/a/answer/1698333 <QueryCrOS> ::= <String>:<String>
See: https://support.google.com/chrome/a/answer/1698333
<CommandID> ::= <String> <CommandID> ::= <String>
<CrOSID> ::= <String> <CrOSID> ::= <String>
<CrOSIDList> ::= "<CrOSID>(,<CrOSID>)*" <CrOSIDList> ::= "<CrOSID>(,<CrOSID>)*"

View File

@@ -56,7 +56,7 @@ Use this table to filter/query for specific device types:
``` ```
<AssetTag> ::= <String> <AssetTag> ::= <String>
<AssetTagList> ::= "<AssetTag>(,<AssetTag>)*" <AssetTagList> ::= "<AssetTag>(,<AssetTag>)*"
<QueryDevice> ::= <String> <QueryDevice> ::= <String>:<String>
See: https://support.google.com/a/answer/7549103 See: https://support.google.com/a/answer/7549103
<QueryDeviceList> ::= "<QueryDevice>(,<QueryDevice>)*" <QueryDeviceList> ::= "<QueryDevice>(,<QueryDevice>)*"
<DeviceID> ::= devices/<String> <DeviceID> ::= devices/<String>

View File

@@ -10,6 +10,12 @@ 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.43.06
Updated commands that use `<QueryCrOS>`, `<QueryDevice>` or `<QueryMobile>` to validate
that it is of the form `field:value` and that `value` does not contain a '?'.
Without validation, Google can return many more devices than are expected.
### 7.43.05 ### 7.43.05
Added option `matchfield attendeesorganizer <Boolean> <EmailAddressEntity>` to `<EventMatchProperty>` Added option `matchfield attendeesorganizer <Boolean> <EmailAddressEntity>` to `<EventMatchProperty>`

View File

@@ -251,7 +251,7 @@ writes the credentials into the file oauth2.txt.
``` ```
gamteam@server:/Users/gamteam$ rm -f /Users/gamteam/GAMConfig/oauth2.txt gamteam@server:/Users/gamteam$ rm -f /Users/gamteam/GAMConfig/oauth2.txt
gamteam@server:/Users/gamteam$ gam version gamteam@server:/Users/gamteam$ gam version
GAM 7.43.05 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.06 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -1034,7 +1034,7 @@ writes the credentials into the file oauth2.txt.
``` ```
C:\>del C:\GAMConfig\oauth2.txt C:\>del C:\GAMConfig\oauth2.txt
C:\>gam version C:\>gam version
GAM 7.43.05 - https://github.com/GAM-team/GAM - pythonsource GAM 7.43.06 - https://github.com/GAM-team/GAM - pythonsource
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
Windows 11 10.0.26200 AMD64 Windows 11 10.0.26200 AMD64

View File

@@ -16,7 +16,7 @@
## Definitions ## Definitions
``` ```
<QueryMobile> ::= <String> <QueryMobile> ::= <String>:<String>
See: https://support.google.com/a/answer/7549103 See: https://support.google.com/a/answer/7549103
<QueryMobileList> ::= "<QueryMobile>(,<QueryMobile>)*" <QueryMobileList> ::= "<QueryMobile>(,<QueryMobile>)*"
<ResourceID> ::= <String> <ResourceID> ::= <String>

View File

@@ -3,7 +3,7 @@
Print the current version of Gam with details Print the current version of Gam with details
``` ```
gam version gam version
GAM 7.43.05 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.06 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -15,7 +15,7 @@ Time: 2026-02-15T07:51:00-08:00
Print the current version of Gam with details and time offset information Print the current version of Gam with details and time offset information
``` ```
gam version timeoffset gam version timeoffset
GAM 7.43.05 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.06 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -27,7 +27,7 @@ Your system time differs from www.googleapis.com by less than 1 second
Print the current version of Gam with extended details and SSL information Print the current version of Gam with extended details and SSL information
``` ```
gam version extended gam version extended
GAM 7.43.05 - https://github.com/GAM-team/GAM - pyinstaller GAM 7.43.06 - https://github.com/GAM-team/GAM - pyinstaller
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64
@@ -68,7 +68,7 @@ MacOS High Sierra 10.13.6 x86_64
Path: /Users/gamteam/bin/gam7 Path: /Users/gamteam/bin/gam7
Version Check: Version Check:
Current: 5.35.08 Current: 5.35.08
Latest: 7.43.05 Latest: 7.43.06
echo $? echo $?
1 1
``` ```
@@ -76,7 +76,7 @@ echo $?
Print the current version number without details Print the current version number without details
``` ```
gam version simple gam version simple
7.43.05 7.43.06
``` ```
In Linux/MacOS you can do: In Linux/MacOS you can do:
``` ```
@@ -86,7 +86,7 @@ echo $VER
Print the current version of Gam and address of this Wiki Print the current version of Gam and address of this Wiki
``` ```
gam help gam help
GAM 7.43.05 - https://github.com/GAM-team/GAM GAM 7.43.06 - https://github.com/GAM-team/GAM
GAM Team <google-apps-manager@googlegroups.com> GAM Team <google-apps-manager@googlegroups.com>
Python 3.14.4 64-bit final Python 3.14.4 64-bit final
macOS Tahoe 26.4.1 arm64 macOS Tahoe 26.4.1 arm64