Argument

Zapis JSON
{
  "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.
}
Pola
name

string

nazwa argumentu dla danych wejściowych.

rawText

string

Nieprzetworzony tekst, wpisywany lub dyktowany, stanowiący wartość argumentu.

textValue

string

Określana, gdy wzorzec zapytania zawiera typ $org.schema.type.Text lub oczekiwane dane wejściowe mają wbudowaną intencję: actions.intent.TEXT lub actions.intent.OPTION. Pamiętaj, że dla intencji OPTION ustawiamy textValue jako klucz opcji, a rawText powyżej wskazuje nieprzetworzony zakres w zapytaniu użytkownika.

status

object (Status)

Określana, kiedy wystąpił błąd podczas obliczania argumentu. Na przykład intencja wbudowana „actions.intent.PLACE” może zwrócić stan błędu, jeśli użytkownik odmówił dostępu do lokalizacji swojego urządzenia.

Pole sumy value. Podano jedną z tych wartości. value może mieć tylko jedną z tych wartości:
intValue

string (int64 format)

Określana, gdy wzorzec zapytania zawiera typ $org.schema.type.Number lub oczekiwane dane wejściowe mają wbudowaną intencję: „assistant.intent.action.NUMBER”.

floatValue

number

Określona na potrzeby intencji wbudowanej: „actions.intent.NUMBER”

boolValue

boolean

Określana, gdy wzorzec zapytania zawiera typ $org.schema.type.YesNo lub oczekiwane dane wejściowe mają wbudowaną intencję: actions.intent.CONFIRMATION. UWAGA: jeśli brakuje wartości logicznej, jest to false.

datetimeValue

object (DateTime)

Określona na potrzeby intencji wbudowanej: actions.intent.DATETIME.

placeValue

object (Location)

Określana, gdy wzorzec zapytania zawiera typ $org.schema.type.Location lub oczekiwane dane wejściowe mają wbudowaną intencję: „actions.intent.PLACE”.

extension

object

Rozszerzenie, którego typ zależy od argumentu. Jeśli np. nazwa argumentu dla intencji actions.intent.SIGN_IN to SIGN_IN, to rozszerzenie będzie zawierać wartość SignInValue.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

structuredValue

object (Struct format)

Określana, kiedy Google musi przekazać wartość danych w formacie JSON.

Stan

Typ Status definiuje model błędu logicznego, który jest odpowiedni dla różnych środowisk programowania, w tym interfejsów API REST i interfejsów API RPC. Jest używany przez gRPC. Każdy komunikat Status zawiera 3 rodzaje danych: kod błędu, komunikat o błędzie i szczegóły błędu.

Więcej informacji o tym modelu błędu i o tym, jak z nim korzystać, znajdziesz w dokumencie API Design Guide (w języku angielskim).

Zapis JSON
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Pola
code

integer

Kod stanu, który powinien być wartością wyliczeniową google.rpc.Code.

message

string

Komunikat o błędzie widoczny dla dewelopera w języku angielskim. Każdy komunikat o błędzie widoczny dla użytkownika powinien być zlokalizowany i wysyłany w polu google.rpc.Status.details lub zlokalizowany przez klienta.

details[]

object

Lista komunikatów zawierających szczegółowe informacje o błędzie. Istnieje wspólny zestaw typów wiadomości używanych przez interfejsy API.

Obiekt zawierający pola dowolnego typu. Dodatkowe pole "@type" zawiera identyfikator URI identyfikujący typ. Przykład: { "id": 1234, "@type": "types.example.com/standard/id" }.

DateTime

wartość argumentu daty i godziny pozyskana na podstawie danych wejściowych użytkownika. Nie zawiera informacji o strefie czasowej.

Zapis JSON
{
  "date": {
    object (Date)
  },
  "time": {
    object (TimeOfDay)
  }
}
Pola
date

object (Date)

wartość daty

time

object (TimeOfDay)

wartość czasu

Data

Reprezentuje całą datę kalendarzową lub jej część, np. datę urodzin. Pora dnia i strefa czasowa są podane w innym miejscu lub nie są istotne. Data odnosi się do kalendarza proleptycznego. Mogą to być:

  • Pełna data z wartościami innymi niż 0 roku, miesiąca i dnia
  • Miesiąc i dzień z zerowym rokiem, np. rocznica
  • samodzielnie rok z zerowymi wartościami miesiąca i dnia;
  • Wartość określająca rok i miesiąc z zerowym dniem, np.data ważności karty kredytowej.

Pokrewne rodzaje treści: google.type.TimeOfDay i google.protobuf.Timestamp.

Zapis JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Należy podać wartość z zakresu od 1 do 9999 lub 0 w przypadku daty bez roku.

month

integer

Miesiąc roku. Należy podać wartość z zakresu od 1 do 12 lub 0 w przypadku roku bez miesiąca i dnia.

day

integer

Dzień miesiąca. Musi mieć wartość od 1 do 31 i być ważna dla roku i miesiąca lub 0 w przypadku samego roku lub roku i miesiąca, w przypadku którego dzień nie jest istotny.

TimeOfDay

Reprezentuje porę dnia. Data i strefa czasowa są nieistotne lub zostały określone w innym miejscu. Interfejs API może zezwolić na sekundy przestępne. Pokrewne rodzaje treści: google.type.Date i google.protobuf.Timestamp.

Zapis JSON
{
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer
}
Pola
hours

integer

Godziny dnia w formacie 24-godzinnym. Wartość powinna mieścić się w zakresie od 0 do 23. W przypadku takich sytuacji jak godzina zamknięcia firmy interfejs API może zezwolić na wartość „24:00:00”.

minutes

integer

Minuty w ciągu dnia. Wymagana wartość z zakresu od 0 do 59.

seconds

integer

Sekundy minut czasu. Zwykle musi mieścić się w zakresie od 0 do 59. Interfejs API może zezwolić na wartość 60, jeśli zezwala na sekundy przestępne.

nanos

integer

Ułamki sekund w nanosekundach. Wartość musi mieścić się w zakresie od 0 do 999 999 999.