Argument

JSON gösterimi
{
  "name": string,
  "rawText": string,
  "textValue": string,
  "status": {
    object (Status)
  },

  // Union field value can be only one of the following:
  "intValue": string,
  "floatValue": number,
  "boolValue": boolean,
  "datetimeValue": {
    object (DateTime)
  },
  "placeValue": {
    object (Location)
  },
  "extension": {
    "@type": string,
    field1: ...,
    ...
  },
  "structuredValue": {
    object
  }
  // End of list of possible types for union field value.
}
Alanlar
name

string

giriş için sağlanan bağımsız değişkenin adı.

rawText

string

Bağımsız değişkenin değerini sağlayan, yazılan veya okunan ham metin.

textValue

string

Sorgu kalıbı bir $org.schema.type.Text türü içerdiğinde veya beklenen girişin yerleşik bir amacı olduğunda belirtilir: actions.intent.TEXT veya actions.intent.OPTION. OPTION amacı için textValue seçeneğini seçenek anahtarı olarak ayarladığımızı unutmayın. Yukarıdaki rawText, kullanıcının sorgusundaki ham aralığı gösterir.

status

object (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

string (int64 format)

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

number

Yerleşik amaç için belirtilir: "actions.intent.NUMBER"

boolValue

boolean

Sorgu kalıbı $org.schema.type.YesNo türü içerdiğinde veya beklenen giriş yerleşik bir amaca sahip olduğunda belirtilir: actions.intent.CONFIRMATION. NOT: Boole değeri eksikse false değerini temsil eder.

datetimeValue

object (DateTime)

Yerleşik amaç için belirtilen: actions.intent.DATETIME.

placeValue

object (Location)

Sorgu kalıbı $org.schema.type.Location türü veya beklenen giriş yerleşik bir amaca sahip olduğunda belirtilir: "actions.intent.PLACE".

extension

object

Türü bağımsız değişkene bağlı olan uzantı. Örneğin, actions.intent.SIGN_IN amacı için bağımsız değişken adı SIGN_IN ise bu uzantı bir SignInValue değeri içerir.

Rastgele türde alanlar içeren bir nesne. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

structuredValue

object (Struct format)

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

integer

google.rpc.Code değerinin enum değeri olması gereken durum kodu.

message

string

Geliştiricinin karşılaştığı İngilizce hata mesajı. Kullanıcılara yönelik tüm hata mesajları yerelleştirilip google.rpc.Status.details alanında gönderilmeli veya istemci tarafından yerelleştirilmelidir.

details[]

object

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. "@type" adlı ek alan, türü tanımlayan bir URI içerir. Örnek: { "id": 1234, "@type": "types.example.com/standard/id" }.

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 (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
Alanlar
date

object (Date)

tarih değeri

time

object (TimeOfDay)

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

integer

Tarih yılı. 1 ile 9999 arasında veya yıl içermeyen bir tarih belirtiyorsanız 0 olmalıdır.

month

integer

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

integer

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

integer

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

integer

Günün saati dakikaları. 0 ile 59 arasında olmalıdır.

seconds

integer

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

integer

Saniyenin nanosaniye cinsinden kısmı. 0 ile 999.999.999 arasında olmalıdır.