如何通过 Multilogin API 管理 Android 云手机
在 Multilogin 中,你可以使用 API管理 Android 云手机,无需在控制台中手动处理每项操作。你可以创建、启动、停止和整理云手机,管理文件、检查状态,以及设置 ADB 连接。
➡️ 在 Postman 中打开“Multilogin API” → “Mobile Profile Management” → 选择请求 → 输入所需值 → 点击“Send”。
也可以直接通过脚本或 AI 智能体发送这些请求。日常 API 自动化建议使用 自动化令牌,它比普通 API 令牌有效期更长,允许的每分钟请求数也更多。
Mobile profiles = 云手机
在 API 文档中,Android 云手机称为 mobile profiles。你会在请求名称和参数中看到这个名称。
谁可以使用自动化?
- 👨💻 账户所有者和所有团队成员(功能访问权限取决于角色)
- 💰 适用于 Pro 10 及以上套餐
创建和管理云手机
要准备多台云手机?无需逐台手动创建、启动或停止。
API 可让你按所需设置创建云手机,之后更新设置、启动和停止,或删除不再使用的云手机。
可用请求:
- “Mobile Profile Create”
- “Mobile Profile Start”
- “Mobile Profile Stop”
- “Mobile Profile Update”
- “Mobile Profile Delete”
例如,如果你为多个客户管理账户,可以通过脚本创建基本设置相同的云手机,并在需要时启动。
查找和整理云手机
管理大量云手机时,很容易忘记哪些手机对应哪些账户或团队成员。
这些请求帮助你查找云手机、检查哪些正在运行,并通过文件夹和标签整理它们。
可用请求:
- “Mobile Profile List”
- “Mobile Profile Statuses”
- “Mobile Profile Group Get or Create”
- “Mobile Profile Tag Assign”
- “Mobile Profile Tag Unassign”
例如,可以获取云手机列表,找到它们的 ID,再在其他 API 请求中使用这些 ID。
设置 ADB 连接
需要自动操作 Android 应用?可以使用 Multilogin API 设置到云手机的 ADB 连接。
可用请求:
- “Mobile Profile ADB Set”
- “Mobile Profile ADB Info”
这些请求帮助你启用 ADB,并获取 Android 自动化所需的连接信息。
例如,可以通过 API 启动云手机,使用 ADB 连接,再通过 Appium 操作 Android 应用。
API 本身不会控制 Android 应用内的操作
如需点击按钮、输入文字或浏览应用,请使用 ADB、Appium 或支持的 AI 智能体工作流程。
管理云手机资源库中的文件
要在多台云手机上处理图片、视频或其他文件?API 可以帮助你管理共享资源库中的文件,无需手动上传或整理所有内容。
可用请求:
- “Mobile File Upload”
- “Mobile File List”
- “Mobile File Delete”
- “Mobile File Tag Assign”
- “Mobile File Tag Unassign”
例如,可以将文件上传到资源库,找到它们的 ID,并用于支持的云手机流程。
批量管理云手机
如果要在团队成员之间转移云手机,或准备大量云手机,逐台操作可能需要较长时间。
这些请求帮助你导出云手机数据、准备和检查批量导入文件,以及将云手机转移给团队成员。
可用请求:
- “Mobile Profile Export”
- “Import Template Download”
- “Import File Validate”
- “Mobile Profile Transfer”
例如,可以将云手机信息导出为 .xlsx 文件,或准备导入文件,在创建云手机前检查是否有错误。
批量导入还需要一步
“Import File Validate”只会检查文件。要完成导入,工作区所有者和管理员可调用 POST /mobile_profiles/phone/import/confirm,并传入验证返回的 validation_id。该 ID 有效期为 15 分钟,且只能使用一次。
检查限额和可用设置
批量创建云手机前,建议检查云手机时长是否充足,以及所选设备、位置和全局IP 设置是否受支持。
API 提供了相关请求,帮助你查找这些值,而不是猜测。
可用请求:
- “Mobile Profile Limit”
- “Mobile Proxy Check”
- “Phone Brand List”
- “States by Country”
- “Cities by State”
例如,在为新地区设置云手机时,可以先检查可用位置和手机型号,再进行创建。
查找完整的 API 信息
本文介绍可以通过 API 管理哪些内容,但不会涵盖每个请求的全部设置。
有关以下内容,Multilogin API 文档是主要参考来源:
- 可用 API 请求及其端点
- 必填参数和支持的值
- 请求与响应示例
- 限额、条件和错误详情
更改或删除数据前先检查请求
如果要更新或删除云手机、资源库文件或其他数据,请先在 Postman 中检查相关请求。点击“Send”前,确保理解它会更改什么,以及需要哪些 ID 或值。