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