Listing device users
This page explains how to list device users.
Listing specific device users
The following examples show you how to list specific devices users in your organization.
REST
To list specific device users, call devices.deviceUsers.list() with the name of the customer (organization).
Python HTTP
The following example shows how to list specific device users using the Python HTTP library:
"""Sample script to demonstrate the use of the List method in the Devices API.""" import json import pprint from six.moves import urllib import google.auth.transport.requests from google.oauth2 import service_account SCOPES = ['https://www.googleapis.com/auth/cloud-identity.devices'] BASE_URL = 'https://cloudidentity.googleapis.com/v1/' # Change this to the location of the service account key SA_FILE = '' # Enter the administrator to call as here. ADMIN_EMAIL = '' if not SA_FILE: print('Please specify the location of the service account key file') if not ADMIN_EMAIL: print('Please specify the email of the administrator to call as') if not SA_FILE or not ADMIN_EMAIL: exit(-1) def create_delegated_credentials(user_email): credentials = service_account.Credentials.from_service_account_file( SA_FILE, scopes=['https://www.googleapis.com/auth/cloud-identity.devices']) delegated_credentials = credentials.with_subject(user_email) return delegated_credentials ###################################################################### # AUTHENTICATE the service account and retrieve an oauth2 access token request = google.auth.transport.requests.Request() dc = create_delegated_credentials(ADMIN_EMAIL) dc.refresh(request) print('Access token: ' + dc.token + '\n') ############################### # LIST deviceUsers with filter. # Change this filter according to the options here: # https://support.google.com/a/answer/7549103 FILTER = urllib.parse.quote_plus('status:approved os:IOS') list_url = BASE_URL + 'devices/-/deviceUsers?filter=' + FILTER auth_header = {'Authorization': 'Bearer ' + dc.token} content = urllib.request.urlopen( urllib.request.Request(list_url, headers=auth_header)).read() response = json.loads(content) pp = pprint.PrettyPrinter(indent=4) if 'deviceUsers' in response: print('Listed: ' + str(len(response['deviceUsers'])) + ' deviceUsers\n') for element in response['deviceUsers']: pp.pprint(element) print('Next page token: ' + response['nextPageToken']) else: print('Empty response') Notice that FILTER is set to filter device users to those users whose status is "approved" (status:approved) and operating system is "IOS" (os:IOS).
Getting a specific device user
The following examples show you how to retrieve a specific device user.
REST
To get a specific device user, call devices.deviceUsers.get() with the name of the device and the customer (organization).
Python HTTP
The following example shows how to retrieve a specific customer using the Python HTTP library:
"""Sample script to demonstrate the use of the get method in the Devices API.""" import json import pprint from six.moves import urllib import google.auth.transport.requests from google.oauth2 import service_account SCOPES = ['https://www.googleapis.com/auth/cloud-identity.devices'] BASE_URL = 'https://cloudidentity.googleapis.com/v1/' # Change this to the location of the service account key SA_FILE = '' # Enter the administrator to call as here. ADMIN_EMAIL = '' # Enter the Resource Name. You can get this from the value of the name # field in the results of a List method call RESOURCE_NAME = '' if not SA_FILE: print('Please specify the location of the service account key file') if not ADMIN_EMAIL: print('Please specify the email of the administrator to call as') if not RESOURCE_NAME: print('Please specify the Resource Name to be retrieved') if not SA_FILE or not ADMIN_EMAIL or not RESOURCE_NAME: exit(-1) def create_delegated_credentials(user_email): credentials = service_account.Credentials.from_service_account_file( SA_FILE, scopes=['https://www.googleapis.com/auth/cloud-identity.devices']) delegated_credentials = credentials.with_subject(user_email) return delegated_credentials ###################################################################### # AUTHENTICATE the service account and retrieve an oauth2 access token request = google.auth.transport.requests.Request() dc = create_delegated_credentials(ADMIN_EMAIL) dc.refresh(request) print('Access token: ' + dc.token + '\n') ############################### # Get the resource get_url = BASE_URL + RESOURCE_NAME auth_header = {'Authorization': 'Bearer ' + dc.token} content = urllib.request.urlopen( urllib.request.Request(get_url, headers=auth_header)).read() response = json.loads(content) pp = pprint.PrettyPrinter(indent=4) pp.pprint(response)