Skip to content

Chrome Installed Apps

Ross Scroggs edited this page Jun 5, 2024 · 4 revisions

Chrome Installed Apps Counts

API documentation

Notes

To use these features you must add the Chrome Management API to your project and authorize the appropriate scope: Chrome Management API - read only.

gam update project
gam oauth create

To get installed app details you must authorize the scope: Chrome Management API - AppDetails read only.

Definitions

<AppID> ::= <String>
<AppType> ::= extension|app|theme|hostedapp|androidapp
<Date> ::=
        <Year>-<Month>-<Day> |
        (+|-)<Number>(d|w|y) |
        never|
        today
<OrgUnitID> ::= id:<String>
<OrgUnitPath> ::= /|(/<String>)+
<OrgUnitItem> ::= <OrgUnitID>|<OrgUnitPath>

Quoting rules

Items in a list can be separated by commas or spaces; if an item itself contains a comma, a space or a single quote, special quoting must be used. Typically, you will enclose the entire list in double quotes and quote each item in the list as detailed below.

  • Items, separated by commas, without spaces, commas or single quotes in the items themselves
    • "item,item,item"
  • Items, separated by spaces, without spaces, commas or single quotes in the items themselves
    • "item item item"
  • Items, separated by commas, with spaces, commas or single quotes in the items themselves
    • "'it em','it,em',\"it'em\""
  • Items, separated by spaces, with spaces, commas or single quotes in the items themselves
    • "'it em' 'it,em' \"it'em\""

Display Chrome installed app details

gam info chromeapp android|chrome|web <AppID>
        [formatjson]

By default, Gam displays the information as an indented list of keys and values.

  • formatjson - Display the fields in JSON format.

Display Chrome installed apps counts

gam show chromeapps
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [filter <String>]
        [orderby appname|apptype|installtype|numberofpermissions|totalinstallcount]
        [formatjson]

By default, Gam displays the information as an indented list of keys and values.

  • formatjson - Display the fields in JSON format.
gam print chromeapps [todrive <ToDriveAttribute>*]
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [filter <String>]
        [orderby appname|apptype|installtype|numberofpermissions|totalinstallcount]
        [formatjson [quotechar <Character>]] [delimiter <Character>]

Use these options to select Chrome devices; if none are chosen, all Chrome devices in the account are selected.

  • ou <OrgUnitItem> - Select devices directly in the OU <OrgUnitItem>
  • ou_and_children <OrgUnitItem> - Select devices in the OU <OrgUnitItem> and its sub OUs
  • ous <OrgUnitList> - Select devices directly in the OUs <OrgUnitList>
  • ous_and_children <OrgUnitList> - Select devices in the OUs <OrgUnitList> and their sub OUs
  • filter <String> - The minimum last_active_date for the devices

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.

Display Chrome devices with a specific installed application

gam show chromeappdevices
        appid <AppID> apptype <AppType>
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [start <Date>] [end <Date>]
        [orderby deviceid|machine]
        [formatjson]

Use these options to select Chrome devices; if none are chosen, all Chrome devices in the account are selected.

  • ou <OrgUnitItem> - Select devices directly in the OU <OrgUnitItem>
  • ou_and_children <OrgUnitItem> - Select devices in the OU <OrgUnitItem> and its sub OUs
  • ous <OrgUnitList> - Select devices directly in the OUs <OrgUnitList>
  • ous_and_children <OrgUnitList> - Select devices in the OUs <OrgUnitList> and their sub OUs
  • start <Date> - The minimum last_active_date for the devices
  • end <Date> - The maximum last_active_date for the devices

By default, Gam displays the information as an indented list of keys and values.

  • formatjson - Display the fields in JSON format.
gam print chromeappdevices [todrive <ToDriveAttribute>*]
        appid <AppID> apptype <AppType)
        [(ou <OrgUnitItem>)|(ou_and_children <OrgUnitItem>)|
         (ous <OrgUnitList>)|(ous_and_children <OrgUnitList>)]
        [start <Date>] [end <Date>]
        [orderby deviceid|machine]
        [formatjson [quotechar <Character>]]

Use these options to select Chrome devices; if none are chosen, all Chrome devices in the account are selected.

  • ou <OrgUnitItem> - Select devices directly in the OU <OrgUnitItem>
  • ou_and_children <OrgUnitItem> - Select devices in the OU <OrgUnitItem> and its sub OUs
  • ous <OrgUnitList> - Select devices directly in the OUs <OrgUnitList>
  • ous_and_children <OrgUnitList> - Select devices in the OUs <OrgUnitList> and their sub OUs
  • start <Date> - The minimum last_active_date for the devices
  • end <Date> - The maximum last_active_date for the devices

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.

Update History

Installation

Configuration

Notes and Information

Definitions

Command Processing

Collections

Client Access

Special Service Account Access

Service Account Access

Clone this wiki locally