JSON gösterimi | |
---|---|
{ "name": string, "rawText": string, "textValue": string, "status": { object ( |
Alanlar | ||
---|---|---|
name |
giriş için sağlanan bağımsız değişkenin adı. |
|
rawText |
Bağımsız değişkenin değerini sağlayan, yazılan veya okunan ham metin. |
|
textValue |
Sorgu kalıbı bir |
|
status |
Bağımsız değişken hesaplanırken bir hatayla ne zaman karşılaşıldığı belirtilir. Örneğin, kullanıcı, cihazının konumuna erişim iznini reddederse "actions.intent.PLACE" yerleşik amacı bir hata durumu döndürebilir. |
|
value alanı. Aşağıdakilerden biri belirtilmiş. value şunlardan yalnızca biri olabilir: |
||
intValue |
Sorgu kalıbı $org.schema.type.Number türü veya beklenen giriş yerleşik bir amaca sahip olduğunda belirtilir: "assistant.intent.action.NUMBER". |
|
floatValue |
Yerleşik amaç için belirtilir: "actions.intent.NUMBER" |
|
boolValue |
Sorgu kalıbı |
|
datetimeValue |
Yerleşik amaç için belirtilen: |
|
placeValue |
Sorgu kalıbı $org.schema.type.Location türü veya beklenen giriş yerleşik bir amaca sahip olduğunda belirtilir: "actions.intent.PLACE". |
|
extension |
Türü bağımsız değişkene bağlı olan uzantı. Örneğin, Rastgele türde alanlar içeren bir nesne. |
|
structuredValue |
Google'ın veri değerini JSON biçiminde iletmesi gerektiğinde belirtilir. |
Durum
Status
türü, REST API'ler ve RPC API'leri dahil olmak üzere farklı programlama ortamları için uygun bir mantıksal hata modeli tanımlar. gRPC tarafından kullanılır. Her Status
mesajı üç veri parçası içerir: hata kodu, hata mesajı ve hata ayrıntıları.
Bu hata modeli ve modelle nasıl çalışılacağı hakkında daha fazla bilgiyi API Tasarım Kılavuzu'nda bulabilirsiniz.
JSON gösterimi | |
---|---|
{ "code": integer, "message": string, "details": [ { "@type": string, field1: ..., ... } ] } |
Alanlar | |
---|---|
code |
|
message |
Geliştiricinin karşılaştığı İngilizce hata mesajı. Kullanıcılara yönelik tüm hata mesajları yerelleştirilip |
details[] |
Hata ayrıntılarını içeren mesajların listesi. API'lerin kullanabileceği yaygın bir dizi mesaj türü vardır. Rastgele türde alanlar içeren bir nesne. |
DateTime
kullanıcı girişinden ayrıştırılan tarih ve saat bağımsız değişken değeri. Saat dilimi bilgilerini içermez.
JSON gösterimi | |
---|---|
{ "date": { object ( |
Alanlar | |
---|---|
date |
tarih değeri |
time |
zaman değeri |
Tarih
Takvim tarihini tam veya kısmi olarak (ör. doğum günü) temsil eder. Günün saati ve saat dilimi, başka bir yerde belirtilmiş veya önemli değil. Bu tarih, Proleptik Miladi Takvimi ile görelidir. Bu, aşağıdakileri temsil edebilir:
- Sıfır olmayan yıl, ay ve gün değerleriyle tam tarih
- Sıfır yıllı ay ve gün değeri, ör. yıl dönümü
- Sıfır ay ve gün değerleriyle kendi başına bir yıl
- Sıfır gün içeren yıl ve ay değeridir (ör. kredi kartı son kullanma tarihi)
İlgili türler şunlardır: google.type.TimeOfDay
ve google.protobuf.Timestamp
.
JSON gösterimi | |
---|---|
{ "year": integer, "month": integer, "day": integer } |
Alanlar | |
---|---|
year |
Tarih yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarih belirtiyorsanız 0 olmalıdır. |
month |
Yılın ayı. 1 ile 12 arasında veya ay ve gün olmadan yıl belirtiyorsanız 0 ile arasında olmalıdır. |
day |
Ayın günü. 1 ile 31 arasında olup yıl ve ay için geçerli olmalıdır. Tek başına yıl belirtiyorsanız ya da günün önemli olmadığı yıl ve ay belirtilirse 0 olmalıdır. |
TimeOfDay
Günün saatini temsil eder. Tarih ve saat dilimi önemli değil veya başka bir yerde belirtilmiş. API'ler artık saniyelere izin vermeyi tercih edebilir. İlgili türler şunlardır: google.type.Date
ve google.protobuf.Timestamp
.
JSON gösterimi | |
---|---|
{ "hours": integer, "minutes": integer, "seconds": integer, "nanos": integer } |
Alanlar | |
---|---|
hours |
24 saat biçiminde günün saatleri. 0 ile 23 arasında olmalıdır. API'ler, işletmenin kapanış saati gibi senaryolar için "24:00:00" değerine izin vermeyi tercih edebilir. |
minutes |
Günün saati dakikaları. 0 ile 59 arasında olmalıdır. |
seconds |
Dakikanın saniye cinsinden saniyeleri. Normalde 0 ile 59 arasında olmalıdır. Artık saniyelere izin veren API'ler 60 değerine izin verebilir. |
nanos |
Saniyenin nanosaniye cinsinden kısmı. 0 ile 999.999.999 arasında olmalıdır. |