- Zapis JSON
- Użytkownik
- UserProfile (Profil użytkownika)
- PackageEntitlement
- Uprawnienia
- SignedData
- Urządzenie
- Powierzchnia
- Możliwości
- Rozmowa
- Dane wejściowe
- RawInput
AppRequest to żądanie wysyłane przez Asystenta Google do realizacji, aby umożliwić interakcję z akcją. Wersja interfejsu API jest podana w nagłówku HTTP. W interfejsie API w wersji 1 nagłówek zawiera: Google-Assistant-API-Version: v1
. W interfejsie API w wersji 2 nagłówek zawiera: Google-actions-API-Version: 2
. Przykłady wykorzystania tych danych w działaniach Google znajdziesz na stronie https://developers.google.com/assistant/df-asdk/reference/conversation-webhook-json .
Zapis JSON | |
---|---|
{ "user": { object ( |
Pola | |
---|---|
user |
Użytkownik, który zainicjował rozmowę. |
device |
Informacje o urządzeniu, którego użytkownik używa do interakcji z akcją. |
surface |
Informacje o powierzchni, z którą użytkownik wchodzi w interakcję, np. czy może ona generować dźwięk lub mieć ekran. |
conversation |
Przechowuje dane sesji, takie jak identyfikator i token rozmowy. |
inputs[] |
Lista danych wejściowych odpowiadających oczekiwanym danym wejściowym określonym przez akcję. W przypadku początkowego wyzwalacza rozmowy dane wejściowe zawierają informacje o tym, jak użytkownik wywołał rozmowę. |
isInSandbox |
Wskazuje, czy żądanie powinno być obsługiwane w trybie piaskownicy. |
availableSurfaces[] |
Powierzchnie dostępne do przekazania na powierzchnię krzyżową. |
Użytkownik
Zapis JSON | |
---|---|
{ "idToken": string, "profile": { object ( |
Pola | |
---|---|
idToken |
token reprezentujący tożsamość użytkownika. To jest token sieciowy Json zawierający zakodowany profil. Definicja jest dostępna pod adresem https://developers.google.com/identity/protocols/OpenIDConnect#obtainuserinfo. |
profile |
Informacje o użytkowniku. Niektóre pola są dostępne tylko wtedy, gdy użytkownik zezwolił na przekazanie tych informacji do akcji. |
accessToken |
Token OAuth2, który identyfikuje użytkownika w Twoim systemie. Dostępne tylko wtedy, gdy użytkownik połączy swoje konto. |
permissions[] |
Zawiera uprawnienia przyznane tej akcji przez użytkownika. |
locale |
Ustawienie języka głównego użytkownika wysyłającego żądanie. Jest zgodny z kodem języka IETF BCP-47 http://www.rfc-editor.org/rfc/bcp/bcp47.txt Nie zawiera jednak subtagu skryptu. |
lastSeen |
Sygnatura czasowa ostatniej interakcji z tym użytkownikiem. To pole jest pomijane, jeśli użytkownik nie miał wcześniej kontaktu z agentem. Znacznik czasu w formacie RFC3339 UTC „Zulu”, z dokładnością do nanosekund. Przykład: |
userStorage |
Nieprzejrzysty token dostarczony przez aplikację, który jest trwały w rozmowach konkretnego użytkownika. Maksymalny rozmiar ciągu to 10 tys. znaków. |
packageEntitlements[] |
Lista uprawnień użytkowników związanych z każdą nazwą pakietu wymienionego w pakiecie akcji (jeśli jakieś występują). |
userVerificationStatus |
Wskazuje stan weryfikacji użytkownika. |
UserProfile
Zawiera dane osobowe użytkownika. Pola są wypełniane tylko wtedy, gdy użytkownik wyraził zgodę na działanie dla określonego pola.
Zapis JSON | |
---|---|
{ "displayName": string, "givenName": string, "familyName": string } |
Pola | |
---|---|
displayName |
Imię i nazwisko użytkownika podane na jego koncie Google. Wymaga uprawnienia |
givenName |
Imię użytkownika podane na koncie Google. Wymaga uprawnienia |
familyName |
Nazwisko użytkownika podane na koncie Google. Pamiętaj, że to pole może być puste. Wymaga uprawnienia |
PackageEntitlement
Lista uprawnień powiązanych z nazwą pakietu
Zapis JSON | |
---|---|
{
"packageName": string,
"entitlements": [
{
object ( |
Pola | |
---|---|
packageName |
Powinna odpowiadać nazwie pakietu w pakiecie akcji. |
entitlements[] |
Lista uprawnień danej aplikacji |
Uprawnienie
Określa cyfrowe uprawnienia użytkownika. Rodzaje możliwych uprawnień: płatne aplikacje,zakupy w aplikacji, subskrypcje w aplikacji.
Zapis JSON | |
---|---|
{ "sku": string, "skuType": enum ( |
Pola | |
---|---|
sku |
Kod SKU produktu Nazwa pakietu płatnej aplikacji, sufiks Docidu Finsky w przypadku zakupu w aplikacji i subskrypcji w aplikacji. Dopasuj do metody getSku() w interfejsie Play InApp Billing API. |
skuType |
|
inAppDetails |
Dostępne tylko w przypadku zakupów w aplikacji i subskrypcji w aplikacji. |
SignedData
Zapis JSON | |
---|---|
{ "inAppPurchaseData": { object }, "inAppDataSignature": string } |
Pola | |
---|---|
inAppPurchaseData |
Dopasuj INAPP_PURCHASE_DATA z metody getPurchases(). Zawiera wszystkie dane o zakupach w aplikacji w formacie JSON Szczegółowe informacje znajdziesz w tabeli 6 na stronie https://developer.android.com/google/play/billing/billing_reference.html. |
inAppDataSignature |
Pasuje do IN_APP_DATA_SIGNATURE z metody getPurchases() w interfejsie Play InApp Billing API. |
Urządzenie
Informacje o urządzeniu, którego użytkownik używa do interakcji z akcją.
Zapis JSON | |
---|---|
{
"location": {
object ( |
Pola | |
---|---|
location |
Reprezentuje faktyczną lokalizację urządzenia, np. szerokość i długość geograficzną, oraz sformatowany adres. Wymaga uprawnienia |
Platforma
Informacje specyficzne dla klienta Asystenta Google, z którymi użytkownik wchodzi w interakcję. Platforma różni się od urządzenia tym, że na tym samym urządzeniu może znajdować się wiele platform Asystenta.
Zapis JSON | |
---|---|
{
"capabilities": [
{
object ( |
Pola | |
---|---|
capabilities[] |
Lista funkcji obsługiwanych przez platformę w momencie przesyłania żądania, np. |
Funkcja
Reprezentuje jednostkę funkcji, którą może obsługiwać powierzchnia.
Zapis JSON | |
---|---|
{ "name": string } |
Pola | |
---|---|
name |
Nazwa możliwości, np. |
Rozmowa
Zapis JSON | |
---|---|
{
"conversationId": string,
"type": enum ( |
Pola | |
---|---|
conversationId |
Unikalny identyfikator rozmowy wieloetapowej. Jest przypisana do pierwszej zakrętu. Po tym czasie rozmowa nie zmieni się, dopóki rozmowa nie zostanie zakończona. |
type |
Typ określa stan wątku w jego cyklu życia. |
conversationToken |
Nieprzezroczysty token określony przez akcję w ostatnim cyklu rozmowy. Akcja może go używać do śledzenia rozmowy lub do przechowywania danych dotyczących rozmowy. |
Dane wejściowe
Zapis JSON | |
---|---|
{ "rawInputs": [ { object ( |
Pola | |
---|---|
rawInputs[] |
Nieprzetworzona transkrypcja danych wejściowych z każdego etapu rozmowy. W przypadku działań w Google w celu dostarczenia do akcji niektórych typów danych wejściowych może być wymagane wielokrotne przejście do rozmowy. |
intent |
Wskazuje zamiar użytkownika. W przypadku pierwszej tury rozmowy intencja odwołuje się do intencji wyzwalającej akcję. W kolejnych sekwencjach rozmowy intencja będzie typowym działaniem w związku z intencją Google (zaczyna się od „działania”). Jeśli na przykład oczekiwane dane wejściowe to |
arguments[] |
Lista podanych wartości argumentów dla danych wejściowych wymaganych przez akcję. |
RawInput
Zapis JSON | |
---|---|
{ "inputType": enum ( |
Pola | ||
---|---|---|
inputType |
Wskazuje, w jaki sposób użytkownik podał dane wejściowe: odpowiedź zapisana, głosowa, nieokreślona itp. |
|
Pole sumy input . Rzeczywista wartość wejściowa input może być tylko jedną z tych wartości: |
||
query |
wpisywane lub odczytywane przez użytkownika; |
|
url |
URL wyzwalający. |