Mobiledevices: action

Requires authorization

Takes an action that affects a mobile device. For example, remotely wiping a device. Try it now.

Request

HTTP request

POST https://www.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile/resourceId/action

Parameters

Parameter name Value Description
Path parameters
customerId string The unique ID for the customer's G Suite account. As an account administrator, you can also use the my_customer alias to represent your account's customerId. The customerId is also returned as part of the Users resource.
resourceId string The unique ID the API service uses to identify the mobile device.

Authorization

This request requires authorization with at least one of the following scopes (read more about authentication and authorization).

Scope
https://www.googleapis.com/auth/admin.directory.device.mobile.action
https://www.googleapis.com/auth/admin.directory.device.mobile

Request body

In the request body, supply data with the following structure:

{
  "action": string
}
Property name Value Description Notes
action string The action to be performed on the device.

Acceptable values are:
  • "admin_account_wipe": Remotely wipes only G Suite data from the device. See the administration help center for more information.
  • "admin_remote_wipe": Remotely wipes all data on the device. See the administration help center for more information.
  • "approve": Approves the device. If you've selected Enable device activation, devices that register after the device activation setting is enabled will need to be approved before they can start syncing with your domain. Enabling device activation forces the device user to install the Device Policy app to sync with G Suite.
  • "block": Blocks access to G Suite data (mail, calendar, and contacts) on the device. The user can still access their mail, calendar, and contacts from a desktop computer or mobile browser.
  • "cancel_remote_wipe_then_activate": Cancels a remote wipe of the device and then reactivates it.
  • "cancel_remote_wipe_then_block": Cancels a remote wipe of the device and then blocks it.

Response

If successful, this method returns an empty response body.

Try it!

Use the APIs Explorer below to call this method on live data and see the response.