Skip to content

Users Tokens

Jump to bottom
Ross Scroggs edited this page Jul 8, 2024 · 11 revisions

Users - Tokens

API documentation

Definitions

<ClientID> ::= <String>

Delete a user's token

gam <UserTypeEntity> delete|del token|tokens clientid <ClientID>

Display individual user's tokens

gam <UserTypeEntity> print tokens|token [todrive <ToDriveAttributes>*] [clientid <ClientID>]
        [orderby clientid|id|appname|displaytext] [delimiter <Character>]
gam <UserTypeEntity> show tokens|token|3lo|oauth [clientid <ClientID>]
        [orderby clientid|id|appname|displaytext]
gam print tokens|token [todrive <ToDriveAttributes>*] [clientid <ClientID>]
        [orderby clientid|id|appname|displaytext] [delimiter <Character>]
        [<UserTypeEntity>]
gam show tokens|token [clientid <ClientID>]
        [orderby clientid|id|appname|displaytext] [delimiter <Character>]
        [<UserTypeEntity>]

By default, all client tokens for a user are displayed, use clientid <ClientID> to display a specific client token.

For each user, select the order of token presentation:

  • orderby clientid|id - Display each user's tokens ordered by Client ID
  • orderby appname|displaytext - Display each user's tokens ordered by App Name

For print tokens:

  • delimiter <Character> - Separate scopes entries with <Character>; the default value is csv_output_field_delimiter from gam.cfg.

Example

This example shows which domain users have the Google Apps Sync for Microsoft Outlook app allowed for their account

gam all users print token clientid 1095133494869.apps.googleusercontent.com

Display individual user's token counts

gam <UserTypeEntity> print tokens|token [todrive <ToDriveAttributes>*] [clientid <ClientID>]
        usertokencounts
gam <UserTypeEntity> show tokens|token|3lo|oauth [clientid <ClientID>]
        usertokencounts
gam print tokens|token [todrive <ToDriveAttributes>*] [clientid <ClientID>]
        usertokencounts
        [<UserTypeEntity>]
gam show tokens|token [clientid <ClientID>]
        usertokencounts
        [<UserTypeEntity>]

Example

This example shows which domain users have any access tokens.

gam config csv_output_row_filter "tokenCount:count>0" all users print tokens usertokencounts

Display aggregated user's tokens

gam <UserTypeEntity> print tokens|token [todrive <ToDriveAttributes>*] [clientid <ClientID>]
        [aggregateusersby clientid|id|appname|displaytext] [delimiter <Character>]
gam <UserTypeEntity> show tokens|token|3lo|oauth [clientid <ClientID>]
        [aggregateusersby clientid|id|appname|displaytext]
gam print tokens|token [todrive <ToDriveAttributes>*] [clientid <ClientID>]
        [aggregateusersby clientid|id|appname|displaytext] [delimiter <Character>]
        [<UserTypeEntity>]

By default, all client tokens for aggregated users are displayed, use clientid <ClientID> to display a specific client token.

For aggregated users, select the order of token presentation:

  • aggregateusersby clientid|id - Display aggregated users tokens ordered by Client ID
  • aggregateusersby appname|displaytext - Display aggregated users tokens ordered by App Name

For print tokens:

  • delimiter <Character> - Separate scopes entries with <Character>; the default value is csv_output_field_delimiter from gam.cfg.

Generate a list of all Google Apps being used by each of your users.

Serial processing

gam config csv_output_header_filter "^user$,clientId,displayText" redirect csv UserApps.csv [todrive <ToDriveAttributes>*] all users print tokens
  • config csv_output_header_filter "^user$,clientId,displayText" - Select relevant columns
  • redirect csv UserApps.csv - Specify CSV file
  • [todrive <ToDriveAttributes>*] - Optional, upload CSV to Google Drive
  • all users print tokens - Get the apps

Parallel processing

gam config auto_batch_min 1 num_threads 10 csv_output_header_filter "^user$,clientId,displayText" redirect csv UserApps.csv multiprocess [todrive <ToDriveAttributes>*] all users print tokens
  • config auto_batch_min 1 num_threads 10 - Turn on parallel processing
  • csv_output_header_filter "^user$,clientId,displayText" - Select relevant columns
  • redirect csv UserApps.csv multiprocess - Specify CSV file with parallel processing
  • [todrive <ToDriveAttributes>*] - Optional, upload CSV to Google Drive
  • all users print tokens - Get the apps

Generate a list of all Google Apps being used by any user.

Serial processing must be used

gam config csv_output_header_filter "^users$,clientId,displayText" redirect csv UserApps.csv [todrive <ToDriveAttributes>*] all users print tokens aggregateusersby displaytext
  • config csv_output_header_filter "^users$,clientId,displayText" - Select relevant columns
  • redirect csv UserApps.csv - Specify CSV file
  • [todrive <ToDriveAttributes>*] - Optional, upload CSV to Google Drive
  • all users print tokens - Get the apps
  • aggregateusersby displaytext - Aggregate users

Display how many users are using Google Chrome

Serial processing must be used

gam config csv_output_header_filter "^users$,clientId,displayText" redirect csv UserApps.csv [todrive <ToDriveAttributes>*] all users print tokens aggregateusersby displaytext clientid 77185425430.apps.googleusercontent.com
  • config csv_output_header_filter "^users$,clientId,displayText" - Select relevant columns
  • redirect csv UserApps.csv - Specify CSV file
  • [todrive <ToDriveAttributes>*] - Optional, upload CSV to Google Drive
  • all users print tokens - Get the apps
  • aggregateusersby displaytext - Aggregate users

Need more help? Ask on the GAM Discussion Group

Update History

Installation

Configuration

Notes and Information

Definitions

Command Processing

Collections

Client Access

Special Service Account Access

Service Account Access

Clone this wiki locally