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 podawanego na potrzeby danych wejściowych.

rawText

string

Nieprzetworzony tekst (wpisany lub wymawiany), który stanowił wartość argumentu.

textValue

string

Określany, 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 span w zapytaniu użytkownika.

status

object (Status)

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

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

string (int64 format)

Określany, 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ślany, 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 wartość logiczna false.

datetimeValue

object (DateTime)

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

placeValue

object (Location)

Określany, 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 to SIGN_IN w intencji actions.intent.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ślane, kiedy Google musi przekazywać wartość danych w formacie JSON.

Stan

Typ Status określa logiczny model błędów odpowiedni dla różnych środowisk programowania, w tym interfejsów API typu REST i RPC. Jest używany przez gRPC. Każdy komunikat Status zawiera 3 elementy danych: kod błędu, komunikat o błędzie i szczegóły błędu.

Więcej informacji na temat tego modelu błędów i sposobu jego działania znajdziesz w przewodniku 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ą równą google.rpc.Code.

message

string

komunikat o błędzie widoczny dla dewelopera. Powinien być w języku angielskim; Każdy komunikat o błędzie widoczny dla użytkowników powinien zostać zlokalizowany i wysłany w polu google.rpc.Status.details lub zlokalizowany przez klienta.

details[]

object

Lista komunikatów ze szczegółami błędu. Istnieje typowy zestaw typów wiadomości, których mogą używać 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 wyodrębniona z danych wejściowych użytkownika. Nie obejmuje 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 pełną lub częściową datę kalendarzową, np. urodziny. Pora dnia i strefa czasowa zostały określone w innym miejscu lub nie są istotne. Data zależy od kalendarza proleptycznego gregoriańskiego. Może to oznaczać:

  • pełną datę, zawierającą rok, miesiąc i dzień o wartości większej niż 0;
  • Wartość miesiąca i dnia, z zerowym rokiem, np. rocznica
  • Samodzielny rok, z zerowymi wartościami miesiąca i dnia
  • Wartość roku i miesiąca z zerową liczbą dni, np. datę ważności karty kredytowej;

Podobne typy to google.type.TimeOfDay i google.protobuf.Timestamp.

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

integer

Rok. Wartość musi mieścić się w przedziale od 1 do 9999 lub mieć wartość 0, jeśli określasz datę bez roku.

month

integer

Miesiąc roku. Musi mieścić się w zakresie od 1 do 12 lub 0 w przypadku roku bez miesiąca i dnia.

day

integer

Dzień miesiąca. Musi mieć wartość z zakresu od 1 do 31 i być ważny dla roku i miesiąca. Jeśli podajesz sam rok lub rok i miesiąc, w przypadku których dzień nie ma znaczenia, data musi mieć wartość 0.

TimeOfDay

Przedstawia 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. Podobne typy to 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. Interfejs API może zezwolić na wartość „24:00:00” w takich sytuacjach jak zamknięcie firmy.

minutes

integer

Minuty dnia. Wartość musi mieścić się w przedziale od 0 do 59.

seconds

integer

Sekundy czasu trwania. Zwykle musi mieścić się w zakresie od 0 do 59. Interfejs API może akceptować wartość 60, jeśli zezwala na użycie sekund przestępnych.

nanos

integer

Ułamki sekund w nanosekundach. Musi mieścić się w przedziale od 0 do 999 999 999.