Home API sử dụng OAuth 2.0 để cấp quyền truy cập vào các thiết bị trong cấu trúc. OAuth cho phép người dùng cấp quyền cho một ứng dụng hoặc dịch vụ mà không cần tiết lộ thông tin đăng nhập của họ.
Nếu đã có một ứng dụng OAuth đã xác minh (ví dụ: từ một ứng dụng đã xuất bản), bạn có thể sử dụng ứng dụng đó để kiểm thử Home API mà không cần thiết lập một ứng dụng mới. Để biết thêm thông tin, hãy xem phần Nếu bạn có một ứng dụng OAuth hiện có.
Ký ứng dụng
Trước tiên, hãy tạo một chứng chỉ gỡ lỗi bằng cách chạy ứng dụng của bạn trong Android Studio. Khi bạn chạy hoặc gỡ lỗi một ứng dụng trong Android Studio, ứng dụng đó sẽ tự động tạo một chứng chỉ gỡ lỗi dành cho mục đích phát triển và gỡ lỗi. Hãy xem bài viết Android Studio: Ký bản gỡ lỗi để biết nội dung giải thích đầy đủ.
Sau khi ứng dụng chạy:
Kết nối thiết bị di động với máy cục bộ. Android Studio sẽ liệt kê các thiết bị đã kết nối theo số hiệu mẫu. Chọn thiết bị của bạn trong danh sách, sau đó nhấp vào Chạy dự án. Thao tác này sẽ tạo và cài đặt ứng dụng mẫu trên thiết bị di động của bạn.
Để biết hướng dẫn chi tiết hơn, hãy xem phần Chạy ứng dụng trên thiết bị phần cứng trên trang web dành cho nhà phát triển Android.
Dừng ứng dụng đang chạy.
Lấy vân tay SHA-1 của chứng chỉ gỡ lỗi bằng cách làm theo hướng dẫn chi tiết trong phần Thiết lập OAuth 2.0 / Ứng dụng gốc/Android trên trang trợ giúp của Bảng điều khiển Google Cloud.
Thiết lập màn hình đồng ý OAuth
- Trong Google Cloud Console, hãy chuyển đến trang tổng quan về bộ chọn dự án rồi chọn dự án mà bạn muốn dùng để tạo thông tin đăng nhập OAuth.
- Chuyển đến trang API và dịch vụ, rồi nhấp vào Thông tin xác thực trong trình đơn điều hướng.
Nếu bạn chưa định cấu hình màn hình xin phép cho dự án này trên Google Cloud, thì nút Định cấu hình màn hình xin phép sẽ xuất hiện. Trong trường hợp đó, hãy định cấu hình màn hình xin phép theo quy trình sau. Nếu không, hãy chuyển sang phần tiếp theo.
- Nhấp vào Định cấu hình màn hình đồng ý. Trang màn hình xin phép bằng OAuth sẽ xuất hiện.
- Tuỳ thuộc vào trường hợp sử dụng của bạn, hãy chọn Nội bộ hoặc Bên ngoài, rồi nhấp vào Tạo. Ngăn màn hình xin phép bằng OAuth sẽ xuất hiện.
- Nhập thông tin trên trang Thông tin về ứng dụng theo hướng dẫn trên màn hình, rồi nhấp vào Lưu và tiếp tục. Ngăn Scopes (Phạm vi) sẽ xuất hiện.
- Bạn không cần thêm phạm vi nào, vì vậy hãy nhấp vào Lưu và tiếp tục. Ngăn Người dùng kiểm thử sẽ xuất hiện.
- Nhấp vào Đối tượng rồi nhấp vào nút + THÊM NGƯỜI DÙNG.
- Nhập địa chỉ email của người dùng kiểm thử rồi nhấp vào nút LƯU.
- Nhấp vào Lưu và tiếp tục. Ngăn Tóm tắt sẽ xuất hiện.
- Xem lại thông tin trên màn hình xin phép bằng OAuth, rồi nhấp vào Quay lại trang tổng quan.
Hãy xem phần Thiết lập màn hình đồng ý OAuth trên trang trợ giúp của Google Cloud Console để biết thông tin chi tiết đầy đủ.
Đăng ký ứng dụng và tạo thông tin đăng nhập
Để đăng ký ứng dụng cho OAuth 2.0 và tạo thông tin đăng nhập OAuth, hãy làm theo hướng dẫn trong phần Thiết lập OAuth 2.0. Bạn cần cho biết loại ứng dụng là ứng dụng gốc/Android.
Thêm vân tay số SHA-1 mà bạn nhận được từ việc ký ứng dụng vào ứng dụng OAuth mà bạn thiết lập trên Bảng điều khiển Google Cloud bằng cách làm theo hướng dẫn trong phần Thiết lập OAuth 2.0 / Ứng dụng gốc trên trang trợ giúp của Bảng điều khiển Google Cloud.
Khi thiết bị di động của bạn kết nối với máy cục bộ, hãy chọn thiết bị của bạn trong danh sách, sau đó nhấp lại vào Run project (Chạy dự án) để chạy dự án. Để biết hướng dẫn chi tiết hơn, hãy xem phần Chạy ứng dụng trên thiết bị phần cứng trên trang web dành cho nhà phát triển Android.
Nếu bạn có ứng dụng OAuth hiện có
Nếu đã có một ứng dụng OAuth được xác minh cho một ứng dụng đã xuất bản, bạn có thể dùng ứng dụng OAuth hiện có để kiểm thử Home API.
Bạn không cần đăng ký Google Home Developer Console để kiểm thử và sử dụng Home API. Tuy nhiên, bạn vẫn cần đăng ký Developer Console đã được phê duyệt để xuất bản ứng dụng, ngay cả khi bạn có một ứng dụng OAuth đã xác minh từ một quy trình tích hợp khác.
Bạn cần cân nhắc những điểm sau:
Bạn chỉ được phép có tối đa 100 người dùng khi sử dụng một ứng dụng OAuth hiện có. Để biết thông tin về cách thêm người dùng kiểm thử, hãy tham khảo phầnThiết lập màn hình đồng ý OAuth. Ngoài quy trình xác minh OAuth, Home API còn áp đặt giới hạn 100 người dùng có thể cấp quyền cho ứng dụng của bạn. Hạn chế này sẽ được dỡ bỏ sau khi bạn hoàn tất quy trình đăng ký Developer Console.
Developer Consoleđăng ký phải được gửi để phê duyệt khi bạn sẵn sàng hạn chế các cấp phép theo loại thiết bị thông qua OAuth để chuẩn bị cập nhật ứng dụng bằng Home API.
Đối với những ứng dụng Google Cloud vẫn đang chờ xác minh OAuth, người dùng không thể hoàn tất quy trình OAuth cho đến khi quy trình xác minh hoàn tất. Nếu tìm cách cấp quyền, bạn sẽ gặp lỗi sau:
Access blocked: <Project Name> has not completed the Google verification process.