Chỉ mục
DevicesPlatformService
(giao diện)CreateDeviceModelRequest
(thông báo)CreateDeviceRequest
(thông báo)DeleteDeviceModelRequest
(thông báo)DeleteDeviceRequest
(thông báo)Device
(thông báo)Device.ClientType
(enum)DeviceModel
(thông báo)DeviceModel.ExecutionMode
(enum)GetDeviceModelRequest
(thông báo)GetDeviceRequest
(thông báo)ListDeviceModelsRequest
(thông báo)ListDeviceModelsResponse
(thông báo)ListDevicesRequest
(thông báo)ListDevicesResponse
(thông báo)Manifest
(thông báo)UpdateDeviceModelRequest
(thông báo)
DevicesPlatformService
Dịch vụ này quản lý các thiết bị không phải của Google. Hiện tại, công cụ này cung cấp cho nhà phát triển: * một API để đăng ký mẫu thiết bị; * một API để đăng ký phiên bản của thiết bị.
Quy trình đăng ký mẫu thiết bị sẽ tạo và quản lý mẫu thiết bị, trong đó có các tính năng và cấu hình dùng chung trên tất cả thiết bị trong mẫu đó.
Việc đăng ký phiên bản thiết bị sẽ tạo thực thể cho phiên bản thiết bị dựa trên các khả năng và cấu hình được xác định trong mô hình, đồng thời cho phép nhà phát triển xác định một số thuộc tính khác nhau giữa các thiết bị.Trong thời gian thực thi sau khi đăng ký, mỗi yêu cầu gRPC phải có cả device_model_id và device_id, và API Trợ lý Google yêu cầu phải đăng ký cả hai mã nhận dạng, nếu không thì hệ thống sẽ trả về lỗi.
CreateDevice | |
---|---|
Đăng ký một thiết bị, trả lại thiết bị nếu thành công hoặc gặp lỗi nếu thiết bị đã tồn tại hoặc không thành công.
|
CreateDeviceModel | |
---|---|
Tạo một mẫu thiết bị bên thứ ba.
|
DeleteDevice | |
---|---|
Xoá một người dùng thiết bị cụ thể sở hữu. Trả về kết quả trống nếu thành công, nếu không sẽ trả về lỗi cho biết không tìm thấy thiết bị hoặc không xoá được thiết bị.
|
DeleteDeviceModel | |
---|---|
Xoá mẫu thiết bị của bên thứ ba.
|
GetDevice | |
---|---|
Nhận thông tin về chế độ cài đặt của một người dùng thiết bị cụ thể, trả lại thiết bị nếu thành công hoặc trả về lỗi nếu không thành công.
|
GetDeviceModel | |
---|---|
Trả về một mẫu thiết bị dựa trên mã mẫu thiết bị.
|
ListDeviceModels | |
---|---|
Liệt kê các mẫu thiết bị cho mã dự án được liên kết với lệnh gọi API REST này.
|
ListDevices | |
---|---|
Nhận danh sách thiết bị mà người dùng sở hữu thuộc project_id cho trước trong mã thông báo OAuth. Cần kiểm tra URL và mã thông báo có cùng project_id.
|
UpdateDeviceModel | |
---|---|
Cập nhật mẫu thiết bị, trả về phiên bản mới của mẫu thiết bị. Lưu ý: đây là bản cập nhật đầy đủ, nghĩa là bạn cần gửi toàn bộ mẫu thiết bị để được cập nhật.
|
CreateDeviceModelRequest
Thông báo yêu cầu cho DevicesPlatformService.CreateDeviceModel.
Các trường | |
---|---|
parent |
Tên tài nguyên của dự án mà bạn tạo mẫu thiết bị, có dạng |
device_model |
device_model cần được tạo. |
CreateDeviceRequest
Thông báo yêu cầu đối với DevicesPlatformService.CreateDevice.
Các trường | |
---|---|
device |
Thông tin thiết bị thô do người dùng cung cấp. device_id phải là duy nhất trong dự án, do chủ sở hữu dự án chỉ định. |
parent |
Tên của dự án chứa thiết bị, có dạng |
DeleteDeviceModelRequest
Thông báo yêu cầu đối với DevicesPlatformService.DeleteDeviceModel.
Các trường | |
---|---|
name |
Tên tài nguyên của dự án mà bạn cần xoá mẫu thiết bị, có dạng |
DeleteDeviceRequest
Thông báo yêu cầu đối với DevicesPlatformService.DeleteDevice.
Các trường | |
---|---|
name |
Tên tài nguyên của dự án cần xoá thiết bị, có dạng |
Thiết bị
Các trường | |
---|---|
name |
Tên tài nguyên của thiết bị, có dạng |
id |
Bắt buộc. Mã thiết bị duy nhất trong phạm vi dự án, định dạng do nhà phát triển xác định, ví dụ: "06ba29e5-5f1c-1a89-303c-22de2580f2e2". Phải khớp với DeviceConfig.device_id khi gửi RPC Converse. Mã này có thể đặt lại cho FDR. |
nickname |
Biệt hiệu cho thiết bị này được chỉ định bởi.Biệt hiệu này sẽ được dùng để nhận dạng giọng nói và nhắm mục tiêu theo thiết bị khi người dùng nói với một thiết bị. Ví dụ: người dùng có thể nói "di chuyển rô-bốt thông minh của tôi sang trái" khi họ có thiết bị có tên là "robot thông minh của tôi". |
model_id |
Bắt buộc. Xác định riêng biệt "lớp" (kiểu máy) của thiết bị trong số tất cả các thiết bị có mã nhận dạng nhân viên hỗ trợ. Ví dụ: "manufacturer-2017-v2". Xin lưu ý rằng một dự án có thể có nhiều mẫu thiết bị. |
client_type |
Bắt buộc. SDK Trợ lý cung cấp hai lựa chọn để tích hợp Trợ lý vào thiết bị của bạn. Trường này dùng để xác định xem ứng dụng dựa trên thư viện SDK của Trợ lý hay gọi API dịch vụ SDK. |
ClientType
Xác định loại ứng dụng.
Enum | |
---|---|
CLIENT_TYPE_UNSPECIFIED |
Không xác định được loại ứng dụng, là giá trị mặc định. |
SDK_SERVICE |
Đối với API dịch vụ gRPC của SDK, API này sẽ hiển thị một API cấp thấp trực tiếp điều khiển các byte âm thanh của một yêu cầu và phản hồi của Trợ lý. Service |
SDK_LIBRARY |
Đối với thư viện ứng dụng Trợ lý Google, một giải pháp chìa khoá trao tay có API cấp cao dựa trên sự kiện. |
DeviceModel
Xác định siêu dữ liệu cho một nhóm thiết bị Mẫu thiết bị cũng xác định các tính năng phổ biến cho một nhóm thiết bị.
Các trường | |
---|---|
name |
Tên tài nguyên của mẫu thiết bị, có dạng |
device_model_id |
Bắt buộc. Mã nhận dạng chung duy nhất do nhà phát triển chỉ định, chẳng hạn như “comcast-voice-assistant-2017-v1”. Nếu đã có mã mẫu thiết bị, hệ thống sẽ trả về lỗi. |
project_id |
Bắt buộc. Mã dự án trên đám mây được liên kết với Mẫu thiết bị. Mỗi dự án được phép tạo nhiều mẫu thiết bị. |
device_type |
Bắt buộc. Một số Loại thiết bị hợp lệ: "action.devices.types.Light" "action.devices.types.OUTLET" "action.devices.types.". "action.devices.types.AC_HEATING" |
traits[] |
Danh sách các trait tích hợp không bắt buộc mà thiết bị có thể hỗ trợ. Ví dụ: "action.devices.traits.OnOff" |
manifest |
Bắt buộc. Siêu dữ liệu mô tả mẫu thiết bị và nhà sản xuất. Thông tin này sẽ xuất hiện trong bảng điều khiển SDK, trang tổng quan về chỉ số và các giao diện trực quan khác có liên quan. |
execution_modes[] |
Chế độ thực thi không bắt buộc dành cho Hành động trên thiết bị. Nếu bạn đặt lệnh DIRECT_REVIEW, các thiết bị sẽ được bật để điều khiển thiết bị. |
ExecutionMode
Chế độ thực thi cho Thao tác trên thiết bị, hiện tại chỉ hỗ trợ phản hồi trực tiếp.
Enum | |
---|---|
MODE_UNSPECIFIED |
Chưa xác định. |
DIRECT_RESPONSE |
Thiết bị hỗ trợ thực thi trực tiếp. Đối với các truy vấn đến từ thiết bị, trợ lý sẽ trả về DeviceControlRequest, bao gồm cả lệnh và các tham số. |
GetDeviceModelRequest
Thông báo yêu cầu cho DevicesPlatformService.GetDeviceModel.
Các trường | |
---|---|
name |
Tên tài nguyên của dự án mà bạn tải mẫu thiết bị, có dạng |
GetDeviceRequest
Thông báo yêu cầu đối với DevicesPlatformService.GetDevice.
Các trường | |
---|---|
name |
Tên tài nguyên để tải thiết bị, có dạng |
ListDeviceModelsRequest
Thông báo yêu cầu đối với DevicesPlatformService.ListDeviceModel.
Các trường | |
---|---|
parent |
Đang yêu cầu tên tài nguyên của các mẫu thiết bị ở dạng |
ListDeviceModelsResponse
Thông báo phản hồi cho DevicesPlatformService.CreateDeviceModel.
Các trường | |
---|---|
device_models[] |
|
ListDevicesRequest
Thông báo yêu cầu cho DevicesPlatformService.ListDevices.
Các trường | |
---|---|
parent |
Tên của dự án có các thiết bị mà chúng ta muốn liệt kê, có dạng "projects/{project_id}". |
ListDevicesResponse
Thông báo phản hồi cho DevicesPlatformService.ListDevices.
Các trường | |
---|---|
devices[] |
tất cả thiết bị mà người dùng này sở hữu trong dự án cụ thể. |
Tệp kê khai
Siêu dữ liệu mô tả mẫu thiết bị và nhà sản xuất. Thông tin này sẽ xuất hiện trong bảng điều khiển SDK, trang tổng quan về chỉ số và các giao diện trực quan khác có liên quan.
Các trường | |
---|---|
manufacturer |
Bắt buộc. Nhà sản xuất thiết bị này, chẳng hạn như "Google". |
product_name |
Bắt buộc. Tên sản phẩm dành cho người tiêu dùng cho mẫu thiết bị này, chẳng hạn như "thiết bị nguyên mẫu có Trợ lý Google". |
device_description |
Nội dung mô tả không bắt buộc về mẫu thiết bị này, chẳng hạn như "Loa thông minh của Google, có tích hợp Trợ lý Google". |
UpdateDeviceModelRequest
Thông báo yêu cầu cho DevicesPlatformService.UpdateDeviceModel.
Các trường | |
---|---|
name |
Tên tài nguyên của dự án cần cập nhật mẫu thiết bị, có dạng |
device_model |
Nhà phát triển mẫu thiết bị mới muốn cập nhật. |