Skip to content

Home

Jump to bottom
Michael Shaffer edited this page Feb 27, 2026 · 5 revisions

Android Management API – Wiki

This wiki covers setup, configuration, and troubleshooting for the Android Management API Home Assistant integration. The integration lets you manage Android enterprise devices from Home Assistant using Google's Android Management API.

Quick links

Topic Description
Initial Setup Google Cloud project, API, service account, and enterprise
Post-setup Advice Best practices after the integration is configured
Debug Logging Enable and use debug logs for troubleshooting
Configuration Adding and configuring the integration in Home Assistant
Policy options General, Enterprise, options flow, kiosk policy, and device reporting

Initial setup

Before adding the integration in Home Assistant, you need:

  1. A Google Cloud project with the Android Management API enabled.
  2. A service account with the right permissions and a downloaded JSON key.
  3. An enterprise created in Android Management (you’ll use its resource name, e.g. enterprises/LC00t1kz5a).

For step-by-step instructions, see Initial Setup.

Post-setup advice

After the integration is set up:

  • Policy ID: Create or choose a policy in the Android Management API console and use its ID in the integration’s Options flow when applying settings.
  • Enrolling a device: Open the Enrollment QR Code image entity in Settings → Devices & Services; on the device, run setup and tap the Welcome screen several times if you don't see "Enroll with QR code," then scan the QR code. See Post-setup Advice for full steps.
  • Device list: The integration polls the API about every 60 seconds; new or removed devices appear after the next update.
  • Services: Use set_policy, set_kiosk_policy, create_enrollment_token, device-level services (clear_app_data, start_lost_mode, stop_lost_mode, patch_device, wipe, add_esim, remove_esim, request_device_info, issue_command, reset_password), and enterprise services (list_policies, list_enrollment_tokens, delete_enrollment_token, get_operation, get_enterprise, patch_enterprise, create_web_token) from Developer Tools → Services or from automations.

More detail: Post-setup Advice.

Debug logging

To see detailed logs for this integration, add the following to your configuration.yaml:

logger:
  logs:
    custom_components.android_management_api: debug

Restart Home Assistant, reproduce the issue, then check Settings → System → Logs or the log file. See Debug Logging for more.

See also

Clone this wiki locally