Cách quản lý điện thoại đám mây Android với Multilogin API
Bạn có thể sử dụng Multilogin API để quản lý điện thoại đám mây Android tự động. Tạo, cập nhật, khởi động, dừng, tổ chức và kiểm tra điện thoại đám mây mà không cần thực hiện những hành động này thủ công trong bảng điều khiển. Điều này hữu ích cho các nhóm và nhà phát triển quản lý nhiều điện thoại đám mây hoặc kết nối Multilogin với các quy trình tự động của riêng họ.
➡️ Để sử dụng các yêu cầu API cho điện thoại đám mây, mở tập hợp Postman liên quan đến Quản lý Hồ sơ Di động → Tìm yêu cầu bạn cần → Chạy nó trong script hoặc Postman của bạn.
Những gì API có thể quản lý: thiết lập điện thoại đám mây, trạng thái, tập tin, ứng dụng, thẻ, nhóm và hành động hàng loạt.
Những gì API không làm: kiểm soát các hành động bên trong ứng dụng Android. Để tự động hóa ứng dụng, hãy sử dụng ADB hoặc các công cụ như Appium.
Hãy nhớ rằng bài viết này cung cấp cái nhìn tổng quan về các yêu cầu có sẵn. Nó không giải thích từng tham số một cách chi tiết. Bạn cần biết cách sử dụng Postman ở mức cơ bản. Các bài viết dưới đây được khuyến nghị đọc trước khi tiếp tục với bài viết này.
- Cách thiết lập tự động hóa Multilogin với Postman
- Cách điều hướng tài liệu Multilogin API với Postman
Trong tài liệu Multilogin API, các điện thoại đám mây Android được gọi là hồ sơ di động.
Các yêu cầu được nhóm theo nhiệm vụ, vì vậy bạn có thể nhanh chóng tìm thấy những gì bạn cần. Tất cả chúng đều có sẵn trong thư mục “Quản lý Hồ sơ Di động” trong bộ sưu tập “Multilogin API”.
Ai có thể sử dụng những API yêu cầu này?
- 👨💻 Chủ tài khoản và tất cả thành viên trong nhóm
- 💰 Có sẵn trên các gói Pro 10, Pro 50, Business 100 và tất cả các gói Doanh nghiệp
Cách quản lý điện thoại đám mây
Các yêu cầu này bao gồm các hành động chính của điện thoại đám mây.
Tạo
Endpoint: Mobile Profile Create
Tạo một hoặc nhiều điện thoại đám mây mà không cần thiết lập chúng thủ công.
Bạn có thể cấu hình các giá trị như:
- Tên điện thoại
- Phiên bản Android
- Thương hiệu và mẫu điện thoại
- Proxy
- Ghi chú và thẻ
- Cài đặt mạng và vị trí
Một proxy là cần thiết khi bạn tạo một điện thoại đám mây.
💡 Tại sao nó hữu ích: tạo nhiều điện thoại đám mây với cùng một thiết lập mà không cần lặp lại cùng một cấu hình trong bảng điều khiển.

Khởi động
Endpoint: Mobile Profile Start
Yêu cầu khởi động một hoặc nhiều điện thoại đám mây mà không cần giao diện đồ họa. Điều này hữu ích cho các quy trình tự động không cần màn hình điện thoại trực tiếp.

Dừng
Endpoint: Mobile Profile Stop
Yêu cầu dừng một hoặc nhiều điện thoại đám mây. Cũng hữu ích cho các quy trình tự động.

Cập nhật
Endpoint: Mobile Profile Update
Bạn có thể cập nhật cấu hình của một điện thoại đám mây, bao gồm thương hiệu và mẫu điện thoại, tiêu đề, proxy, ghi chú, thẻ và loại mạng. Bạn sẽ cần ID của điện thoại đám mây, mà bạn có thể lấy trong bảng điều khiển Multilogin hoặc với GET Danh sách Hồ sơ Di động.
💡 Tại sao nó hữu ích: Nó tiết kiệm thời gian cho các cập nhật hàng loạt, vì vậy bạn không cần chỉnh sửa từng điện thoại đám mây thủ công trong bảng điều khiển.

Xóa
Endpoint: Mobile Profile Delete
Xóa các điện thoại đám mây theo ID của chúng. Hãy sử dụng điều này một cách cẩn thận nếu bạn tự động hóa quy trình dọn dẹp.
💡 Tại sao nó hữu ích: Nó cho phép bạn xóa nhiều điện thoại đám mây như một phần của quy trình dọn dẹp tự động. Điều này có thể giúp giải phóng không gian trong gói của bạn khi bạn cần tạo các điện thoại đám mây mới.

Cách tổ chức điện thoại đám mây
Các yêu cầu này giúp khi không gian làm việc của bạn bắt đầu lớn hơn.
Danh sách
Endpoint: Mobile Profile List
Sử dụng yêu cầu này để lấy các điện thoại đám mây trong không gian làm việc.
Phản hồi cung cấp cho bạn ID của điện thoại đám mây và các chi tiết thiết lập như thiết bị, vị trí, mạng, proxy, và thông tin không gian làm việc.
💡 Tại sao nó hữu ích: nhiều yêu cầu khác cần ID của điện thoại đám mây. Bắt đầu ở đây khi bạn chưa có nó.
Bearer (hoặc token tự động hóa) là đủ để chạy yêu cầu.

Kiểm tra trạng thái
Endpoint: Mobile Profile Statuses
Hiển thị một số giá trị trạng thái của điện thoại đám mây, bao gồm trạng thái khởi động, thời gian chạy, thời gian tự động dừng và trạng thái ADB.
💡 Tại sao nó hữu ích: Nó cho phép bạn theo dõi trạng thái điện thoại đám mây trong quá trình tự động hóa, đặc biệt khi các hồ sơ được khởi động mà không có GUI.

Lấy/tạo nhóm
Endpoint: Mobile Profile Group Get or Create
Điểm cuối trả về nhóm điện thoại đám mây (không gian làm việc) hoặc tạo một cái mới.
💡 Tại sao nó hữu ích: Nó xác nhận rằng bạn đang kết nối với không gian làm việc chính xác trước khi tiếp tục.

Gán thẻ
Endpoint: Mobile Profile Tag Assign
Bạn có thể áp dụng tối đa 10 thẻ cùng một lúc. Các thẻ được chia sẻ giữa các hồ sơ trình duyệt và điện thoại đám mây. Để tìm một thẻ, hãy sử dụng POST Tag Search điểm cuối. Bạn cũng sẽ cần ID của điện thoại đám mây.
💡 Tại sao nó hữu ích: Nó giúp dễ dàng tổ chức các điện thoại đám mây tự động và giữ cho các bộ hồ sơ lớn dễ quản lý hơn.

Xóa thẻ
Endpoint: Mobile Profile Tag Unassign
Cũng như việc gán thẻ, bạn có thể xóa tối đa 10 thẻ cùng một lúc. Các thẻ được chia sẻ giữa các hồ sơ trình duyệt và điện thoại đám mây. Bạn có thể tham khảo các yêu cầu API liên quan đến thẻ trong thư mục quản lý hồ sơ, ví dụ như POST Tag Search. ID của điện thoại đám mây cũng là cần thiết.
💡 Tại sao nó hữu ích: Nó giúp giữ cho tổ chức điện thoại đám mây của bạn được cập nhật bằng cách xóa các thẻ mà bạn không còn cần.

Cách quản lý ứng dụng trên điện thoại
Bạn cũng có thể sử dụng API để tìm và cài đặt các ứng dụng Android có sẵn.
Danh sách ứng dụng
Endpoint: Mobile App List
Trả về danh sách các ứng dụng từ thị trường ứng dụng. Phản hồi cung cấp cho bạn ID của ứng dụng và phiên bản ID. Bạn sẽ cần những giá trị này để cài đặt ứng dụng.
💡 Tại sao nó hữu ích: Nó cung cấp cho bạn ID của ứng dụng và phiên bản cần thiết cho việc cài đặt ứng dụng tự động.

Cài đặt ứng dụng
Điểm cuối: Cài đặt Ứng dụng Di động
Điểm cuối cài đặt một ứng dụng theo lô trên một nhóm điện thoại đám mây. Sử dụng ID của ứng dụng và ID phiên bản. Nó cài đặt ứng dụng trong thư mục mặc định. Bạn cũng có thể sử dụng điểm cuối GET Nhóm Hồ sơ Di động Lấy hoặc Tạo.
💡 Tại sao nó hữu ích: Nó cho phép bạn cài đặt cùng một ứng dụng trên nhiều điện thoại đám mây mà không cần thiết lập từng điện thoại thủ công.

Cách sử dụng thư viện điện thoại
Thư viện là lưu trữ đám mây chia sẻ cho các điện thoại đám mây của bạn.
Sử dụng các yêu cầu này để tải lên, tìm kiếm, tổ chức và xóa các tập tin.
Danh sách tệp
Endpoint: Mobile File List
Lấy các tệp được lưu trữ trong thư viện. Phản hồi bao gồm ID tệp, mà bạn cần cho các yêu cầu liên quan đến tệp.

Tải lên một tệp
Endpoint: Mobile File Upload
Tải lên một tệp vào thư viện điện thoại đám mây. Bạn có thể sử dụng tệp đã tải lên trong quy trình làm việc di động của mình.
Chú ý: bạn có thể duyệt tệp trong Postman.
💡 Tại sao nó hữu ích: Nó cho phép bạn thêm tệp vào Thư viện tự động để các điện thoại đám mây của bạn có thể truy cập chúng trong quá trình làm việc.

Xóa tệp
Endpoint: Mobile File Delete
Xóa một hoặc nhiều tệp trong Thư viện theo ID của chúng. Lấy ID trước với GET Danh sách Tệp Di động.
💡 Tại sao nó hữu ích: Nó giúp dễ dàng dọn dẹp các tệp trong Thư viện tự động khi chúng không còn cần thiết.

Chú ý: việc xóa là ngay lập tức và không thể hoàn tác.
Gán thẻ cho tệp
Endpoint: Mobile File Tag Assign
Bạn có thể áp dụng tối đa 10 thẻ cùng một lúc. Các thẻ giống như cho các hồ sơ trình duyệt và điện thoại đám mây. Bạn có thể tham khảo các yêu cầu API liên quan đến thẻ trong thư mục quản lý hồ sơ, ví dụ như POST Tag Search. ID tệp cũng là cần thiết (GET Mobile File List).
💡 Tại sao nó hữu ích: Nó giúp bạn tổ chức các tệp trong Thư viện tự động, đặc biệt khi bạn quản lý nhiều tệp đã tải lên.

Bỏ gán thẻ cho tệp
Endpoint: Mobile File Tag Unassign
Gỡ thẻ khỏi tệp Thư viện. Thẻ giống như cho hồ sơ trình duyệt và điện thoại đám mây. Bạn có thể tham khảo các yêu cầu liên quan đến thẻ API trong thư mục quản lý hồ sơ, ví dụ: POST Tag Search. ID tệp ID cũng cần thiết (GET Mobile File List).
💡 Tại sao điều này hữu ích: Nó giúp giữ cho các tệp Thư viện được tổ chức bằng cách gỡ bỏ các thẻ không còn liên quan.

Cách quản lý điện thoại hàng loạt
Các yêu cầu này hữu ích khi bạn làm việc với các tập hợp lớn hơn của điện thoại đám mây.
Xuất
Endpoint: Mobile Profile Export
Yêu cầu xuất dữ liệu điện thoại đám mây ra tệp .xlsx. Bạn có thể xuất tối đa 200 điện thoại đám mây cùng một lúc.
Lưu ý: Kết quả được trình bày dưới dạng tệp. Nếu bạn sử dụng Postman, hãy nhấp vào menu ba chấm (gần nút “Lưu phản hồi”) và nhấp vào “Lưu phản hồi vào tệp”.
💡 Tại sao điều này hữu ích: Nó tiết kiệm thời gian khi bạn cần dữ liệu điện thoại đám mây cho báo cáo, sao lưu hoặc quy trình làm việc hàng loạt.

Nhập
Tải xuống mẫu nhập
Endpoint: Import Template Download
Tải xuống một mẫu .xlsx để nhập hàng loạt điện thoại đám mây. Điền dữ liệu, sau đó xác thực tệp bằng cách sử dụng điểm cuối sau: POST Import File Validate
Lưu ý: Kết quả được trình bày dưới dạng tệp. Nếu bạn sử dụng Postman, hãy nhấp vào menu ba chấm (gần nút “Lưu phản hồi”) và nhấp vào “Lưu phản hồi vào tệp”.
💡 Tại sao điều này hữu ích: Nó cung cấp cho bạn cấu trúc tệp chính xác cho việc nhập hàng loạt điện thoại đám mây, giúp giảm thiểu sai sót định dạng.

Xác thực tệp nhập
Endpoint: Import File Validate
Kiểm tra tệp nhập .xlsx của bạn trước khi sử dụng.
Bạn có thể xây dựng tệp từ:
💡 Tại sao điều này hữu ích: xác thực giúp tránh lỗi trong quá trình nhập hàng loạt.

Chuyển giao
Endpoint: Mobile Profile Transfer
Yêu cầu này cho phép bạn chuyển hồ sơ cho một thành viên khác trong nhóm của bạn trong không gian làm việc. Bạn có thể chuyển tối đa 200 hồ sơ cùng một lúc (các giới hạn của gói hiện tại của bạn cũng được áp dụng).
Lưu ý: việc chuyển giao là vĩnh viễn và không thể hoàn tác.
💡 Tại sao điều này hữu ích: hữu ích khi bạn di chuyển điện thoại đám mây giữa các thành viên trong nhóm hoặc tổ chức lại quyền sở hữu.

Cách kiểm tra giới hạn và giá trị thiết lập
Các yêu cầu trợ giúp này cung cấp cho bạn các giá trị cần thiết cho việc thiết lập điện thoại đám mây.
Giới hạn sử dụng điện thoại
Endpoint: Mobile Profile Limit
Kiểm tra số phút cho phép của điện thoại đám mây trong không gian làm việc của bạn.
Phản hồi hiển thị tổng số phút có sẵn của bạn, số phút bạn đã sử dụng và số phút còn lại.

Kiểm tra proxy
Endpoint: Mobile Proxy Check
Yêu cầu này kiểm tra tính khả dụng của một proxy và cung cấp thông tin bổ sung, như IP, vị trí địa lý, múi giờ và ISP.
💡 Tại sao điều này hữu ích: Nó cho phép bạn kiểm tra một proxy trước khi sử dụng nó với một điện thoại đám mây, giúp phát hiện sớm các vấn đề về kết nối hoặc vị trí.

Danh sách các bang theo quốc gia
Endpoint: States by Country
Sử dụng mã quốc gia để lấy danh sách các bang. Bạn có thể sử dụng chúng để tạo điện thoại đám mây.
💡 Tại sao điều này hữu ích: Nó cung cấp cho bạn các giá trị bang hoặc vùng hợp lệ để sử dụng khi thiết lập dữ liệu vị trí điện thoại đám mây.

Danh sách các thành phố theo bang
Endpoint: Cities by State
Yêu cầu này trả về danh sách các thành phố theo bang hoặc vùng. Bạn có thể sử dụng các giá trị bang từ điểm cuối đó: GET Các bang theo quốc gia.
💡 Tại sao điều này hữu ích: Nó cung cấp cho bạn các giá trị thành phố hợp lệ để sử dụng khi thiết lập dữ liệu vị trí điện thoại đám mây.

Danh sách các thương hiệu và mẫu điện thoại
Endpoint: Phone Brand List
Lấy các thương hiệu và mẫu điện thoại được hỗ trợ cho một phiên bản Android. Sử dụng các giá trị trả về khi bạn tùy chỉnh việc tạo điện thoại đám mây.
💡 Tại sao điều này hữu ích: Nó cung cấp cho bạn các giá trị thương hiệu và mẫu được hỗ trợ, để bạn có thể sử dụng các cài đặt thiết bị hợp lệ khi tạo điện thoại đám mây.

Câu hỏi thường gặp
“Hồ sơ di động” có nghĩa là gì trong API?
Một hồ sơ di động là một điện thoại đám mây Android trong Multilogin.
API API sử dụng “hồ sơ di động” trong nhiều tên yêu cầu và tham số.
Tôi có cần Postman để sử dụng các yêu cầu này không?
Không. Postman hữu ích cho việc thử nghiệm các yêu cầu và kiểm tra các phản hồi mà không cần xây dựng một kịch bản đầy đủ.
Bạn cũng có thể gọi các yêu cầu Multilogin API từ tự động hóa của riêng bạn.
Tôi nên sử dụng mã thông báo nào?
Một mã thông báo bearer thông thường hoạt động cho API và hết hạn sau 30 phút.
Đối với các quy trình tự động hóa dài hơn, bạn có thể tạo một mã thông báo tự động hóa với thời gian hết hạn theo yêu cầu của bạn.
Các yêu cầu API này có thể tự động hóa các hành động bên trong các ứng dụng Android không?
Các yêu cầu này chủ yếu giúp bạn quản lý chính các điện thoại đám mây.
Đối với tự động hóa ứng dụng Android gốc, hãy kết nối điện thoại đám mây của bạn thông qua ADB và sử dụng các công cụ như Appium.
Tôi có thể tạo nhiều điện thoại đám mây Android với API không?
Có, yêu cầu Tạo hồ sơ di động hỗ trợ tạo điện thoại đám mây mà không cần thiết lập thủ công.
Có phải API thay thế ADB hoặc Appium không?
Không. API quản lý các điện thoại đám mây. Sử dụng ADB và Appium cho các hành động bên trong các ứng dụng Android.
Tôi tìm thấy ID điện thoại đám mây của mình ở đâu?
Sử dụng GET Mobile Profile List sơ di động hoặc sao chép nó từ bảng điều khiển Multilogin.