Dizin
DevicesPlatformService
(arayüz)CreateDeviceModelRequest
(message)CreateDeviceRequest
(message)DeleteDeviceModelRequest
(message)DeleteDeviceRequest
(message)Device
(message)Device.ClientType
(enum)DeviceModel
(message)DeviceModel.ExecutionMode
(enum)GetDeviceModelRequest
(message)GetDeviceRequest
(message)ListDeviceModelsRequest
(message)ListDeviceModelsResponse
(message)ListDevicesRequest
(message)ListDevicesResponse
(message)Manifest
(message)UpdateDeviceModelRequest
(message)
DevicesPlatformService
Bu hizmet Google dışı cihazları yönetir. Şu anda geliştiricilere: * cihaz modeli kaydı için bir API, * cihaz örneği kaydı için bir API sunulmaktadır.
Cihaz modeli kaydı, ilgili modeldeki tüm cihazlar arasında paylaşılan özellikleri ve yapılandırmaları içeren cihaz modelini oluşturur ve yönetir.
Cihaz örneği kaydı, modelinde tanımlanan özelliklere ve yapılandırmalara göre bir cihaz örneğini örnekler ve geliştiricinin, cihazlar arasında değişen bazı özellikler tanımlamasına olanak tanır. Kayıttan sonraki yürütme süresi sırasında her gRPC isteğinde hem device_model_id hem de device_id gerekir ve Google Assistant API'si her iki kimliğin de kayıtlı olmasını gerektirir. Aksi takdirde bir hata döndürülür.
CreateDevice | |
---|---|
Bir cihaz kaydettirin. Cihaz zaten mevcut ya da başarısız olduysa işlem başarılı veya hatalıysa cihazı geri gönderin.
|
CreateDeviceModel | |
---|---|
3. taraf cihaz modeli oluşturun.
|
DeleteDevice | |
---|---|
Kullanıcının sahip olduğu belirli bir cihazı siler. Başarılı olursa boş döndürülür, aksi takdirde cihazın bulunamadığını veya silinemediğini belirten bir hata mesajı döndürülür.
|
DeleteDeviceModel | |
---|---|
3. taraf cihaz modelini silin.
|
GetDevice | |
---|---|
Kullanıcının sahip olduğu belirli bir cihazın ayar bilgilerini alma, başarılıysa cihazı geri, başarısız olursa cihazı geri gönderir.
|
GetDeviceModel | |
---|---|
Cihaz modeli kimliği belirtildiğinde bir cihaz modeli döndürün.
|
ListDeviceModels | |
---|---|
Bu REST API çağrısıyla ilişkilendirilmiş proje kimliği için cihaz modellerini listeleyin.
|
ListDevices | |
---|---|
OAuth jetonunda, belirtilen project_id değerine ait kullanıcının sahip olduğu cihazların listesini alın. URL ve jetonun aynı project_id değerine sahip olup olmadığının kontrol edilmesi gerekiyor.
|
UpdateDeviceModel | |
---|---|
Bir cihaz modelini günceller, modelin yeni sürümünü döndürür. Not: Bu tam bir güncellemedir. Yani, güncelleme için tüm cihaz modelini göndermeniz gerekir.
|
CreateDeviceModelRequest
CihazlarPlatformService.CreateDeviceModel için istek mesajı.
Alanlar | |
---|---|
parent |
Cihaz modelinin oluşturulacağı projenin |
device_model |
Oluşturulacak device_model. |
CreateDeviceRequest
CihazlarPlatformService.CreateDevice için istek mesajı.
Alanlar | |
---|---|
device |
Kullanıcı tarafından sağlanan ham cihaz bilgisi. device_id, projede benzersiz olmalı ve proje sahibi tarafından atanmalıdır. |
parent |
Cihazın ait olduğu projenin |
DeleteDeviceModelRequest
CihazlarPlatformService.DeleteDeviceModel için mesaj isteyin.
Alanlar | |
---|---|
name |
Cihaz modelinin silineceği projenin |
DeleteDeviceRequest
CihazlarPlatformService.DeleteDevice için mesaj isteyin.
Alanlar | |
---|---|
name |
Cihazın silineceği projenin |
Cihaz
Alanlar | |
---|---|
name |
Cihazın |
id |
Zorunlu. Proje kapsamındaki benzersiz cihaz kimliği. Biçim, geliştirici tarafından tanımlanır. Ör. "06ba29e5-5f1c-1a89-303c-22de2580f2e2". Converse RPC gönderilirken DeviceConfig.device_id ile eşleşmelidir. Bu kimlik FDR için sıfırlanabilir. |
nickname |
Bu cihaz için tarafından belirtilen takma ad.Kullanıcı bir cihazla konuştuğunda konuşma tanıma ve cihaz hedefleme için kullanılır. Örneğin, kullanıcı "akıllı robotum" adlı bir cihazı olduğunda "akıllı robotumu sola taşı" diyebilir. |
model_id |
Zorunlu. Aracı kimliği için tüm cihazlar arasında cihaz "sınıfını" (model) benzersiz bir şekilde tanımlar (ör. "manufacturer-2017-v2". Bir projenin birden fazla farklı cihaz modeli olabileceğini unutmayın. |
client_type |
Zorunlu. Asistan SDK'sı, Asistan'ı cihazınıza entegre etmek için iki seçenek sunar. Bu alan, istemcinin Asistan SDK kitaplığına dayalı mı yoksa SDK hizmet API'sini mi çağırdığını belirlemek içindir. |
ClientType
İstemci türünü tanımlar.
Sıralamalar | |
---|---|
CLIENT_TYPE_UNSPECIFIED |
İstemcinin türü bilinmiyor, varsayılan değer. |
SDK_SERVICE |
SDK gRPC service API'si için bir Asistan isteğinin ve yanıtının ses baytlarını doğrudan değiştiren düşük düzey bir API'yi gösterir. Service |
SDK_LIBRARY |
Google Asistan istemci kitaplığı için yüksek düzeyde, etkinliğe dayalı bir API'ye sahip kullanıma hazır bir çözüm. |
DeviceModel
Cihaz ailesi için meta verileri tanımlar Cihaz modeli ayrıca bir cihaz ailesi için ortak özellikleri de tanımlar.
Alanlar | |
---|---|
name |
Cihaz modelinin |
device_model_id |
Zorunlu. Geliştirici tarafından belirtilen, "comcast-voice-assistant-2017-v1" gibi genel benzersiz kimlik. Halihazırda bir cihaz modeli kimliği varsa bir hata döndürülür. |
project_id |
Zorunlu. Cihaz Modeli ile ilişkilendirilmiş Cloud projesi kimliği. Her projenin birden fazla cihaz modeli oluşturmasına izin verilir. |
device_type |
Zorunlu. Bazı Geçerli Cihaz Türleri: "action.devices.types.LIGHT" "action.devices.types.OUTLET" "action.devices.types.SWITCH" "action.devices.types.AC_HEATING" |
traits[] |
İsteğe bağlı. Cihazın destekleyebileceği yerleşik özelliklerin listesi. Örneğin: "action.devices.traits.OnKapalı" |
manifest |
Zorunlu. Cihaz modelini ve üreticisini açıklayan meta veriler. Bu ad SDK konsolunda, metrik kontrol panellerinde ve ilgili diğer görsel arayüzlerde gösterilir. |
execution_modes[] |
Cihaz işlemleri için isteğe bağlı Yürütme modu. DIRECT_RESPONSE ayarlanırsa cihaz kontrolü için cihazlar etkinleştirilir. |
ExecutionMode
Cihaz İşlemleri için yürütme modu; şu anda yalnızca doğrudan yanıtı desteklemektedir.
Sıralamalar | |
---|---|
MODE_UNSPECIFIED |
Belirtilmedi. |
DIRECT_RESPONSE |
Cihaz doğrudan yürütmeyi destekliyor. Cihazdan gelen sorgularda asistan, komut ve parametrelerle birlikte DeviceControlRequest değerini döndürür. |
GetDeviceModelRequest
CihazlarPlatformService.GetDeviceModel için mesaj isteyin.
Alanlar | |
---|---|
name |
Cihaz modelinin alınacağı projenin |
GetDeviceRequest
CihazlarPlatformService.GetDevice için mesaj isteyin.
Alanlar | |
---|---|
name |
Cihazı almak için |
ListDeviceModelsRequest
CihazlarPlatformService.ListDeviceModel için istek mesajı.
Alanlar | |
---|---|
parent |
Cihaz modellerinin |
ListDeviceModelsResponse
CihazlarPlatformService.CreateDeviceModel için yanıt mesajı.
Alanlar | |
---|---|
device_models[] |
|
ListDevicesRequest
DevicePlatformService.ListDevices için mesaj isteği gönderin.
Alanlar | |
---|---|
parent |
Cihazlarını listelemek istediğimiz projenin "projects/{project_id}" biçimindeki adı. |
ListDevicesResponse
DevicePlatformService.ListDevices için yanıt mesajı.
Alanlar | |
---|---|
devices[] |
bu kullanıcının ilgili projede sahip olduğu tüm cihazlar. |
Manifest
Cihaz modelini ve üreticisini açıklayan meta veriler. Bu ad SDK konsolunda, metrik kontrol panellerinde ve ilgili diğer görsel arayüzlerde gösterilir.
Alanlar | |
---|---|
manufacturer |
Zorunlu. Bu cihazın üreticisi (ör. "Google"). |
product_name |
Zorunlu. Bu cihaz modeli için tüketicilere yönelik ürün adı (ör. "Google Asistan prototip cihazı"). |
device_description |
Bu cihaz modeliyle ilgili isteğe bağlı açıklama (ör. "Google'ın sunduğu, Google Asistan özellikli akıllı hoparlör") |
UpdateDeviceModelRequest
CihazlarPlatformService.UpdateDeviceModel için mesaj isteyin.
Alanlar | |
---|---|
name |
Cihaz modelinin güncelleneceği projenin |
device_model |
Geliştiricinin güncelleme yapmak istediği yeni cihaz modeli. |