mirror of
https://github.com/GAM-team/GAM.git
synced 2026-06-28 18:01:36 +00:00
Compare commits
4 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0739bdc642 | ||
|
|
ddd1924c2c | ||
|
|
a6fb1d7c0f | ||
|
|
6aeed76e70 |
@@ -387,6 +387,9 @@ If an item contains spaces, it should be surrounded by ".
|
|||||||
<ChatMessage> ::= spaces/<String>/messages/<String>
|
<ChatMessage> ::= spaces/<String>/messages/<String>
|
||||||
<ChatSpace> ::= spaces/<String> | space <String> | space spaces/<String>
|
<ChatSpace> ::= spaces/<String> | space <String> | space spaces/<String>
|
||||||
<ChatThread> ::= spaces/<String>/threads/<String>
|
<ChatThread> ::= spaces/<String>/threads/<String>
|
||||||
|
<ChromeProfilePermanentID> ::= <String>
|
||||||
|
<ChromeProfileName> ::= customers/<CustomerID>/profiles/<ChromeProfilePermanentID> | <ChromeProfilePermanentID>
|
||||||
|
<ChromeProfileCommandName> ::= <ChomeProfileName>/commands/<String>
|
||||||
<GIGroupAlias> ::= <EmailAddress>
|
<GIGroupAlias> ::= <EmailAddress>
|
||||||
<GIGroupItem> ::= <EmailAddress>|<UniqueID>|groups/<String>
|
<GIGroupItem> ::= <EmailAddress>|<UniqueID>|groups/<String>
|
||||||
<CIGroupMemberType> ::= cbcmbrowser|chromeosdevice|customer|group|other|serviceaccount|user
|
<CIGroupMemberType> ::= cbcmbrowser|chromeosdevice|customer|group|other|serviceaccount|user
|
||||||
@@ -530,6 +533,7 @@ If an item contains spaces, it should be surrounded by ".
|
|||||||
<Password> ::= <String>
|
<Password> ::= <String>
|
||||||
<PeopleResourceName> ::= people/<String>
|
<PeopleResourceName> ::= people/<String>
|
||||||
<PrinterID> ::= <String>
|
<PrinterID> ::= <String>
|
||||||
|
<ChromeProfileID> ::= <String>
|
||||||
<ProjectID> ::= <String>
|
<ProjectID> ::= <String>
|
||||||
Must match this Python Regular Expression: [a-z][a-z0-9-]{4,28}[a-z0-9]
|
Must match this Python Regular Expression: [a-z][a-z0-9-]{4,28}[a-z0-9]
|
||||||
<ProjectName> ::= <String>
|
<ProjectName> ::= <String>
|
||||||
@@ -2215,6 +2219,10 @@ gam show chromeneedsattn
|
|||||||
|
|
||||||
# Chrome Profile Management
|
# Chrome Profile Management
|
||||||
|
|
||||||
|
<ChromeProfilePermanentID> ::= <String>
|
||||||
|
<ChromeProfileName> ::= customers/<CustomerID>/profiles/<ChromeProfilePermanentID> | <ChromeProfilePermanentID>
|
||||||
|
<ChromeProfileCommandName> ::= <ChomeProfileName>/commands/<String>
|
||||||
|
|
||||||
<ChromeProfileFieldName> ::=
|
<ChromeProfileFieldName> ::=
|
||||||
affiliationstate|
|
affiliationstate|
|
||||||
annotatedlocation|
|
annotatedlocation|
|
||||||
@@ -2273,7 +2281,19 @@ gam print chromeprofiles [todrive <ToDriveAttribute>*]
|
|||||||
[filtertime.* <Time>] [filter <String>]
|
[filtertime.* <Time>] [filter <String>]
|
||||||
[orderby <ChromeProfileOrderByFieldName> [ascending|descending]]
|
[orderby <ChromeProfileOrderByFieldName> [ascending|descending]]
|
||||||
<ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]
|
<ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]
|
||||||
[[formatjson [quotechar <Character>]]
|
[formatjson [quotechar <Character>]]
|
||||||
|
|
||||||
|
gam create chromeprofilecommand <ChromeProfileName>
|
||||||
|
[clearcache [<Boolean>]] [clearcookies [<Boolean>]]
|
||||||
|
[formatjson]
|
||||||
|
|
||||||
|
gam info chromeprofilecommand <ChromeProfileCommandName>
|
||||||
|
[formatjson]
|
||||||
|
|
||||||
|
gam show chromeprofilecommands <ChromeProfileName>
|
||||||
|
[formatjson]
|
||||||
|
gam print chromeprofilecommands <ChromeProfileName> [todrive <ToDriveAttribute>*]
|
||||||
|
[formatjson [quotechar <Character>]]
|
||||||
|
|
||||||
# Chrome Versions Counts
|
# Chrome Versions Counts
|
||||||
|
|
||||||
|
|||||||
@@ -1,3 +1,10 @@
|
|||||||
|
7.13.00
|
||||||
|
|
||||||
|
Added commands that send remote commands to Chrome browser profiles and display the results;
|
||||||
|
at the moment, these commands can clear the browser cache and cookies.
|
||||||
|
|
||||||
|
* See: https://github.com/GAM-team/GAM/wiki/Chrome-Profile-Management#create-a-chrome-profile-command
|
||||||
|
|
||||||
7.12.02
|
7.12.02
|
||||||
|
|
||||||
Updated `gam print users` to handle the following error:
|
Updated `gam print users` to handle the following error:
|
||||||
|
|||||||
@@ -25,7 +25,7 @@ https://github.com/GAM-team/GAM/wiki
|
|||||||
"""
|
"""
|
||||||
|
|
||||||
__author__ = 'GAM Team <google-apps-manager@googlegroups.com>'
|
__author__ = 'GAM Team <google-apps-manager@googlegroups.com>'
|
||||||
__version__ = '7.12.02'
|
__version__ = '7.13.00'
|
||||||
__license__ = 'Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0)'
|
__license__ = 'Apache License 2.0 (http://www.apache.org/licenses/LICENSE-2.0)'
|
||||||
|
|
||||||
#pylint: disable=wrong-import-position
|
#pylint: disable=wrong-import-position
|
||||||
@@ -25606,7 +25606,7 @@ CHROMEPROFILE_ORDERBY_CHOICE_MAP = {
|
|||||||
# [filtertime.* <Time>] [filter <String>]
|
# [filtertime.* <Time>] [filter <String>]
|
||||||
# [orderby <ChromeProfileOrderByFieldName> [ascending|descending]]
|
# [orderby <ChromeProfileOrderByFieldName> [ascending|descending]]
|
||||||
# <ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]
|
# <ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]
|
||||||
# [[formatjson [quotechar <Character>]]
|
# [formatjson [quotechar <Character>]]
|
||||||
def doPrintShowChromeProfiles():
|
def doPrintShowChromeProfiles():
|
||||||
def _printProfile(profile):
|
def _printProfile(profile):
|
||||||
row = flattenJSON(profile, timeObjects=CHROMEPROFILE_TIME_OBJECTS)
|
row = flattenJSON(profile, timeObjects=CHROMEPROFILE_TIME_OBJECTS)
|
||||||
@@ -25676,6 +25676,112 @@ def doPrintShowChromeProfiles():
|
|||||||
csvPF.SetSortTitles(['name', 'profileId'])
|
csvPF.SetSortTitles(['name', 'profileId'])
|
||||||
csvPF.writeCSVfile('Chrome Profiles')
|
csvPF.writeCSVfile('Chrome Profiles')
|
||||||
|
|
||||||
|
CHROMEPROFILECOMMAND_TIME_OBJECTS = {
|
||||||
|
'clientExecutionTime',
|
||||||
|
'issueTime',
|
||||||
|
}
|
||||||
|
|
||||||
|
def _showChromeProfileCommand(profcmd, FJQC, i=0, count=0):
|
||||||
|
if FJQC.formatJSON:
|
||||||
|
printLine(json.dumps(cleanJSON(profcmd, timeObjects=CHROMEPROFILECOMMAND_TIME_OBJECTS),
|
||||||
|
ensure_ascii=False, sort_keys=True))
|
||||||
|
return
|
||||||
|
printEntity([Ent.CHROME_PROFILE_COMMAND, profcmd['name']], i, count)
|
||||||
|
Ind.Increment()
|
||||||
|
showJSON(None, profcmd, timeObjects=CHROMEPROFILECOMMAND_TIME_OBJECTS)
|
||||||
|
Ind.Decrement()
|
||||||
|
|
||||||
|
# gam create chromeprofilecommand <ChromeProfileName>
|
||||||
|
# [clearcache [<Boolean>]] [clearcookies [<Boolean>]]
|
||||||
|
# [formatjson]
|
||||||
|
def doCreateChromeProfileCommand():
|
||||||
|
cm = buildGAPIObject(API.CHROMEMANAGEMENT)
|
||||||
|
profileName = _getChromeProfileName()
|
||||||
|
body = {'commandType': 'clearBrowsingData', 'payload': {}}
|
||||||
|
FJQC = FormatJSONQuoteChar()
|
||||||
|
while Cmd.ArgumentsRemaining():
|
||||||
|
myarg = getArgument()
|
||||||
|
if myarg == 'clearcache':
|
||||||
|
body['payload']['clearCache'] = getBoolean()
|
||||||
|
elif myarg == 'clearcookies':
|
||||||
|
body['payload']['clearCookies'] = getBoolean()
|
||||||
|
else:
|
||||||
|
FJQC.GetFormatJSON(myarg)
|
||||||
|
try:
|
||||||
|
profcmd = callGAPI(cm.customers().profiles().commands(), 'create',
|
||||||
|
throwReasons=[GAPI.INVALID_ARGUMENT, GAPI.NOT_FOUND, GAPI.PERMISSION_DENIED],
|
||||||
|
parent=profileName, body=body)
|
||||||
|
_showChromeProfileCommand(profcmd, FJQC)
|
||||||
|
except (GAPI.invalidArgument, GAPI.notFound, GAPI.permissionDenied) as e:
|
||||||
|
entityActionFailedExit([Ent.CHROME_PROFILE_COMMAND, profileName], str(e))
|
||||||
|
|
||||||
|
# gam info chromeprofilecommand <ChromeProfileCommandName>
|
||||||
|
# [formatjson]
|
||||||
|
def doInfoChromeProfileCommand():
|
||||||
|
cm = buildGAPIObject(API.CHROMEMANAGEMENT)
|
||||||
|
profileCommandName = _getChromeProfileName()
|
||||||
|
FJQC = FormatJSONQuoteChar()
|
||||||
|
while Cmd.ArgumentsRemaining():
|
||||||
|
myarg = getArgument()
|
||||||
|
FJQC.GetFormatJSON(myarg)
|
||||||
|
try:
|
||||||
|
profcmd = callGAPI(cm.customers().profiles().commands(), 'get',
|
||||||
|
throwReasons=[GAPI.INVALID_ARGUMENT, GAPI.NOT_FOUND, GAPI.PERMISSION_DENIED],
|
||||||
|
name=profileCommandName)
|
||||||
|
_showChromeProfileCommand(profcmd, FJQC)
|
||||||
|
except (GAPI.invalidArgument, GAPI.notFound, GAPI.permissionDenied) as e:
|
||||||
|
entityActionFailedExit([Ent.CHROME_PROFILE, profileCommandName], str(e))
|
||||||
|
|
||||||
|
# gam show chromeprofilecommands <ChromeProfileName>
|
||||||
|
# [formatjson]
|
||||||
|
# gam print chromeprofilecommands <ChromeProfileName> [todrive <ToDriveAttribute>*]
|
||||||
|
# [formatjson [quotechar <Character>]]
|
||||||
|
def doPrintShowChromeProfileCommands():
|
||||||
|
def _printProfileCommand(profcmd):
|
||||||
|
row = flattenJSON(profcmd, timeObjects=CHROMEPROFILECOMMAND_TIME_OBJECTS)
|
||||||
|
if not FJQC.formatJSON:
|
||||||
|
csvPF.WriteRowTitles(row)
|
||||||
|
elif csvPF.CheckRowTitles(row):
|
||||||
|
csvPF.WriteRowNoFilter({'name': profcmd['name'],
|
||||||
|
'JSON': json.dumps(cleanJSON(profcmd, timeObjects=CHROMEPROFILECOMMAND_TIME_OBJECTS),
|
||||||
|
ensure_ascii=False, sort_keys=True)})
|
||||||
|
|
||||||
|
cm = buildGAPIObject(API.CHROMEMANAGEMENT)
|
||||||
|
csvPF = CSVPrintFile(['name']) if Act.csvFormat() else None
|
||||||
|
FJQC = FormatJSONQuoteChar(csvPF)
|
||||||
|
profileName = _getChromeProfileName()
|
||||||
|
while Cmd.ArgumentsRemaining():
|
||||||
|
myarg = getArgument()
|
||||||
|
if csvPF and myarg == 'todrive':
|
||||||
|
csvPF.GetTodriveParameters()
|
||||||
|
else:
|
||||||
|
FJQC.GetFormatJSONQuoteChar(myarg, True)
|
||||||
|
printGettingEntityItemForWhom(Ent.CHROME_PROFILE_COMMAND, profileName)
|
||||||
|
pageMessage = getPageMessage()
|
||||||
|
try:
|
||||||
|
feed = yieldGAPIpages(cm.customers().profiles().commands(), 'list', 'chromeBrowserProfileCommands',
|
||||||
|
pageMessage=pageMessage,
|
||||||
|
throwReasons=[GAPI.NOT_FOUND, GAPI.INVALID_ARGUMENT, GAPI.PERMISSION_DENIED],
|
||||||
|
parent=profileName, pageSize=100)
|
||||||
|
for profcmds in feed:
|
||||||
|
if not csvPF:
|
||||||
|
jcount = len(profcmds)
|
||||||
|
if not FJQC.formatJSON:
|
||||||
|
performActionNumItems(jcount, Ent.CHROME_PROFILE_COMMAND)
|
||||||
|
Ind.Increment()
|
||||||
|
j = 0
|
||||||
|
for profcmd in profcmds:
|
||||||
|
j += 1
|
||||||
|
_showChromeProfileCommand(profcmd, FJQC, j, jcount)
|
||||||
|
Ind.Decrement()
|
||||||
|
else:
|
||||||
|
for profcmd in profcmds:
|
||||||
|
_printProfileCommand(profcmd)
|
||||||
|
except (GAPI.notFound, GAPI.invalidArgument, GAPI.permissionDenied) as e:
|
||||||
|
entityActionFailedExit([Ent.CHROME_PROFILE, profileName], str(e))
|
||||||
|
if csvPF:
|
||||||
|
csvPF.writeCSVfile('Chrome Profile Commands')
|
||||||
|
|
||||||
BROWSER_ORDERBY_CHOICE_MAP = {
|
BROWSER_ORDERBY_CHOICE_MAP = {
|
||||||
'annotatedassetid': 'annotated_asset_id', 'asset': 'annotated_asset_id', 'assetid': 'annotated_asset_id',
|
'annotatedassetid': 'annotated_asset_id', 'asset': 'annotated_asset_id', 'assetid': 'annotated_asset_id',
|
||||||
'annotatedlocation': 'annotated_location', 'location': 'annotated_location',
|
'annotatedlocation': 'annotated_location', 'location': 'annotated_location',
|
||||||
@@ -76616,6 +76722,7 @@ MAIN_ADD_CREATE_FUNCTIONS = {
|
|||||||
Cmd.ARG_CHATMESSAGE: doCreateChatMessage,
|
Cmd.ARG_CHATMESSAGE: doCreateChatMessage,
|
||||||
Cmd.ARG_CHROMENETWORK: doCreateChromeNetwork,
|
Cmd.ARG_CHROMENETWORK: doCreateChromeNetwork,
|
||||||
Cmd.ARG_CHROMEPOLICYIMAGE: doCreateChromePolicyImage,
|
Cmd.ARG_CHROMEPOLICYIMAGE: doCreateChromePolicyImage,
|
||||||
|
Cmd.ARG_CHROMEPROFILECOMMAND: doCreateChromeProfileCommand,
|
||||||
Cmd.ARG_CIGROUP: doCreateCIGroup,
|
Cmd.ARG_CIGROUP: doCreateCIGroup,
|
||||||
Cmd.ARG_CONTACT: doCreateDomainContact,
|
Cmd.ARG_CONTACT: doCreateDomainContact,
|
||||||
Cmd.ARG_COURSE: doCreateCourse,
|
Cmd.ARG_COURSE: doCreateCourse,
|
||||||
@@ -76810,6 +76917,7 @@ MAIN_COMMANDS_WITH_OBJECTS = {
|
|||||||
Cmd.ARG_CHATSPACE: doInfoChatSpace,
|
Cmd.ARG_CHATSPACE: doInfoChatSpace,
|
||||||
Cmd.ARG_CHROMEAPP: doInfoChromeApp,
|
Cmd.ARG_CHROMEAPP: doInfoChromeApp,
|
||||||
Cmd.ARG_CHROMEPROFILE: doInfoChromeProfile,
|
Cmd.ARG_CHROMEPROFILE: doInfoChromeProfile,
|
||||||
|
Cmd.ARG_CHROMEPROFILECOMMAND: doInfoChromeProfileCommand,
|
||||||
Cmd.ARG_CHROMESCHEMA: doInfoChromePolicySchemas,
|
Cmd.ARG_CHROMESCHEMA: doInfoChromePolicySchemas,
|
||||||
Cmd.ARG_CIGROUP: doInfoCIGroups,
|
Cmd.ARG_CIGROUP: doInfoCIGroups,
|
||||||
Cmd.ARG_CIGROUPMEMBERS: doInfoCIGroupMembers,
|
Cmd.ARG_CIGROUPMEMBERS: doInfoCIGroupMembers,
|
||||||
@@ -76896,6 +77004,7 @@ MAIN_COMMANDS_WITH_OBJECTS = {
|
|||||||
Cmd.ARG_CHROMENEEDSATTN: doPrintShowChromeNeedsAttn,
|
Cmd.ARG_CHROMENEEDSATTN: doPrintShowChromeNeedsAttn,
|
||||||
Cmd.ARG_CHROMEPOLICY: doPrintShowChromePolicies,
|
Cmd.ARG_CHROMEPOLICY: doPrintShowChromePolicies,
|
||||||
Cmd.ARG_CHROMEPROFILE: doPrintShowChromeProfiles,
|
Cmd.ARG_CHROMEPROFILE: doPrintShowChromeProfiles,
|
||||||
|
Cmd.ARG_CHROMEPROFILECOMMAND: doPrintShowChromeProfileCommands,
|
||||||
Cmd.ARG_CHROMESCHEMA: doPrintShowChromePolicySchemas,
|
Cmd.ARG_CHROMESCHEMA: doPrintShowChromePolicySchemas,
|
||||||
Cmd.ARG_CHROMESNVALIDITY: doPrintChromeSnValidity,
|
Cmd.ARG_CHROMESNVALIDITY: doPrintChromeSnValidity,
|
||||||
Cmd.ARG_CHROMEVERSIONS: doPrintShowChromeVersions,
|
Cmd.ARG_CHROMEVERSIONS: doPrintShowChromeVersions,
|
||||||
@@ -77028,6 +77137,7 @@ MAIN_COMMANDS_WITH_OBJECTS = {
|
|||||||
Cmd.ARG_CHROMENEEDSATTN: doPrintShowChromeNeedsAttn,
|
Cmd.ARG_CHROMENEEDSATTN: doPrintShowChromeNeedsAttn,
|
||||||
Cmd.ARG_CHROMEPOLICY: doPrintShowChromePolicies,
|
Cmd.ARG_CHROMEPOLICY: doPrintShowChromePolicies,
|
||||||
Cmd.ARG_CHROMEPROFILE: doPrintShowChromeProfiles,
|
Cmd.ARG_CHROMEPROFILE: doPrintShowChromeProfiles,
|
||||||
|
Cmd.ARG_CHROMEPROFILECOMMAND: doPrintShowChromeProfileCommands,
|
||||||
Cmd.ARG_CHROMESCHEMA: doPrintShowChromePolicySchemas,
|
Cmd.ARG_CHROMESCHEMA: doPrintShowChromePolicySchemas,
|
||||||
Cmd.ARG_CHROMEVERSIONS: doPrintShowChromeVersions,
|
Cmd.ARG_CHROMEVERSIONS: doPrintShowChromeVersions,
|
||||||
Cmd.ARG_CIGROUPMEMBERS: doShowCIGroupMembers,
|
Cmd.ARG_CIGROUPMEMBERS: doShowCIGroupMembers,
|
||||||
@@ -77210,6 +77320,7 @@ MAIN_COMMANDS_OBJ_ALIASES = {
|
|||||||
Cmd.ARG_CHROMENETWORKS: Cmd.ARG_CHROMENETWORK,
|
Cmd.ARG_CHROMENETWORKS: Cmd.ARG_CHROMENETWORK,
|
||||||
Cmd.ARG_CHROMEPOLICIES: Cmd.ARG_CHROMEPOLICY,
|
Cmd.ARG_CHROMEPOLICIES: Cmd.ARG_CHROMEPOLICY,
|
||||||
Cmd.ARG_CHROMEPROFILES: Cmd.ARG_CHROMEPROFILE,
|
Cmd.ARG_CHROMEPROFILES: Cmd.ARG_CHROMEPROFILE,
|
||||||
|
Cmd.ARG_CHROMEPROFILECOMMANDS: Cmd.ARG_CHROMEPROFILECOMMAND,
|
||||||
Cmd.ARG_CHROMESCHEMAS: Cmd.ARG_CHROMESCHEMA,
|
Cmd.ARG_CHROMESCHEMAS: Cmd.ARG_CHROMESCHEMA,
|
||||||
Cmd.ARG_CIGROUPS: Cmd.ARG_CIGROUP,
|
Cmd.ARG_CIGROUPS: Cmd.ARG_CIGROUP,
|
||||||
Cmd.ARG_CIGROUPSMEMBERS: Cmd.ARG_CIGROUPMEMBERS,
|
Cmd.ARG_CIGROUPSMEMBERS: Cmd.ARG_CIGROUPMEMBERS,
|
||||||
|
|||||||
@@ -485,6 +485,8 @@ class GamCLArgs():
|
|||||||
ARG_CHROMEPOLICIES = 'chromepolicies'
|
ARG_CHROMEPOLICIES = 'chromepolicies'
|
||||||
ARG_CHROMEPROFILE = 'chromeprofile'
|
ARG_CHROMEPROFILE = 'chromeprofile'
|
||||||
ARG_CHROMEPROFILES = 'chromeprofiles'
|
ARG_CHROMEPROFILES = 'chromeprofiles'
|
||||||
|
ARG_CHROMEPROFILECOMMAND = 'chromeprofilecommand'
|
||||||
|
ARG_CHROMEPROFILECOMMANDS = 'chromeprofilecommands'
|
||||||
ARG_CHROMESCHEMA = 'chromeschema'
|
ARG_CHROMESCHEMA = 'chromeschema'
|
||||||
ARG_CHROMESCHEMAS = 'chromeschemas'
|
ARG_CHROMESCHEMAS = 'chromeschemas'
|
||||||
ARG_CHROMESNVALIDITY = 'chromesnvalidity'
|
ARG_CHROMESNVALIDITY = 'chromesnvalidity'
|
||||||
|
|||||||
@@ -111,6 +111,7 @@ class GamEntity():
|
|||||||
CHROME_POLICY_IMAGE = 'cpim'
|
CHROME_POLICY_IMAGE = 'cpim'
|
||||||
CHROME_POLICY_SCHEMA = 'cpsc'
|
CHROME_POLICY_SCHEMA = 'cpsc'
|
||||||
CHROME_PROFILE = 'cpro'
|
CHROME_PROFILE = 'cpro'
|
||||||
|
CHROME_PROFILE_COMMAND = 'cpcm'
|
||||||
CHROME_RELEASE = 'crel'
|
CHROME_RELEASE = 'crel'
|
||||||
CHROME_VERSION = 'cver'
|
CHROME_VERSION = 'cver'
|
||||||
CLASSIFICATION_LABEL = 'dlab'
|
CLASSIFICATION_LABEL = 'dlab'
|
||||||
@@ -462,6 +463,7 @@ class GamEntity():
|
|||||||
CHROME_POLICY_IMAGE: ['Chrome Policy Images', 'Chrome Policy Image'],
|
CHROME_POLICY_IMAGE: ['Chrome Policy Images', 'Chrome Policy Image'],
|
||||||
CHROME_POLICY_SCHEMA: ['Chrome Policy Schemas', 'Chrome Policy Schema'],
|
CHROME_POLICY_SCHEMA: ['Chrome Policy Schemas', 'Chrome Policy Schema'],
|
||||||
CHROME_PROFILE: ['Chrome Profiles', 'Chrome Profile'],
|
CHROME_PROFILE: ['Chrome Profiles', 'Chrome Profile'],
|
||||||
|
CHROME_PROFILE_COMMAND: ['Chrome Profile Commands', 'Chrome Profile Command'],
|
||||||
CHROME_RELEASE: ['Chrome Releases', 'Chrome Release'],
|
CHROME_RELEASE: ['Chrome Releases', 'Chrome Release'],
|
||||||
CHROME_VERSION: ['Chrome Versions', 'Chrome Version'],
|
CHROME_VERSION: ['Chrome Versions', 'Chrome Version'],
|
||||||
CLASSIFICATION_LABEL: ['Classification Labels', 'Classification Label'],
|
CLASSIFICATION_LABEL: ['Classification Labels', 'Classification Label'],
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
[metadata]
|
[metadata]
|
||||||
name = GAM for Google Workspace
|
name = GAM for Google Workspace
|
||||||
version = attr: gam.var.GAM_VERSION
|
#version = attr: gam.var.GAM_VERSION
|
||||||
|
version = 7.12.02
|
||||||
description = Command line management for Google Workspaces
|
description = Command line management for Google Workspaces
|
||||||
long_description = file: readme.md
|
long_description = file: readme.md
|
||||||
long_description_content_type = text/markdown
|
long_description_content_type = text/markdown
|
||||||
|
|||||||
@@ -2,9 +2,11 @@
|
|||||||
- [API documentation](#api-documentation)
|
- [API documentation](#api-documentation)
|
||||||
- [Introduction](#introduction)
|
- [Introduction](#introduction)
|
||||||
- [Definitions](#definitions)
|
- [Definitions](#definitions)
|
||||||
- [Delete Chrome profiles](#delete-chrome-profiles)
|
- [Delete Chrome Profiles](#delete-chrome-profiles)
|
||||||
- [Display Chrome profiles](#display-chrome-profiles)
|
- [Display Chrome Profiles](#display-chrome-profiles)
|
||||||
- [Profile Query Searchable Fields](#profile-query-searchable-fields)
|
- [Profile Query Searchable Fields](#profile-query-searchable-fields)
|
||||||
|
- [Create a Chrome Profile command](#create-a-chrome-profile-command)
|
||||||
|
- [Display Chrome Profile commands](#display-chrome-profile-commands)
|
||||||
|
|
||||||
## Introduction
|
## Introduction
|
||||||
These features were added in version 7.01.00.
|
These features were added in version 7.01.00.
|
||||||
@@ -21,13 +23,15 @@ Follow instructions at: Turn on managed profile reporting
|
|||||||
|
|
||||||
## API documentation
|
## API documentation
|
||||||
* [Chrome Management API - Profiles](https://developers.google.com/chrome/management/reference/rest/v1/customers.profiles)
|
* [Chrome Management API - Profiles](https://developers.google.com/chrome/management/reference/rest/v1/customers.profiles)
|
||||||
|
* [Chrome Management API - Profile Commands](https://developers.google.com/chrome/management/reference/rest/v1/customers.profiles.commands)
|
||||||
* [Turn on Chrome Browser and Profile Reporting](https://support.google.com/chrome/a/answer/9301421)
|
* [Turn on Chrome Browser and Profile Reporting](https://support.google.com/chrome/a/answer/9301421)
|
||||||
|
|
||||||
## Definitions
|
## Definitions
|
||||||
```
|
```
|
||||||
<CustomerID> ::= <String>
|
<CustomerID> ::= <String>
|
||||||
<ChromeProfilePermanentID> ::= <String>
|
<ChromeProfilePermanentID> ::= <String>
|
||||||
<ChromeProfileName> ::= customers/<CustomerID>/profiles/<ChromeProfilePermanentID>
|
<ChromeProfileName> ::= customers/<CustomerID>/profiles/<ChromeProfilePermanentID> | <ChromeProfilePermanentID>
|
||||||
|
<ChromeProfileCommandName> ::= <ChomeProfileName>/commands/<String>
|
||||||
|
|
||||||
<ChromeProfileFieldName> ::=
|
<ChromeProfileFieldName> ::=
|
||||||
affiliationstate|
|
affiliationstate|
|
||||||
@@ -89,7 +93,7 @@ Select the fields to be displayed:
|
|||||||
* `<ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]` - Display a selected list of fields
|
* `<ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]` - Display a selected list of fields
|
||||||
|
|
||||||
By default, Gam displays the information as an indented list of keys and values:
|
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 show chromeprofiles
|
gam show chromeprofiles
|
||||||
@@ -110,14 +114,14 @@ The `filtertime<String> <Time>` value replaces the string `#fiktertime<String>#`
|
|||||||
The characters following `filtertime` can be any combination of lowercase letters and numbers.
|
The characters following `filtertime` can be any combination of lowercase letters and numbers.
|
||||||
|
|
||||||
By default, Gam displays the information as an indented list of keys and values:
|
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 print chromeprofiles [todrive <ToDriveAttribute>*]
|
gam print chromeprofiles [todrive <ToDriveAttribute>*]
|
||||||
[filtertime.* <Time>] [filter <String>]
|
[filtertime.* <Time>] [filter <String>]
|
||||||
[orderby <ChromeProfileOrderByFieldName> [ascending|descending]]
|
[orderby <ChromeProfileOrderByFieldName> [ascending|descending]]
|
||||||
<ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]
|
<ChromeProfileFieldName>* [fields <ChromeProfileFieldNameList>]
|
||||||
[[formatjson [quotechar <Character>]]
|
[formatjson [quotechar <Character>]]
|
||||||
```
|
```
|
||||||
|
|
||||||
Use these options to select Chrome profiles; if none are chosen, all Chrome profiles in the account are selected:
|
Use these options to select Chrome profiles; if none are chosen, all Chrome profiles in the account are selected:
|
||||||
@@ -193,3 +197,38 @@ Print information about Chrome profiles on Windows.
|
|||||||
```
|
```
|
||||||
gam print chromeprofiles filter "osPlatformType=WINDOWS"
|
gam print chromeprofiles filter "osPlatformType=WINDOWS"
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Create a Chrome Profile command
|
||||||
|
```
|
||||||
|
gam create chromeprofilecommand <ChromeProfileName>
|
||||||
|
[clearcache [<Boolean>]] [clearcookies [<Boolean>]]
|
||||||
|
[formatjson]
|
||||||
|
```
|
||||||
|
## Display Chrome Profile commands
|
||||||
|
```
|
||||||
|
gam info chromeprofilecommand <ChromeProfileCommandName>
|
||||||
|
[formatjson]
|
||||||
|
```
|
||||||
|
By default, Gam displays the information as an indented list of keys and values:
|
||||||
|
* `formatjson` - Display the fields in JSON format.
|
||||||
|
|
||||||
|
```
|
||||||
|
gam show chromeprofilecommands <ChromeProfileName>
|
||||||
|
[formatjson]
|
||||||
|
```
|
||||||
|
|
||||||
|
By default, Gam displays the information as an indented list of keys and values:
|
||||||
|
* `formatjson` - Display the fields in JSON format.
|
||||||
|
```
|
||||||
|
gam print chromeprofilecommands <ChromeProfileName> [todrive <ToDriveAttribute>*]
|
||||||
|
[formatjson [quotechar <Character>]]
|
||||||
|
```
|
||||||
|
By default, Gam displays the information as columns of fields; the following option causes the output to be in JSON format:
|
||||||
|
* `formatjson` - Display the fields in JSON format.
|
||||||
|
|
||||||
|
By default, when writing CSV files, Gam uses a quote character of double quote `"`. The quote character is used to enclose columns that contain
|
||||||
|
the quote character itself, the column delimiter (comma by default) and new-line characters. Any quote characters within the column are doubled.
|
||||||
|
When using the `formatjson` option, double quotes are used extensively in the data resulting in hard to read/process output.
|
||||||
|
The `quotechar <Character>` option allows you to choose an alternate quote character, single quote for instance, that makes for readable/processable output.
|
||||||
|
`quotechar` defaults to `gam.cfg/csv_output_quote_char`. When uploading CSV files to Google, double quote `"` should be used.
|
||||||
|
|
||||||
|
|||||||
@@ -10,6 +10,13 @@ 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.12.02
|
||||||
|
|
||||||
|
Updated `gam print users` to handle the following error:
|
||||||
|
```
|
||||||
|
ERROR: 503: serviceNotAvailable - The service is currently unavailable
|
||||||
|
```
|
||||||
|
|
||||||
### 7.12.01
|
### 7.12.01
|
||||||
|
|
||||||
Added support for `plan free` in `gam create resoldsubscription`.
|
Added support for `plan free` in `gam create resoldsubscription`.
|
||||||
|
|||||||
@@ -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.12.01 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.12.02 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.5 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
@@ -989,7 +989,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
|
||||||
GAM 7.12.01 - https://github.com/GAM-team/GAM - pythonsource
|
GAM 7.12.02 - https://github.com/GAM-team/GAM - pythonsource
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.5 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
Windows-10-10.0.17134 AMD64
|
Windows-10-10.0.17134 AMD64
|
||||||
|
|||||||
@@ -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.12.01 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.12.02 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.5 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
@@ -15,7 +15,7 @@ Time: 2023-06-02T21:10:00-07:00
|
|||||||
Print the current version of Gam with details and time offset information
|
Print the current version of Gam with details and time offset information
|
||||||
```
|
```
|
||||||
gam version timeoffset
|
gam version timeoffset
|
||||||
GAM 7.12.01 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.12.02 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.5 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
@@ -27,7 +27,7 @@ Your system time differs from www.googleapis.com by less than 1 second
|
|||||||
Print the current version of Gam with extended details and SSL information
|
Print the current version of Gam with extended details and SSL information
|
||||||
```
|
```
|
||||||
gam version extended
|
gam version extended
|
||||||
GAM 7.12.01 - https://github.com/GAM-team/GAM - pyinstaller
|
GAM 7.12.02 - https://github.com/GAM-team/GAM - pyinstaller
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.5 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
@@ -64,7 +64,7 @@ MacOS High Sierra 10.13.6 x86_64
|
|||||||
Path: /Users/Admin/bin/gam7
|
Path: /Users/Admin/bin/gam7
|
||||||
Version Check:
|
Version Check:
|
||||||
Current: 5.35.08
|
Current: 5.35.08
|
||||||
Latest: 7.12.01
|
Latest: 7.12.02
|
||||||
echo $?
|
echo $?
|
||||||
1
|
1
|
||||||
```
|
```
|
||||||
@@ -72,7 +72,7 @@ echo $?
|
|||||||
Print the current version number without details
|
Print the current version number without details
|
||||||
```
|
```
|
||||||
gam version simple
|
gam version simple
|
||||||
7.12.01
|
7.12.02
|
||||||
```
|
```
|
||||||
In Linux/MacOS you can do:
|
In Linux/MacOS you can do:
|
||||||
```
|
```
|
||||||
@@ -82,7 +82,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.12.01 - https://github.com/GAM-team/GAM
|
GAM 7.12.02 - https://github.com/GAM-team/GAM
|
||||||
GAM Team <google-apps-manager@googlegroups.com>
|
GAM Team <google-apps-manager@googlegroups.com>
|
||||||
Python 3.13.5 64-bit final
|
Python 3.13.5 64-bit final
|
||||||
MacOS Sequoia 15.5 x86_64
|
MacOS Sequoia 15.5 x86_64
|
||||||
|
|||||||
Reference in New Issue
Block a user