Bắt đầu

Chương trình Device Access cho phép người dùng truy cập, kiểm soát và quản lý các thiết bị Google Nest bằng API SDM.

Để bắt đầu sử dụng Device Access, bạn cần hoàn thành các nhiệm vụ sau:

1. Đăng ký tham gia chương trình Device Access .
2. Kích hoạt một thiết bị Nest được hỗ trợ bằng Tài khoản Google.
3. Tạo một dự án Google Cloud để bật API SDM và lấy mã ứng dụng OAuth 2.0.
4. Tạo một dự án Device Access để nhận Mã dự án.

Đăng ký sử dụng tính năng Quyền truy cập thiết bị

Trước khi tạo dự án đầu tiên, bạn phải đăng ký Device Access. Khi đăng ký, bạn phải chấp nhận Điều khoản dịch vụ của API Google và Sandbox truy cập thiết bị, cùng với khoản phí một lần không hoàn lại (5 USD) cho mỗi tài khoản.

Bạn sẽ không thể tạo dự án cho đến khi chấp nhận cả hai Điều khoản dịch vụ và thanh toán phí đăng ký. Điều này áp dụng cho tất cả người dùng, cả người dùng cá nhân và những người muốn tạo sản phẩm thương mại.

Đăng ký trong Device Access Console nếu bạn chưa đăng ký:

Chuyển đến Device Access Console

Cảnh báo: Bạn phải sử dụng Tài khoản Google dành cho người dùng (ví dụ: tài khoản gmail.com) để đăng ký quyền truy cập vào thiết bị. Bạn không thể sử dụng tài khoản Google Workspace. Nếu bạn làm việc cho một tổ chức, bạn nên đăng ký sử dụng tính năng Quyền truy cập thiết bị bằng một tài khoản dành cho nhóm của mình.

Cảnh báo: Sau khi liên kết một Tài khoản Google với Dự án quyền truy cập thiết bị, bạn không thể thay đổi Tài khoản Google đó. Hãy đảm bảo bạn đã đăng nhập vào đúng Tài khoản Google trước khi tiếp tục.

Hãy xem phần Đăng kýDevice Access để biết thêm thông tin.

Kích hoạt thiết bị được hỗ trợ

Các thiết bị sau đây được hỗ trợ trong chương trình Device Access :

• Tất cả Google Nest Thermostat
• Tất cả camera Google Nest
• Tất cả Google Nest Doorbell
• Google Nest Hub Max

Hãy xem trang Thiết bị được hỗ trợ để biết danh sách các mẫu thiết bị riêng lẻ.

Lưu ý: Bạn phải kích hoạt thiết bị được hỗ trợ bằng Tài khoản Google. Không hỗ trợ tài khoản Nest cũ cho Device Access. Hãy xem Câu hỏi thường gặp về tài khoản của ứng dụng Nest để biết thêm thông tin về cách di chuyển tài khoản Nest cũ.

Hãy xem hướng dẫn sử dụng thiết bị để biết thông tin về cách kích hoạt thiết bị được hỗ trợ.

Thiết lập Google Cloud Platform

Quyền truy cập vào API SDM được cung cấp thông qua Google Cloud. Để bật API và uỷ quyền cho một Tài khoản Google bằng một thiết bị Nest được hỗ trợ, bạn cần có một dự án Google Cloud.

Sử dụng nút Bật API và nhận mã ứng dụng OAuth 2.0 ở bên dưới để bật Smart Device Management API (API Quản lý thiết bị thông minh) và nhận mã ứng dụng OAuth 2.0:

1. Nếu bạn có một dự án Google Cloud hiện có mà bạn muốn sử dụng cho Device Access, trước tiên, hãy đảm bảo bạn đã đăng nhập vào tài khoản quản trị của dự án đó. Sau đó, chọn dự án hiện có trong danh sách các dự án có sẵn sau khi nhấp vào nút. Nếu không, hãy tạo một dự án mới.
2. Chọn Máy chủ web khi ứng dụng hỏi "Bạn đang gọi từ đâu?".
3. Nhập https://www.google.com làm giá trị cho URI chuyển hướng được uỷ quyền. Bạn cần có URI chuyển hướng để lấy Mã uỷ quyền bằng PCM.
4. Sau khi thiết lập xong, hãy sao chép các giá trị Mã ứng dụng OAuth 2.0 và Khoá ứng dụng, đồng thời tải tệp JSON Thông tin xác thực xuống máy cục bộ.

Bật API và nhận mã ứng dụng khách OAuth 2.0

Nếu bạn muốn thiết lập dự án trên Google Cloud theo cách thủ công hoặc xác minh quá trình thiết lập và truy xuất lại thông tin xác thực, hãy làm như sau:

1. Bật Smart Device Management API trên trang Bật API.
2. Nhận mã ứng dụng khách OAuth 2.0 trên trang Thông tin xác thực.

Tạo dự án Quyền truy cập thiết bị

Quay lại Device Access Console.

1. Trên màn hình chính của Console, hãy chọn Tạo dự án.
2. Điền vào từng màn hình trong quá trình tạo:
   1. Nhập tên cho dự án.
   2. Nhập mã ứng dụng khách OAuth 2.0 được tạo trong phần Thiết lập Google Cloud Platform. Nếu trước đó bạn chưa sao chép mã ứng dụng khách OAuth, thì bạn có thể tìm thấy mã này trong tệp credentials.json mà bạn đã tải xuống.
      Lưu ý: Cách sử dụng một dự án có API SDM:

      • Bạn phải chỉ định một mã ứng dụng OAuth hợp lệ cho dự án.
      • Mã ứng dụng khách OAuth phải hợp lệ và duy nhất cho một project, đồng thời không được chia sẻ với các projectkhác.
   3. Bật hoặc tắt sự kiện. Google Cloud Pub/Sub quản lý các sự kiện và cung cấp nội dung cập nhật không đồng bộ cho tất cả thiết bị và cấu trúc được uỷ quyền cho dự án của bạn. Chọn Bật nếu bạn muốn có sự kiện. Nếu bạn không chắc chắn, hãy chọn Tắt. Bạn luôn có thể bật lại các trò chơi đó sau.
3. Sau khi hoàn tất, dự án của bạn sẽ được chỉ định một Mã dự án, ở dạng một UUID, chẳng hạn như 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. Hãy ghi lại mã nhận dạng này, bạn sẽ cần mã này cho tất cả các lệnh gọi API SDM.

Mã dự án này được dùng trong các lệnh gọi OAuth và API. Mã này dành riêng cho dự ánDevice Access và không liên quan đến Mã dự án trên Google Cloud.