Để phát triển nhanh, bạn có thể sử dụng công cụ đăng ký được cung cấp cùng với SDK Trợ lý Google để nhanh chóng đăng ký hoặc cập nhật mẫu và phiên bản thiết bị.
Nếu không muốn sử dụng công cụ này, bạn có thể đăng ký hoặc cập nhật thiết bị theo cách thủ công bằng cách sử dụng tệp JSON và API REST. Bạn có thể thực hiện việc này trên bất kỳ máy tính nào. Trước tiên, hãy lấy mã truy cập rồi chuyển đến phần thích hợp.
Lấy mã truy cập
Đảm bảo công cụ uỷ quyền đã được cập nhật:
python -m pip install --upgrade google-auth-oauthlib[tool]
Lấy thông tin đăng nhập để có thể đăng ký mẫu thiết bị mới. Tham chiếu tệp JSON mà bạn đã sao chép vào thiết bị trong bước bước.
google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \ --headless --client-secrets /path/to/client_secret_client-id.json
Bạn sẽ thấy một URL xuất hiện trong thiết bị đầu cuối:
Please visit this URL to authorize this application: https://...
Sao chép và dán URL vào một trình duyệt (bạn có thể thực hiện việc này trên máy phát triển hoặc bất kỳ máy nào khác). Sau khi bạn phê duyệt, một mã sẽ xuất hiện trong trình duyệt của bạn, chẳng hạn như "4/XXXX". Sao chép và dán mã này vào thiết bị đầu cuối:
Enter the authorization code:
Nếu yêu cầu uỷ quyền thành công, bạn sẽ thấy phản hồi JSON tương tự như sau:
{ "scopes": ["https://www.googleapis.com/auth/assistant-sdk-prototype"], "token_uri": "https://accounts.google.com/o/oauth2/token", "token": "ya29.GlujBLa_kuXZ5GnGBPBe_A6NpczLcpOtglEC0wHVORnmEhHETzlSW", "client_id": "795595571889-6iesr9a3nkmnipbdfnqi6gehiklm2m28.apps.googleusercontent.com", "client_secret": "Un8_TNFnb55555auSAGasvAg", "refresh_token": "1/4ZMBhTR3bTYWVEMatYWLOxW755555hlQXZI5uC02F2U" }
Nếu bạn thấy
UNAUTHENTICATED
thì tức là bạn đã nhập mã không hợp lệ. Hãy thử lại, nhớ sao chép và dán toàn bộ mã.Tìm
token
trong phản hồi JSON. Sao chép mã truy cập này (không bao gồm dấu ngoặc kép) vào một biến môi trường:ACCESSTOKEN=access-token
Hoạt động của mẫu thiết bị
Xác định và đăng ký mẫu thiết bị
Tạo một tệp (ví dụ:
device_model.json
) mô tả các đặc điểm của mẫu thiết bị. Hãy xem tài liệu tham khảo JSON về mẫu thiết bị để biết thêm thông tin.Đăng ký mẫu thiết bị của bạn bằng một trong các phương thức sau. Hãy nhớ thay thế
project_id
liên kết với mẫu thiết bị trong các URL dưới đây.Hãy sử dụng lệnh sau:
curl -s -X POST -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- Phương thức:
POST
- Nội dung: Nội dung của
device_model.json
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Đối với cả hai phương thức, máy chủ sẽ trả về bản sao của mẫu thiết bị JSON mà bạn đã gửi. Nếu mô hình này đã tồn tại trên máy chủ, bạn sẽ gặp lỗi
ALREADY_EXISTS
.
Tải mẫu thiết bị
Tìm mẫu thiết bị bằng một trong các phương thức sau. Hãy nhớ thay thế project_id
và device_model_id
liên kết với mẫu thiết bị của bạn trong các URL bên dưới.
Hãy sử dụng lệnh sau:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- Phương thức:
GET
- Nội dung: Không có
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Liệt kê các mẫu thiết bị
Liệt kê tất cả mẫu thiết bị của bạn cho một dự án cụ thể bằng một trong những phương thức sau. Hãy nhớ thay thế project_id
được liên kết với các mẫu thiết bị của bạn trong các URL dưới đây.
Hãy sử dụng lệnh sau:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/
- Phương thức:
GET
- Nội dung: Không có
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Cập nhật mẫu thiết bị
Cập nhật mẫu thiết bị bằng một trong hai phương pháp sau. Hãy nhớ thay thế project_id
và device_model_id
liên kết với mẫu thiết bị của bạn.
Hãy sử dụng lệnh sau:
curl -s -X PUT -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @device_model.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- Phương thức:
PUT
- Nội dung: Nội dung của
device_model.json
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Đối với cả hai phương thức, máy chủ sẽ trả về một bản sao của JSON mẫu thiết bị đã cập nhật mà bạn đã gửi.
Xoá mẫu thiết bị
Xoá mẫu thiết bị bằng một trong hai phương pháp sau. Hãy nhớ thay thế project_id
và device_model_id
liên kết với mẫu thiết bị của bạn trong các URL bên dưới.
Hãy sử dụng lệnh sau:
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/deviceModels/device_model_id
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/deviceModels/<device_model_id>
- Phương thức:
DELETE
- Nội dung: Không có
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Thao tác với thực thể thiết bị
Xác định và đăng ký một thực thể thiết bị
Tạo một tệp (ví dụ:
test_device.json
) giúp nhận dạng thiết bị của bạn. Hãy xem tài liệu tham khảo JSON về phiên bản thiết bị để biết thêm thông tin.Đăng ký thiết bị của bạn bằng một trong các phương pháp sau. Hãy nhớ thay thế
project_id
liên kết với mẫu thiết bị trong các URL dưới đây.Hãy sử dụng lệnh sau:
curl -s -X POST -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" -d @test_device.json \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- Phương thức:
POST
- Nội dung: Nội dung của
test_device.json
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Đối với cả hai phương thức, máy chủ sẽ trả về một bản sao của JSON của phiên bản thiết bị mà bạn đã gửi. Nếu thực thể đó đã tồn tại trên máy chủ, bạn sẽ gặp lỗi
ALREADY_EXISTS
.
Nhận phiên bản thiết bị
Lấy phiên bản thiết bị của bạn bằng một trong hai phương thức sau. Hãy nhớ thay thế project_id
liên kết với mẫu thiết bị và thiết bị id
trong các URL bên dưới.
Hãy sử dụng lệnh sau:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- Phương thức:
GET
- Nội dung: Không có
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Liệt kê các phiên bản thiết bị
Liệt kê tất cả thực thể thiết bị của một dự án nhất định bằng một trong các phương thức sau. Hãy nhớ thay thế project_id
liên kết với các thực thể thiết bị trong URL dưới đây.
Hãy sử dụng lệnh sau:
curl -s -X GET -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/
- Phương thức:
GET
- Nội dung: Không có
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập
Xoá một phiên bản thiết bị
Xoá phiên bản thiết bị của bạn bằng một trong hai phương pháp sau. Hãy nhớ thay thế project_id
liên kết với mẫu thiết bị và thiết bị id
trong các URL bên dưới.
Hãy sử dụng lệnh sau:
curl -s -X DELETE -H "Content-Type: application/json" \ -H "Authorization: Bearer $ACCESSTOKEN" \ https://embeddedassistant.googleapis.com/v1alpha2/projects/project_id/devices/id
Gửi yêu cầu HTTPS có các thuộc tính sau:
- URL: https://embeddedassistant.googleapis.com/v1alpha2/projects/<project_id>/devices/<id>
- Phương thức:
DELETE
- Nội dung: Không có
- Tiêu đề:
Authorization: Bearer <access-token>
, trong đó <access-token> là chuỗi chứa mã truy cập