Batch Resolve Device and Group IDs by Name

Tool Name: airdroid_business_device_and_group_id_batch_resolve_by_name

Risk Level: 🟢 Low Risk

Execution Mode: ⚡ Synchronous

Category: Device Management

Quick Start (Copy & Use)

Summary: Resolve device display names → DeviceIds and group display names → GroupIds in one call. Pure name lookup — does not expand group membership into device lists.

Prerequisites: Exact names (case-sensitive). Default group name is "Default".

Success Criteria: StatusCode == 200 and ErrorMessage == "".

What to Do Next: Use ids with Batch Get Devices by Device or Group IDs (or other tools). Check Unmatched* arrays and Summary.

Minimal Request Example:

{
  "DeviceNames": ["Office Tablet", "Warehouse Scanner 01"],
  "GroupNames": ["Sales"]
}

Minimal Response Example:

{
  "DeviceIds": ["dev_abc123", "dev_def456"],
  "GroupIds": [10024],
  "Summary": "2 device_id(s) resolved; 1 group_id(s) resolved",
  "UnmatchedDeviceNames": ["Unknown Device"],
  "UnmatchedGroupNames": [],
  "StatusCode": 200,
  "ErrorMessage": ""
}

Recipes (Common Recipes)

Recipe 1: Resolve both sides then batch-get devices

{
  "DeviceNames": ["Front Desk Monitor"],
  "GroupNames": ["Lobby Devices", "Workshop"]
}

Next: Batch Get Devices by Device or Group IDs with returned DeviceIds / GroupIds (union semantics there).

Recipe 2: Devices only

{
  "DeviceNames": ["Lobby Kiosk A", "Lobby Kiosk B"],
  "GroupNames": []
}

Empty GroupNames skips group lookup.

Recipe 3: Groups only

{
  "DeviceNames": [],
  "GroupNames": ["Default", "Warehouse"]
}

Empty DeviceNames skips device lookup.

1. Overview

1.1 What it does

Combined exact-name resolver for devices and groups. Returns deduped DeviceIds / GroupIds, unmatched lists, and a one-line Summary. On error, id arrays are cleared and status fields come from the error path.

1.2 When to use

• Need both device_id and group_id values in a single call
• Avoid invoking device-only and group-only resolvers separately

1.3 Execution mode

Synchronous read. Idempotent.

1.4 Prerequisites

1.5 Related tools

1.6 Important non-goal

This tool does not expand a group into its member devices. To list devices under a group, resolve the group id, then call Batch Get Devices by Device or Group IDs (or Search Devices / List Devices).

2. Inputs

Both may be empty: runtime still completes with empty id arrays and Summary = "No IDs resolved." when there is no error (per aggregation code).

3. Outputs

4. Error handling

On error (ErrorMessage non-empty), aggregation clears resolved id arrays and unmatched lists per code path.

5. Limits & gotchas

• DeviceNames max 100; GroupNames max 20
• Exact match only; default group must be "Default"
• Does not expand group membership into devices
• Empty inputs → success with No IDs resolved. (not an auth probe by itself)

6. Best practices

1. Prefer this when you need both id types; otherwise use the dedicated batch resolvers
2. Always check UnmatchedDeviceNames / UnmatchedGroupNames
3. After resolve, use Batch Get Devices by Device or Group IDs to fetch records

7. Related Tools

8. Tool Chains

Batch Resolve Device and Group IDs by Name → Batch Get Devices by Device or Group IDs

List Devices / List Groups → pick exact names → Batch Resolve Device and Group IDs by Name

Appendix Reference:

• Field Reference: ./Field Reference.md
• Error Code Quick Reference: ./Error Codes.md