Z tego przewodnika dowiesz się, jak tworzyć projekt w Actions, który obejmuje transakcje sprzedaży towarów fizycznych i używa płatności za pomocą Google Pay.
Przepływ transakcji
Gdy projekt Actions obsługuje transakcje fizyczne za pomocą Google Pay, stosuje następujący proces:
- Zbieranie informacji (opcjonalne) – w zależności od charakteru transakcji możesz na początku rozmowy uzyskać od użytkownika następujące informacje:
- Weryfikowanie wymagań dotyczących transakcji – na początku rozmowy skorzystaj z Asystenta wymagań dotyczących transakcji, aby sprawdzić, czy dane karty użytkownika są prawidłowo skonfigurowane i dostępne, zanim użytkownik utworzy koszyk.
- Poproś o adres dostawy – jeśli transakcja wymaga podania adresu dostawy, poproś o realizację intencji pomocniczej dotyczącej tego adresu, aby uzyskać adres od użytkownika.
- Stworzenie zamówienia – poprowadź użytkownika przez proces składania koszyka, w którym wybiera produkty, które chce kupić.
- Proponowanie zamówienia – gdy koszyk jest gotowy, zaproponuj zamówienie użytkownikowi, aby mógł potwierdzić, że jest poprawne. Jeśli zamówienie zostanie potwierdzone, otrzymasz odpowiedź ze szczegółami zamówienia i tokenem płatności.
- Sfinalizuj zamówienie i wyślij potwierdzenie – po potwierdzeniu zamówienia zaktualizuj śledzenie asortymentu lub inne usługi realizacji zamówień, a potem wyślij użytkownikowi potwierdzenie.
- Wysyłanie aktualizacji zamówień – w trakcie okresu realizacji zamówienia przekazuj aktualizacje zamówienia użytkownika, wysyłając żądania PATCH do interfejsu Orders API.
Ograniczenia i wytyczne dotyczące sprawdzania
Pamiętaj, że w przypadku akcji z transakcjami obowiązują dodatkowe zasady. Sprawdzenie działań z transakcjami może nam zająć do 6 tygodni, więc uwzględnij ten czas podczas planowania harmonogramu publikowania. Aby ułatwić proces sprawdzania, przed przesłaniem akcji do sprawdzenia upewnij się, że przestrzegasz zasad i wytycznych dotyczących transakcji.
Akcje, które sprzedają towary fizyczne, możesz wdrażać tylko w tych krajach:
|
Australia Brazylia Kanada Indonezja |
Japonia Meksyk Katar Rosja |
Singapur Szwajcaria Tajlandia Turcja Wielka Brytania Stany Zjednoczone |
Utwórz projekt
Obszerne przykłady rozmów transakcyjnych znajdziesz w naszych przykładach transakcji w językach Node.js i Java.
Konfigurowanie projektu
Podczas tworzenia akcji musisz określić, że chcesz przeprowadzać transakcje w Konsoli Actions. Jeśli korzystasz z biblioteki klienta Node.JS, skonfiguruj realizację tak, aby korzystała z najnowszej wersji interfejsu Orders API.
Aby skonfigurować projekt i realizację:
- Utwórz nowy projekt lub zaimportuj istniejący.
- Kliknij Wdróż > Informacje z katalogu.
W sekcji Dodatkowe informacje > Transakcje zaznacz pole „Czy Twoje działania używają interfejsu Transaction API do realizacji transakcji towarów fizycznych?”.
Jeśli do tworzenia realizacji akcji używasz biblioteki klienta Node.JS, otwórz kod realizacji i zaktualizuj deklaracja aplikacji, aby ustawić flagę
ordersv3natrue. Poniższy fragment kodu zawiera przykładową deklaracja aplikacji dla usługi Orders w wersji 3.
Node.js
const {dialogflow} = require('actions-on-google');
let app = dialogflow({
clientId, // If using account linking
debug: true,
ordersv3: true,
});
Node.js
const {actionssdk} = require('actions-on-google');
let app = actionssdk({
clientId, // If using account linking
debug: true,
ordersv3: true,
});
1. Zbieranie informacji (opcjonalnie)
1a. Zweryfikuj wymagania dotyczące transakcji (opcjonalnie)
Interfejs użytkownika
Zalecamy wywołanie intencji actions.intent.TRANSACTION_REQUIREMENTS_CHECK, gdy tylko użytkownik wyrazi chęć dokonania zakupu. W ten sposób upewnisz się, że będzie mógł zrealizować transakcję. Po wywołaniu akcja może np. zapytać: „Czy chcesz zamówić buty, czy sprawdzić saldo konta?”. Gdy użytkownik mówi „zamów buty”, należy od razu poprosić o ten zamiar. Dzięki temu klient będzie mógł kontynuować transakcję i poprawić ustawienia, które uniemożliwiają kontynuowanie transakcji.
Wysłanie prośby o spełnienie wymagań dotyczących transakcji skutkuje jednym z tych efektów:
- Jeśli wymagania zostaną spełnione, intencja zostanie odesłana do realizacji z warunkiem powodzenia i będzie można kontynuować tworzenie zamówienia użytkownika.
- Jeśli co najmniej 1 z wymagań nie zostanie spełniony, intencja będzie odsyłana do realizacji z warunkem niepowodzenia. W takim przypadku należy odwrócić rozmowę
od procesu transakcyjnego lub ją zakończyć.
- Jeśli użytkownik będzie w stanie naprawić błędy, które spowodowały błąd, pojawi się prośba o rozwiązanie tych problemów na urządzeniu. Jeśli rozmowa odbywa się tylko na platformie głosowej, na telefonie użytkownika zostanie zainicjowane przekazanie wiadomości.
realizację,
Aby mieć pewność, że użytkownik spełnia wymagania dotyczące transakcji, poproś o realizację intencji actions.intent.TRANSACTION_REQUIREMENTS_CHECK za pomocą obiektu TransactionRequirementsCheckSpec.
Sprawdź wymagania
Aby sprawdzić, czy użytkownik spełnia wymagania dotyczące transakcji, użyj biblioteki klienta:
Node.js
conv.ask(new TransactionRequirements());
Node.js
conv.ask(new TransactionRequirements());
Java
return getResponseBuilder(request)
.add(new TransactionRequirements())
.build();
Java
return getResponseBuilder(request)
.add(new TransactionRequirements())
.build();
JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Looks like you're good to go! Next I'll need your delivery address.Try saying \"get delivery address\"."
}
}
],
"suggestions": [
{
"title": "get delivery address"
}
]
}
}
}
}
JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.TEXT"
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Looks like you're good to go! Next I'll need your delivery address.Try saying \"get delivery address\"."
}
}
],
"suggestions": [
{
"title": "get delivery address"
}
]
}
}
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"google_payment\"}}"
}
Otrzymuj wynik kontroli wymagań
Gdy Asystent zrealizuje intencję, wysyła realizację żądania z intencją actions.intent.TRANSACTION_REQUIREMENTS_CHECK z wynikiem kontroli.
Aby prawidłowo obsługiwać to żądanie, zadeklaruj intencję Dialogflow wywoływaną przez zdarzenie actions_intent_TRANSACTION_REQUIREMENTS_CHECK. Po wywołaniu – zajmij się nim w realizacji, korzystając z biblioteki klienta:
Node.js
app.intent('Transaction Check Complete', (conv) => {
const arg = conv.arguments.get('TRANSACTION_REQUIREMENTS_CHECK_RESULT');
if (arg && arg.resultType === 'CAN_TRANSACT') {
// Normally take the user through cart building flow
conv.ask(`Looks like you're good to go! ` +
`Next I'll need your delivery address.` +
`Try saying "get delivery address".`);
conv.ask(new Suggestions('get delivery address'));
} else {
// Exit conversation
conv.close('Transaction failed.');
}
});
Node.js
app.intent('actions.intent.TRANSACTION_REQUIREMENTS_CHECK', (conv) => {
const arg = conv.arguments.get('TRANSACTION_REQUIREMENTS_CHECK_RESULT');
if (arg && arg.resultType === 'CAN_TRANSACT') {
// Normally take the user through cart building flow
conv.ask(`Looks like you're good to go! ` +
`Next I'll need your delivery address.` +
`Try saying "get delivery address".`);
conv.ask(new Suggestions('get delivery address'));
} else {
// Exit conversation
conv.close('Transaction failed.');
}
});
Java
@ForIntent("Transaction Check Complete")
public ActionResponse transactionCheckComplete(ActionRequest request) {
LOGGER.info("Checking Transaction Requirements Result.");
// Check result of transaction requirements check
Argument transactionCheckResult = request
.getArgument("TRANSACTION_REQUIREMENTS_CHECK_RESULT");
boolean result = false;
if (transactionCheckResult != null) {
Map<String, Object> map = transactionCheckResult.getExtension();
if (map != null) {
String resultType = (String) map.get("resultType");
result = resultType != null && resultType.equals("CAN_TRANSACT");
}
}
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (result) {
// Normally take the user through cart building flow
responseBuilder
.add("Looks like you're good to go! Next " +
"I'll need your delivery address. Try saying " +
"\"get delivery address\".")
.addSuggestions(new String[]{"get delivery address"});
} else {
// Exit conversation
responseBuilder.add("Transaction failed.");
}
return responseBuilder.build();
}
Java
@ForIntent("actions.intent.TRANSACTION_REQUIREMENTS_CHECK")
public ActionResponse transactionCheckComplete(ActionRequest request) {
LOGGER.info("Checking Transaction Requirements Result.");
// Check result of transaction requirements check
Argument transactionCheckResult = request
.getArgument("TRANSACTION_REQUIREMENTS_CHECK_RESULT");
boolean result = false;
if (transactionCheckResult != null) {
Map<String, Object> map = transactionCheckResult.getExtension();
if (map != null) {
String resultType = (String) map.get("resultType");
result = resultType != null && resultType.equals("CAN_TRANSACT");
}
}
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (result) {
// Normally take the user through cart building flow
responseBuilder
.add("Looks like you're good to go! Next " +
"I'll need your delivery address. Try saying " +
"\"get delivery address\".")
.addSuggestions(new String[]{"get delivery address"});
} else {
// Exit conversation
responseBuilder.add("Transaction failed.");
}
return responseBuilder.build();
}
JSON
{
"responseId": "db1a333c-2781-41e3-84b1-cc0cc37643d7-594de0a7",
"queryResult": {
"queryText": "actions_intent_TRANSACTION_REQUIREMENTS_CHECK",
"action": "transaction.check.complete",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "Failed to get transaction check results",
"fulfillmentMessages": [
{
"text": {
"text": [
"Failed to get transaction check results"
]
}
}
],
"outputContexts": [
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/google_assistant_input_type_keyboard"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/merchant_payment",
"lifespanCount": 1
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_intent_transaction_requirements_check",
"parameters": {
"TRANSACTION_REQUIREMENTS_CHECK_RESULT": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionRequirementsCheckResult",
"resultType": "CAN_TRANSACT"
},
"text": ""
}
}
],
"intent": {
"name": "projects/df-transactions/agent/intents/fd16d86b-60db-4d19-a683-5b52a22f4795",
"displayName": "Transaction Check Complete"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"lastSeen": "2019-09-23T19:49:32Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy",
"type": "ACTIVE",
"conversationToken": "[\"merchant_payment\"]"
},
"inputs": [
{
"intent": "actions.intent.TRANSACTION_REQUIREMENTS_CHECK",
"rawInputs": [
{
"inputType": "KEYBOARD"
}
],
"arguments": [
{
"name": "TRANSACTION_REQUIREMENTS_CHECK_RESULT",
"extension": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionRequirementsCheckResult",
"resultType": "CAN_TRANSACT"
}
},
{
"name": "text"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
}
]
}
},
"session": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy"
}
JSON
{
"user": {
"locale": "en-US",
"lastSeen": "2019-11-11T23:56:03Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGFwStZlYaQ9YT8rg9t_idVsxZrku1pUDrEbGSJmSUMatVdPwPEEQSCe1IwIBoN4sS4Weyn9pmgetEgbsWgw3JSvQmw",
"type": "ACTIVE",
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\"}}"
},
"inputs": [
{
"intent": "actions.intent.TRANSACTION_REQUIREMENTS_CHECK",
"rawInputs": [
{}
],
"arguments": [
{
"name": "TRANSACTION_REQUIREMENTS_CHECK_RESULT",
"extension": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionRequirementsCheckResult",
"resultType": "CAN_TRANSACT"
}
},
{
"name": "text"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
}
]
}
1b. Poproś o adres dostawy (opcjonalnie)
Jeśli transakcja wymaga podania adresu dostawy użytkownika, możesz poprosić o realizację intencji actions.intent.DELIVERY_ADDRESS. Ta opcja może być przydatna do określania łącznej ceny, miejsca dostawy i odbioru oraz do sprawdzania, czy użytkownik znajduje się w regionie, w którym świadczysz usługi.
Prosząc o zrealizowanie tej intencji, udostępniasz opcję reason, która umożliwia poprzedzanie prośby Asystenta o uzyskanie adresu ciągiem tekstowym.
Jeśli na przykład określisz, gdzie należy wysłać zamówienie, Asystent może zapytać użytkownika:
„Aby dowiedzieć się, gdzie wysłać zamówienie, muszę podać Twój adres dostawy”
Interfejs użytkownika
Na platformach z ekranem użytkownik wybiera adres, którego chce użyć do zrealizowania transakcji. Jeśli klient nie podał wcześniej adresu, może wpisać nowy.
W usługach z obsługą tylko głosu Asystent poprosi użytkownika o zgodę na udostępnienie domyślnego adresu na potrzeby transakcji. Jeśli rozmówca nie podał wcześniej adresu, rozmowa zostanie przekazana do telefonu.
Poproś o podanie adresu
Node.js
app.intent('Delivery Address', (conv) => {
conv.ask(new DeliveryAddress({
addressOptions: {
reason: 'To know where to send the order',
},
}));
});
Node.js
conv.ask(new DeliveryAddress({
addressOptions: {
reason: 'To know where to send the order',
},
}));
Java
@ForIntent("Delivery Address")
public ActionResponse deliveryAddress(ActionRequest request) {
DeliveryAddressValueSpecAddressOptions addressOptions =
new DeliveryAddressValueSpecAddressOptions()
.setReason("To know where to send the order");
return getResponseBuilder(request)
.add(new DeliveryAddress()
.setAddressOptions(addressOptions))
.build();
}
Java
DeliveryAddressValueSpecAddressOptions addressOptions =
new DeliveryAddressValueSpecAddressOptions()
.setReason("To know where to send the order");
return getResponseBuilder(request)
.add(new DeliveryAddress()
.setAddressOptions(addressOptions))
.build();
JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.DELIVERY_ADDRESS",
"data": {
"@type": "type.googleapis.com/google.actions.v2.DeliveryAddressValueSpec",
"addressOptions": {
"reason": "To know where to send the order"
}
}
}
}
}
}
JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.DELIVERY_ADDRESS",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.DeliveryAddressValueSpec",
"addressOptions": {
"reason": "To know where to send the order"
}
}
}
]
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\"}}"
}
Odbierz adres
Gdy Asystent zrealizuje intencję, wyśle żądanie z intencją actions.intent.DELIVERY_ADDRESS.
Aby prawidłowo obsługiwać to żądanie, zadeklaruj intencję Dialogflow wywoływaną przez zdarzenie actions_intent_DELIVERY_ADDRESS. Po wywołaniu przenieś je w realizację za pomocą biblioteki klienta:
Node.js
app.intent('Delivery Address Complete', (conv) => {
const arg = conv.arguments.get('DELIVERY_ADDRESS_VALUE');
if (arg && arg.userDecision ==='ACCEPTED') {
conv.data.location = arg.location;
conv.ask('Great, got your address! Now say "confirm transaction".');
conv.ask(new Suggestions('confirm transaction'));
} else {
conv.close('Transaction failed.');
}
});
Node.js
app.intent('actions.intent.DELIVERY_ADDRESS', (conv) => {
const arg = conv.arguments.get('DELIVERY_ADDRESS_VALUE');
if (arg && arg.userDecision ==='ACCEPTED') {
conv.data.location = arg.location;
conv.ask('Great, got your address! Now say "confirm transaction".');
conv.ask(new Suggestions('confirm transaction'));
} else {
conv.close('Transaction failed.');
}
});
Java
@ForIntent("Delivery Address Complete")
public ActionResponse deliveryAddressComplete(ActionRequest request) {
Argument deliveryAddressValue = request.getArgument("DELIVERY_ADDRESS_VALUE");
Location deliveryAddress = null;
if (deliveryAddressValue != null) {
Map<String, Object> map = deliveryAddressValue.getExtension();
if (map != null) {
String userDecision = (String) map.get("userDecision");
Location location = (Location) map.get("location");
deliveryAddress = userDecision != null && userDecision.equals("ACCEPTED") ? location : null;
}
}
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (deliveryAddress != null) {
// Cache delivery address in conversation data for later use
Map<String, Object> conversationData = request.getConversationData();
conversationData.put("location",
GSON_BUILDER.create().toJson(deliveryAddress, Location.class));
responseBuilder
.add("Great, got your address! Now say \"confirm transaction\".")
.addSuggestions(new String[] {
"confirm transaction"
});
} else {
responseBuilder.add("Transaction failed.").endConversation();
}
return responseBuilder.build();
}
Java
@ForIntent("actions.intent.DELIVERY_ADDRESS")
public ActionResponse deliveryAddressComplete(ActionRequest request) {
Argument deliveryAddressValue = request.getArgument("DELIVERY_ADDRESS_VALUE");
Location deliveryAddress = null;
if (deliveryAddressValue != null) {
Map<String, Object> map = deliveryAddressValue.getExtension();
if (map != null) {
String userDecision = (String) map.get("userDecision");
Location location = (Location) map.get("location");
deliveryAddress = userDecision != null && userDecision.equals("ACCEPTED") ? location : null;
}
}
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (deliveryAddress != null) {
// Cache delivery address in conversation data for later use
Map<String, Object> conversationData = request.getConversationData();
conversationData.put("location",
GSON_BUILDER.create().toJson(deliveryAddress, Location.class));
responseBuilder
.add("Great, got your address! Now say \"confirm transaction\".")
.addSuggestions(new String[] {
"confirm transaction"
});
} else {
responseBuilder.add("Transaction failed.").endConversation();
}
return responseBuilder.build();
}
JSON
{
"responseId": "58b0c305-b437-47ac-8593-4fb0122a19e6-594de0a7",
"queryResult": {
"queryText": "actions_intent_DELIVERY_ADDRESS",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentMessages": [
{
"text": {
"text": [
""
]
}
}
],
"outputContexts": [
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_intent_delivery_address",
"parameters": {
"DELIVERY_ADDRESS_VALUE": {
"@type": "type.googleapis.com/google.actions.v2.DeliveryAddressValue",
"userDecision": "ACCEPTED",
"location": {
"coordinates": {
"latitude": 37.432524,
"longitude": -122.098545
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
}
},
"text": "1600 AMPHITHEATRE PKWY"
}
}
],
"intent": {
"name": "projects/df-transactions/agent/intents/0be5d130-1760-4355-85e9-4dc01da8bf3c",
"displayName": "Delivery Address Complete"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"lastSeen": "2019-09-23T19:49:55Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy",
"type": "ACTIVE",
"conversationToken": "[]"
},
"inputs": [
{
"intent": "actions.intent.DELIVERY_ADDRESS",
"rawInputs": [
{
"query": "1600 AMPHITHEATRE PKWY"
}
],
"arguments": [
{
"name": "DELIVERY_ADDRESS_VALUE",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.DeliveryAddressValue",
"userDecision": "ACCEPTED",
"location": {
"coordinates": {
"latitude": 37.432524,
"longitude": -122.098545
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
}
}
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
}
]
}
},
"session": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy"
}
JSON
{
"user": {
"locale": "en-US",
"lastSeen": "2019-11-11T23:57:20Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGFwStZlYaQ9YT8rg9t_idVsxZrku1pUDrEbGSJmSUMatVdPwPEEQSCe1IwIBoN4sS4Weyn9pmgetEgbsWgw3JSvQmw",
"type": "ACTIVE",
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\"}}"
},
"inputs": [
{
"intent": "actions.intent.DELIVERY_ADDRESS",
"rawInputs": [
{
"inputType": "VOICE",
"query": "1600 AMPHITHEATRE PKWY"
}
],
"arguments": [
{
"name": "DELIVERY_ADDRESS_VALUE",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.DeliveryAddressValue",
"userDecision": "ACCEPTED",
"location": {
"coordinates": {
"latitude": 37.421578499999995,
"longitude": -122.0837816
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
}
}
},
{
"name": "text",
"rawText": "1600 AMPHITHEATRE PKWY",
"textValue": "1600 AMPHITHEATRE PKWY"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
}
]
}
2. Tworzenie zamówienia
Interfejs użytkownika
Po otrzymaniu potrzebnych informacji o użytkowniku możesz utworzyć środowisko składania koszyka, które pomoże mu złożyć zamówienie. W przypadku każdego akcji proces składania koszyka jest trochę inny, zależnie od produktu lub usługi.
Najbardziej podstawowa metoda montażu koszyka polega na tym, że użytkownik wybiera produkty z listy, aby dodać je do zamówienia. Możesz jednak tak zaprojektować rozmowę, aby uprościć korzystanie z niej. Możesz utworzyć funkcję składania koszyka, która pozwoli użytkownikowi ponownie zamówić ostatni zakup, używając prostego pytania typu „tak” lub „nie”. Możesz też pokazać użytkownikowi karuzelę lub listę najczęściej polecanych elementów.
Zalecamy stosowanie odpowiedzi rozszerzonych, aby wizualnie przedstawić opcje użytkownika, a także tak zaprojektować rozmowę, aby mógł utworzyć koszyk tylko za pomocą głosu. Sprawdzone metody i przykłady wysokiej jakości składania zamówień znajdziesz w wytycznych dotyczących projektowania transakcji.
realizację,
W trakcie rozmowy musisz zgromadzić produkty, które użytkownik chce kupić, a następnie utworzyć obiekt Order.
Order musi zawierać co najmniej:
buyerInfo– informacje o użytkowniku dokonującym zakupu.transactionMerchant– informacje o sprzedawcy, który złożył zamówienie.contents– rzeczywista zawartość zamówienia podana jakolineItems.priceAttributes– szczegóły ceny zamówienia, w tym jego łączny koszt z rabatami i podatkami.
Informacje o tworzeniu koszyka znajdziesz w dokumentacji odpowiedzi Order. Pamiętaj, że w zależności od zamówienia
może być konieczne dodanie innych pól.
Przykładowy kod poniżej pokazuje pełne zamówienie, z uwzględnieniem pól opcjonalnych:
Node.js
const order = {
createTime: '2019-09-24T18:00:00.877Z',
lastUpdateTime: '2019-09-24T18:00:00.877Z',
merchantOrderId: orderId, // A unique ID String for the order
userVisibleOrderId: orderId,
transactionMerchant: {
id: 'http://www.example.com',
name: 'Example Merchant',
},
contents: {
lineItems: [
{
id: 'LINE_ITEM_ID',
name: 'Pizza',
description: 'A four cheese pizza.',
priceAttributes: [
{
type: 'REGULAR',
name: 'Item Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 8990000,
},
taxIncluded: true,
},
{
type: 'TOTAL',
name: 'Total Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 9990000,
},
taxIncluded: true,
},
],
notes: [
'Extra cheese.',
],
purchase: {
quantity: 1,
unitMeasure: {
measure: 1,
unit: 'POUND',
},
itemOptions: [
{
id: 'ITEM_OPTION_ID',
name: 'Pepperoni',
prices: [
{
type: 'REGULAR',
state: 'ACTUAL',
name: 'Item Price',
amount: {
currencyCode: 'USD',
amountInMicros: 1000000,
},
taxIncluded: true,
},
{
type: 'TOTAL',
name: 'Total Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 1000000,
},
taxIncluded: true,
},
],
note: 'Extra pepperoni',
quantity: 1,
subOptions: [],
},
],
},
},
],
},
buyerInfo: {
email: 'janedoe@gmail.com',
firstName: 'Jane',
lastName: 'Doe',
displayName: 'Jane Doe',
},
priceAttributes: [
{
type: 'SUBTOTAL',
name: 'Subtotal',
state: 'ESTIMATE',
amount: {
currencyCode: 'USD',
amountInMicros: 9990000,
},
taxIncluded: true,
},
{
type: 'DELIVERY',
name: 'Delivery',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 2000000,
},
taxIncluded: true,
},
{
type: 'TAX',
name: 'Tax',
state: 'ESTIMATE',
amount: {
currencyCode: 'USD',
amountInMicros: 3780000,
},
taxIncluded: true,
},
{
type: 'TOTAL',
name: 'Total Price',
state: 'ESTIMATE',
amount: {
currencyCode: 'USD',
amountInMicros: 15770000,
},
taxIncluded: true,
},
],
followUpActions: [
{
type: 'VIEW_DETAILS',
title: 'View details',
openUrlAction: {
url: 'http://example.com',
},
},
{
type: 'CALL',
title: 'Call us',
openUrlAction: {
url: 'tel:+16501112222',
},
},
{
type: 'EMAIL',
title: 'Email us',
openUrlAction: {
url: 'mailto:person@example.com',
},
},
],
termsOfServiceUrl: 'http://www.example.com',
note: 'Sale event',
promotions: [
{
coupon: 'COUPON_CODE',
},
],
purchase: {
status: 'CREATED',
userVisibleStatusLabel: 'CREATED',
type: 'FOOD',
returnsInfo: {
isReturnable: false,
daysToReturn: 1,
policyUrl: 'http://www.example.com',
},
fulfillmentInfo: {
id: 'FULFILLMENT_SERVICE_ID',
fulfillmentType: 'DELIVERY',
expectedFulfillmentTime: {
timeIso8601: '2019-09-25T18:00:00.877Z',
},
location: location,
price: {
type: 'REGULAR',
name: 'Delivery Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 2000000,
},
taxIncluded: true,
},
fulfillmentContact: {
email: 'johnjohnson@gmail.com',
firstName: 'John',
lastName: 'Johnson',
displayName: 'John Johnson',
},
},
purchaseLocationType: 'ONLINE_PURCHASE',
},
};
Node.js
const order = {
createTime: '2019-09-24T18:00:00.877Z',
lastUpdateTime: '2019-09-24T18:00:00.877Z',
merchantOrderId: orderId, // A unique ID String for the order
userVisibleOrderId: orderId,
transactionMerchant: {
id: 'http://www.example.com',
name: 'Example Merchant',
},
contents: {
lineItems: [
{
id: 'LINE_ITEM_ID',
name: 'Pizza',
description: 'A four cheese pizza.',
priceAttributes: [
{
type: 'REGULAR',
name: 'Item Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 8990000,
},
taxIncluded: true,
},
{
type: 'TOTAL',
name: 'Total Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 9990000,
},
taxIncluded: true,
},
],
notes: [
'Extra cheese.',
],
purchase: {
quantity: 1,
unitMeasure: {
measure: 1,
unit: 'POUND',
},
itemOptions: [
{
id: 'ITEM_OPTION_ID',
name: 'Pepperoni',
prices: [
{
type: 'REGULAR',
state: 'ACTUAL',
name: 'Item Price',
amount: {
currencyCode: 'USD',
amountInMicros: 1000000,
},
taxIncluded: true,
},
{
type: 'TOTAL',
name: 'Total Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 1000000,
},
taxIncluded: true,
},
],
note: 'Extra pepperoni',
quantity: 1,
subOptions: [],
},
],
},
},
],
},
buyerInfo: {
email: 'janedoe@gmail.com',
firstName: 'Jane',
lastName: 'Doe',
displayName: 'Jane Doe',
},
priceAttributes: [
{
type: 'SUBTOTAL',
name: 'Subtotal',
state: 'ESTIMATE',
amount: {
currencyCode: 'USD',
amountInMicros: 9990000,
},
taxIncluded: true,
},
{
type: 'DELIVERY',
name: 'Delivery',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 2000000,
},
taxIncluded: true,
},
{
type: 'TAX',
name: 'Tax',
state: 'ESTIMATE',
amount: {
currencyCode: 'USD',
amountInMicros: 3780000,
},
taxIncluded: true,
},
{
type: 'TOTAL',
name: 'Total Price',
state: 'ESTIMATE',
amount: {
currencyCode: 'USD',
amountInMicros: 15770000,
},
taxIncluded: true,
},
],
followUpActions: [
{
type: 'VIEW_DETAILS',
title: 'View details',
openUrlAction: {
url: 'http://example.com',
},
},
{
type: 'CALL',
title: 'Call us',
openUrlAction: {
url: 'tel:+16501112222',
},
},
{
type: 'EMAIL',
title: 'Email us',
openUrlAction: {
url: 'mailto:person@example.com',
},
},
],
termsOfServiceUrl: 'http://www.example.com',
note: 'Sale event',
promotions: [
{
coupon: 'COUPON_CODE',
},
],
purchase: {
status: 'CREATED',
userVisibleStatusLabel: 'CREATED',
type: 'FOOD',
returnsInfo: {
isReturnable: false,
daysToReturn: 1,
policyUrl: 'http://www.example.com',
},
fulfillmentInfo: {
id: 'FULFILLMENT_SERVICE_ID',
fulfillmentType: 'DELIVERY',
expectedFulfillmentTime: {
timeIso8601: '2019-09-25T18:00:00.877Z',
},
location: location,
price: {
type: 'REGULAR',
name: 'Delivery Price',
state: 'ACTUAL',
amount: {
currencyCode: 'USD',
amountInMicros: 2000000,
},
taxIncluded: true,
},
fulfillmentContact: {
email: 'johnjohnson@gmail.com',
firstName: 'John',
lastName: 'Johnson',
displayName: 'John Johnson',
},
},
purchaseLocationType: 'ONLINE_PURCHASE',
},
};
Java
// Transaction Merchant
MerchantV3 transactionMerchant = new MerchantV3()
.setId("http://www.example.com")
.setName("Example Merchant");
// Line Item
PriceAttribute itemPrice = new PriceAttribute()
.setType("REGULAR")
.setName("Item Price")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(8990000L)
)
.setTaxIncluded(true);
PriceAttribute totalItemPrice = new PriceAttribute()
.setType("TOTAL")
.setName("Total Price")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(9990000L)
)
.setTaxIncluded(true);
// Purchase Item Extension
PurchaseItemExtension purchaseItemExtension = new PurchaseItemExtension()
.setQuantity(1)
.setUnitMeasure(new MerchantUnitMeasure()
.setMeasure(1.0)
.setUnit("POUND"))
.setItemOptions(Arrays.asList(new PurchaseItemExtensionItemOption()
.setId("ITEM_OPTION_ID")
.setName("Pepperoni")
.setPrices(Arrays.asList(
new PriceAttribute()
.setType("REGULAR")
.setState("ACTUAL")
.setName("Item Price")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(1000000L))
.setTaxIncluded(true),
new PriceAttribute()
.setType("TOTAL")
.setState("ACTUAL")
.setName("Total Price")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(1000000L))
.setTaxIncluded(true)
))
.setNote("Extra pepperoni")
.setQuantity(1)));
LineItemV3 lineItem = new LineItemV3()
.setId("LINE_ITEM_ID")
.setName("Pizza")
.setDescription("A four cheese pizza.")
.setPriceAttributes(Arrays.asList(itemPrice, totalItemPrice))
.setNotes(Collections.singletonList("Extra cheese."))
.setPurchase(purchaseItemExtension);
// Order Contents
OrderContents contents = new OrderContents()
.setLineItems(Collections.singletonList(lineItem));
// User Info
UserInfo buyerInfo = new UserInfo()
.setEmail("janedoe@gmail.com")
.setFirstName("Jane")
.setLastName("Doe")
.setDisplayName("Jane Doe");
// Price Attributes
PriceAttribute subTotal = new PriceAttribute()
.setType("SUBTOTAL")
.setName("Subtotal")
.setState("ESTIMATE")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(9990000L)
)
.setTaxIncluded(true);
PriceAttribute deliveryFee = new PriceAttribute()
.setType("DELIVERY")
.setName("Delivery")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(2000000L)
)
.setTaxIncluded(true);
PriceAttribute tax = new PriceAttribute()
.setType("TAX")
.setName("Tax")
.setState("ESTIMATE")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(3780000L)
)
.setTaxIncluded(true);
PriceAttribute totalPrice = new PriceAttribute()
.setType("TOTAL")
.setName("Total Price")
.setState("ESTIMATE")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(15770000L)
)
.setTaxIncluded(true);
// Follow up actions
Action viewDetails = new Action()
.setType("VIEW_DETAILS")
.setTitle("View details")
.setOpenUrlAction(new OpenUrlAction()
.setUrl("https://example.com"));
Action call = new Action()
.setType("CALL")
.setTitle("Call us")
.setOpenUrlAction(new OpenUrlAction()
.setUrl("tel:+16501112222"));
Action email = new Action()
.setType("EMAIL")
.setTitle("Email us")
.setOpenUrlAction(new OpenUrlAction()
.setUrl("mailto:person@example.com"));
// Terms of service and order note
String termsOfServiceUrl = "http://example.com";
String orderNote = "Sale event";
// Promotions
PromotionV3 promotion = new PromotionV3()
.setCoupon("COUPON_CODE");
// Purchase Order Extension
Location location = GSON_BUILDER.create().fromJson(
(String) conversationData.get("location"), Location.class);
PurchaseOrderExtension purchaseOrderExtension = new PurchaseOrderExtension()
.setStatus("CREATED")
.setUserVisibleStatusLabel("CREATED")
.setType("FOOD")
.setReturnsInfo(new PurchaseReturnsInfo()
.setIsReturnable(false)
.setDaysToReturn(1)
.setPolicyUrl("https://example.com"))
.setFulfillmentInfo(new PurchaseFulfillmentInfo()
.setId("FULFILLMENT_SERVICE_ID")
.setFulfillmentType("DELIVERY")
.setExpectedFulfillmentTime(new TimeV3()
.setTimeIso8601("2019-09-25T18:00:00.877Z"))
.setLocation(location)
.setPrice(new PriceAttribute()
.setType("REGULAR")
.setName("Delivery price")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(2000000L))
.setTaxIncluded(true))
.setFulfillmentContact(new UserInfo()
.setEmail("johnjohnson@gmail.com")
.setFirstName("John")
.setLastName("Johnson")
.setDisplayName("John Johnson")))
.setPurchaseLocationType("ONLINE_PURCHASE");
OrderV3 order = new OrderV3()
.setCreateTime("2019-09-24T18:00:00.877Z")
.setLastUpdateTime("2019-09-24T18:00:00.877Z")
.setMerchantOrderId(orderId)
.setUserVisibleOrderId(orderId)
.setTransactionMerchant(transactionMerchant)
.setContents(contents)
.setBuyerInfo(buyerInfo)
.setPriceAttributes(Arrays.asList(
subTotal,
deliveryFee,
tax,
totalPrice
))
.setFollowUpActions(Arrays.asList(
viewDetails,
call,
email
))
.setTermsOfServiceUrl(termsOfServiceUrl)
.setNote(orderNote)
.setPromotions(Collections.singletonList(promotion))
.setPurchase(purchaseOrderExtension);
Java
// Transaction Merchant
MerchantV3 transactionMerchant = new MerchantV3()
.setId("http://www.example.com")
.setName("Example Merchant");
// Line Item
PriceAttribute itemPrice = new PriceAttribute()
.setType("REGULAR")
.setName("Item Price")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(8990000L)
)
.setTaxIncluded(true);
PriceAttribute totalItemPrice = new PriceAttribute()
.setType("TOTAL")
.setName("Total Price")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(9990000L)
)
.setTaxIncluded(true);
// Purchase Item Extension
PurchaseItemExtension purchaseItemExtension = new PurchaseItemExtension()
.setUnitMeasure(new MerchantUnitMeasure()
.setMeasure(1.0)
.setUnit("POUND"))
.setItemOptions(Arrays.asList(new PurchaseItemExtensionItemOption()
.setId("ITEM_OPTION_ID")
.setName("Pepperoni")
.setPrices(Arrays.asList(
new PriceAttribute()
.setType("REGULAR")
.setState("ACTUAL")
.setName("Item Price")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(1000000L))
.setTaxIncluded(true),
new PriceAttribute()
.setType("TOTAL")
.setState("ACTUAL")
.setName("Total Price")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(1000000L))
.setTaxIncluded(true)
))
.setNote("Extra pepperoni")));
LineItemV3 lineItem = new LineItemV3()
.setId("LINE_ITEM_ID")
.setName("Pizza")
.setDescription("A four cheese pizza.")
.setPriceAttributes(Arrays.asList(itemPrice, totalItemPrice))
.setNotes(Collections.singletonList("Extra cheese."))
.setPurchase(purchaseItemExtension);
// Order Contents
OrderContents contents = new OrderContents()
.setLineItems(Collections.singletonList(lineItem));
// User Info
UserInfo buyerInfo = new UserInfo()
.setEmail("janedoe@gmail.com")
.setFirstName("Jane")
.setLastName("Doe")
.setDisplayName("Jane Doe");
// Price Attributes
PriceAttribute subTotal = new PriceAttribute()
.setType("SUBTOTAL")
.setName("Subtotal")
.setState("ESTIMATE")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(9990000L)
)
.setTaxIncluded(true);
PriceAttribute deliveryFee = new PriceAttribute()
.setType("DELIVERY")
.setName("Delivery")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(2000000L)
)
.setTaxIncluded(true);
PriceAttribute tax = new PriceAttribute()
.setType("TAX")
.setName("Tax")
.setState("ESTIMATE")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(3780000L)
)
.setTaxIncluded(true);
PriceAttribute totalPrice = new PriceAttribute()
.setType("TOTAL")
.setName("Total Price")
.setState("ESTIMATE")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(15770000L)
)
.setTaxIncluded(true);
// Follow up actions
Action viewDetails = new Action()
.setType("VIEW_DETAILS")
.setTitle("View details")
.setOpenUrlAction(new OpenUrlAction()
.setUrl("https://example.com"));
Action call = new Action()
.setType("CALL")
.setTitle("Call us")
.setOpenUrlAction(new OpenUrlAction()
.setUrl("tel:+16501112222"));
Action email = new Action()
.setType("EMAIL")
.setTitle("Email us")
.setOpenUrlAction(new OpenUrlAction()
.setUrl("mailto:person@example.com"));
// Terms of service and order note
String termsOfServiceUrl = "http://example.com";
String orderNote = "Sale event";
// Promotions
PromotionV3 promotion = new PromotionV3()
.setCoupon("COUPON_CODE");
// Purchase Order Extension
Location location = GSON_BUILDER.create().fromJson(
(String) conversationData.get("location"), Location.class);
PurchaseOrderExtension purchaseOrderExtension = new PurchaseOrderExtension()
.setStatus("CREATED")
.setUserVisibleStatusLabel("CREATED")
.setType("FOOD")
.setReturnsInfo(new PurchaseReturnsInfo()
.setIsReturnable(false)
.setDaysToReturn(1)
.setPolicyUrl("https://example.com"))
.setFulfillmentInfo(new PurchaseFulfillmentInfo()
.setId("FULFILLMENT_SERVICE_ID")
.setFulfillmentType("DELIVERY")
.setExpectedFulfillmentTime(new TimeV3()
.setTimeIso8601("2019-09-25T18:00:00.877Z"))
.setLocation(location)
.setPrice(new PriceAttribute()
.setType("REGULAR")
.setName("Delivery price")
.setState("ACTUAL")
.setAmount(new MoneyV3()
.setCurrencyCode("USD")
.setAmountInMicros(2000000L))
.setTaxIncluded(true))
.setFulfillmentContact(new UserInfo()
.setEmail("johnjohnson@gmail.com")
.setFirstName("John")
.setLastName("Johnson")
.setDisplayName("John Johnson")))
.setPurchaseLocationType("ONLINE_PURCHASE");
OrderV3 order = new OrderV3()
.setCreateTime("2019-09-24T18:00:00.877Z")
.setLastUpdateTime("2019-09-24T18:00:00.877Z")
.setMerchantOrderId(orderId)
.setUserVisibleOrderId(orderId)
.setTransactionMerchant(transactionMerchant)
.setContents(contents)
.setBuyerInfo(buyerInfo)
.setPriceAttributes(Arrays.asList(
subTotal,
deliveryFee,
tax,
totalPrice
))
.setFollowUpActions(Arrays.asList(
viewDetails,
call,
email
))
.setTermsOfServiceUrl(termsOfServiceUrl)
.setNote(orderNote)
.setPromotions(Collections.singletonList(promotion))
.setPurchase(purchaseOrderExtension);
3. Zaproponuj zamówienie
Po utworzeniu zamówienia musisz przedstawić je użytkownikowi, aby mógł je potwierdzić lub odrzucić. Poproś o zamiar actions.intent.TRANSACTION_DECISION i prześlij utworzony zamówienie.
Zadowolenie użytkowników
Gdy poprosisz o intencję actions.intent.TRANSACTION_DECISION, Asystent inicjuje wbudowane środowisko, w którym przekazany przez Ciebie Order jest renderowany bezpośrednio na „karcie podglądu koszyka”. Użytkownik może powiedzieć „Złóż zamówienie”,
odrzucić transakcję, zmienić opcję płatności, np. kartę kredytową lub adres, albo poprosić o zmianę zawartości zamówienia.
W tym momencie użytkownik może też poprosić o zmianę zamówienia. W takim przypadku musisz upewnić się, że po zakończeniu składania zamówienia Twoja realizacja może obsługiwać prośby o zmianę zamówienia.
realizację,
Gdy poprosisz o intencję actions.intent.TRANSACTION_DECISION, utworzysz TransactionDecision, który będzie zawierał: Order oraz orderOptions i paymentParameters.
Obiekt paymentParameters będzie zawierał parametry tokenizacji, które zmieniają się w zależności od firmy obsługującej Google Pay, z której zamierzasz korzystać (np. Stripe, Braintree, ACI itp.).
Poniżej znajduje się przykładowy kod TransactionsDecision zamówienia:
Node.js
conv.ask(new TransactionDecision({
orderOptions: {
userInfoOptions: {
userInfoProperties: [
'EMAIL',
],
},
},
paymentParameters: {
googlePaymentOption: {
// facilitationSpec is expected to be a serialized JSON string
facilitationSpec: JSON.stringify({
apiVersion: 2,
apiVersionMinor: 0,
merchantInfo: {
merchantName: 'Example Merchant',
},
allowedPaymentMethods: [
{
type: 'CARD',
parameters: {
allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
allowedCardNetworks: [
'AMEX', 'DISCOVER', 'JCB', 'MASTERCARD', 'VISA'],
},
tokenizationSpecification: {
type: 'PAYMENT_GATEWAY',
parameters: {
gateway: 'example',
gatewayMerchantId: 'exampleGatewayMerchantId',
},
},
},
],
transactionInfo: {
totalPriceStatus: 'FINAL',
totalPrice: '15.77',
currencyCode: 'USD',
},
}),
},
},
presentationOptions: {
actionDisplayName: 'PLACE_ORDER',
},
order: order,
}));
Node.js
conv.ask(new TransactionDecision({
orderOptions: {
userInfoOptions: {
userInfoProperties: [
'EMAIL',
],
},
},
paymentParameters: {
googlePaymentOption: {
// facilitationSpec is expected to be a serialized JSON string
facilitationSpec: JSON.stringify({
apiVersion: 2,
apiVersionMinor: 0,
merchantInfo: {
merchantName: 'Example Merchant',
},
allowedPaymentMethods: [
{
type: 'CARD',
parameters: {
allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
allowedCardNetworks: [
'AMEX', 'DISCOVER', 'JCB', 'MASTERCARD', 'VISA'],
},
tokenizationSpecification: {
type: 'PAYMENT_GATEWAY',
parameters: {
gateway: 'example',
gatewayMerchantId: 'exampleGatewayMerchantId',
},
},
},
],
transactionInfo: {
totalPriceStatus: 'FINAL',
totalPrice: '15.77',
currencyCode: 'USD',
},
}),
},
},
presentationOptions: {
actionDisplayName: 'PLACE_ORDER',
},
order: order,
}));
Java
// Create order options
OrderOptionsV3 orderOptions = new OrderOptionsV3()
.setUserInfoOptions(new UserInfoOptions()
.setUserInfoProperties(Collections.singletonList("EMAIL")));
// Create presentation options
PresentationOptionsV3 presentationOptions = new PresentationOptionsV3()
.setActionDisplayName("PLACE_ORDER");
// Create payment parameters
JSONObject merchantInfo = new JSONObject();
merchantInfo.put("merchantName", "Example Merchant");
JSONObject facilitationSpec = new JSONObject();
facilitationSpec.put("apiVersion", 2);
facilitationSpec.put("apiVersionMinor", 0);
facilitationSpec.put("merchantInfo", merchantInfo);
JSONObject allowedPaymentMethod = new JSONObject();
allowedPaymentMethod.put("type", "CARD");
JSONArray allowedAuthMethods = new JSONArray();
allowedAuthMethods.addAll(Arrays.asList("PAN_ONLY", "CRYPTOGRAM_3DS"));
JSONArray allowedCardNetworks = new JSONArray();
allowedCardNetworks.addAll(Arrays.asList("AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"));
JSONObject allowedPaymentMethodParameters = new JSONObject();
allowedPaymentMethodParameters.put("allowedAuthMethods", allowedAuthMethods);
allowedPaymentMethodParameters.put("allowedCardNetworks", allowedCardNetworks);
allowedPaymentMethod.put("parameters", allowedPaymentMethodParameters);
JSONObject tokenizationSpecificationParameters = new JSONObject();
tokenizationSpecificationParameters.put("gateway", "example");
tokenizationSpecificationParameters.put("gatewayMerchantId", "exampleGatewayMerchantId");
JSONObject tokenizationSpecification = new JSONObject();
tokenizationSpecification.put("type", "PAYMENT_GATEWAY");
tokenizationSpecification.put("parameters", tokenizationSpecificationParameters);
allowedPaymentMethod.put("tokenizationSpecification", tokenizationSpecification);
JSONArray allowedPaymentMethods = new JSONArray();
allowedPaymentMethods.add(allowedPaymentMethod);
facilitationSpec.put("allowedPaymentMethods", allowedPaymentMethods);
JSONObject transactionInfo = new JSONObject();
transactionInfo.put("totalPriceStatus", "FINAL");
transactionInfo.put("totalPrice", "15.77");
transactionInfo.put("currencyCode", "USD");
facilitationSpec.put("transactionInfo", transactionInfo);
GooglePaymentOption googlePaymentOption = new GooglePaymentOption()
.setFacilitationSpec(facilitationSpec.toJSONString());
paymentParameters.setGooglePaymentOption(googlePaymentOption);
return getResponseBuilder(request)
.add(new TransactionDecision()
.setOrder(order)
.setOrderOptions(orderOptions)
.setPresentationOptions(presentationOptions)
.setPaymentParameters(paymentParameters)
)
.build();
Java
// Create order options
OrderOptionsV3 orderOptions = new OrderOptionsV3()
.setUserInfoOptions(new UserInfoOptions()
.setUserInfoProperties(Collections.singletonList("EMAIL")));
// Create presentation options
PresentationOptionsV3 presentationOptions = new PresentationOptionsV3()
.setActionDisplayName("PLACE_ORDER");
// Create payment parameters
JSONObject merchantInfo = new JSONObject();
merchantInfo.put("merchantName", "Example Merchant");
JSONObject facilitationSpec = new JSONObject();
facilitationSpec.put("apiVersion", 2);
facilitationSpec.put("apiVersionMinor", 0);
facilitationSpec.put("merchantInfo", merchantInfo);
JSONObject allowedPaymentMethod = new JSONObject();
allowedPaymentMethod.put("type", "CARD");
JSONArray allowedAuthMethods = new JSONArray();
allowedAuthMethods.addAll(Arrays.asList("PAN_ONLY", "CRYPTOGRAM_3DS"));
JSONArray allowedCardNetworks = new JSONArray();
allowedCardNetworks.addAll(Arrays.asList("AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"));
JSONObject allowedPaymentMethodParameters = new JSONObject();
allowedPaymentMethodParameters.put("allowedAuthMethods", allowedAuthMethods);
allowedPaymentMethodParameters.put("allowedCardNetworks", allowedCardNetworks);
allowedPaymentMethod.put("parameters", allowedPaymentMethodParameters);
JSONObject tokenizationSpecificationParameters = new JSONObject();
tokenizationSpecificationParameters.put("gateway", "example");
tokenizationSpecificationParameters.put("gatewayMerchantId", "exampleGatewayMerchantId");
JSONObject tokenizationSpecification = new JSONObject();
tokenizationSpecification.put("type", "PAYMENT_GATEWAY");
tokenizationSpecification.put("parameters", tokenizationSpecificationParameters);
allowedPaymentMethod.put("tokenizationSpecification", tokenizationSpecification);
JSONArray allowedPaymentMethods = new JSONArray();
allowedPaymentMethods.add(allowedPaymentMethod);
facilitationSpec.put("allowedPaymentMethods", allowedPaymentMethods);
JSONObject transactionInfo = new JSONObject();
transactionInfo.put("totalPriceStatus", "FINAL");
transactionInfo.put("totalPrice", "15.77");
transactionInfo.put("currencyCode", "USD");
facilitationSpec.put("transactionInfo", transactionInfo);
GooglePaymentOption googlePaymentOption = new GooglePaymentOption()
.setFacilitationSpec(facilitationSpec.toJSONString());
paymentParameters.setGooglePaymentOption(googlePaymentOption);
return getResponseBuilder(request)
.add(new TransactionDecision()
.setOrder(order)
.setOrderOptions(orderOptions)
.setPresentationOptions(presentationOptions)
.setPaymentParameters(paymentParameters)
)
.build();
JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Transaction Decision Placeholder."
}
}
]
},
"systemIntent": {
"intent": "actions.intent.TRANSACTION_DECISION",
"data": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec",
"orderOptions": {
"userInfoOptions": {
"userInfoProperties": [
"EMAIL"
]
}
},
"paymentParameters": {
"merchantPaymentOption": {
"defaultMerchantPaymentMethodId": "12345678",
"managePaymentMethodUrl": "https://example.com/managePayment",
"merchantPaymentMethod": [
{
"paymentMethodDisplayInfo": {
"paymentMethodDisplayName": "VISA **** 1234",
"paymentType": "PAYMENT_CARD"
},
"paymentMethodGroup": "Payment method group",
"paymentMethodId": "12345678",
"paymentMethodStatus": {
"status": "STATUS_OK",
"statusMessage": "Status message"
}
}
]
}
},
"presentationOptions": {
"actionDisplayName": "PLACE_ORDER"
},
"order": {
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T18:00:00.877Z",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"description": "A four cheese pizza.",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 8990000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
}
],
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"unitMeasure": {
"measure": 1,
"unit": "POUND"
},
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"state": "ACTUAL",
"name": "Item Price",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1,
"subOptions": []
}
]
}
}
]
},
"buyerInfo": {
"email": "janedoe@gmail.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 3780000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 15770000
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "http://www.example.com",
"note": "Sale event",
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CREATED",
"userVisibleStatusLabel": "CREATED",
"type": "FOOD",
"returnsInfo": {
"isReturnable": false,
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"city": "MOUNTAIN VIEW",
"coordinates": {
"latitude": 37.432524,
"longitude": -122.098545
},
"phoneNumber": "+1 123-456-7890",
"postalAddress": {
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"postalCode": "94043-1351",
"recipients": [
"John Doe"
],
"regionCode": "US"
},
"zipCode": "94043-1351"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE"
}
}
}
}
}
},
"outputContexts": [
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/_actions_on_google",
"lifespanCount": 99,
"parameters": {
"data": "{\"location\":{\"coordinates\":{\"latitude\":37.432524,\"longitude\":-122.098545},\"zipCode\":\"94043-1351\",\"city\":\"MOUNTAIN VIEW\",\"postalAddress\":{\"regionCode\":\"US\",\"postalCode\":\"94043-1351\",\"administrativeArea\":\"CA\",\"locality\":\"MOUNTAIN VIEW\",\"addressLines\":[\"1600 AMPHITHEATRE PKWY\"],\"recipients\":[\"John Doe\"]},\"phoneNumber\":\"+1 123-456-7890\"},\"latestOrderId\":\"ORDER_ID\"}"
}
}
]
}
JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.TRANSACTION_DECISION",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec",
"orderOptions": {
"userInfoOptions": {
"userInfoProperties": [
"EMAIL"
]
}
},
"paymentParameters": {
"merchantPaymentOption": {
"defaultMerchantPaymentMethodId": "12345678",
"managePaymentMethodUrl": "https://example.com/managePayment",
"merchantPaymentMethod": [
{
"paymentMethodDisplayInfo": {
"paymentMethodDisplayName": "VISA **** 1234",
"paymentType": "PAYMENT_CARD"
},
"paymentMethodGroup": "Payment method group",
"paymentMethodId": "12345678",
"paymentMethodStatus": {
"status": "STATUS_OK",
"statusMessage": "Status message"
}
}
]
}
},
"presentationOptions": {
"actionDisplayName": "PLACE_ORDER"
},
"order": {
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T18:00:00.877Z",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"description": "A four cheese pizza.",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 8990000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
}
],
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"unitMeasure": {
"measure": 1,
"unit": "POUND"
},
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"state": "ACTUAL",
"name": "Item Price",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1,
"subOptions": []
}
]
}
}
]
},
"buyerInfo": {
"email": "janedoe@gmail.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 3780000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 15770000
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "http://www.example.com",
"note": "Sale event",
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CREATED",
"userVisibleStatusLabel": "CREATED",
"type": "FOOD",
"returnsInfo": {
"isReturnable": false,
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"coordinates": {
"latitude": 37.421578499999995,
"longitude": -122.0837816
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE"
}
}
}
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Transaction Decision Placeholder."
}
}
]
}
}
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\",\"location\":{\"coordinates\":{\"latitude\":37.421578499999995,\"longitude\":-122.0837816},\"zipCode\":\"94043-1351\",\"city\":\"MOUNTAIN VIEW\",\"postalAddress\":{\"regionCode\":\"US\",\"postalCode\":\"94043-1351\",\"administrativeArea\":\"CA\",\"locality\":\"MOUNTAIN VIEW\",\"addressLines\":[\"1600 AMPHITHEATRE PKWY\"],\"recipients\":[\"John Doe\"]},\"phoneNumber\":\"+1 123-456-7890\"},\"latestOrderId\":\"ORDER_ID\"}}"
}
Zawartość obiektu tokenizationSpecification jest inna w przypadku każdej bramy płatności. W tabeli poniżej znajdziesz parametry używane przez każdą bramę:
"parameters": {
"gateway": "example",
"gatewayMerchantId": "exampleGatewayMerchantId"
}
"parameters": {
"gateway": "aciworldwide",
"gatewayMerchantId": "YOUR_ENTITY_ID"
}
"parameters": {
"gateway": "adyen",
"gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME"
}
"parameters": {
"gateway": "alfabank",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "bluemedia",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "bluesnap",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "braintree",
"braintree:apiVersion": "v1",
"braintree:sdkVersion": braintree.client.VERSION,
"braintree:merchantId": "YOUR_BRAINTREE_MERCHANT_ID",
"braintree:clientKey": "YOUR_BRAINTREE_TOKENIZATION_KEY"
}
"parameters": {
"gateway": "chase",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ACCOUNT_NUMBER"
}
"parameters": {
"gateway": "checkoutltd",
"gatewayMerchantId": "YOUR_PUBLIC_KEY"
}
"parameters": {
"gateway": "cloudpayments",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "cybersource",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "datatrans",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "ebanx",
"gatewayMerchantId": "YOUR_PUBLIC_INTEGRATION_KEY"
}
"parameters": {
"gateway": "firstdata",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "globalpayments",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "gopay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "hitrustpay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "imsolutions",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "lyra",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "mpgs",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "moneymailru",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "newebpay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "nexi",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "creditcall",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "paysafe",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "payture",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "payu",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "przelewy24",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "rbkmoney",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "sberbank",
"gatewayMerchantId": "YOUR_ORGANIZATION_NAME"
}
"parameters": {
"gateway": "square",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "stripe",
"stripe:version": "2018-10-31",
"stripe:publishableKey": "YOUR_PUBLIC_STRIPE_KEY"
}
"parameters": {
"gateway": "tappay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "tinkoff",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "uniteller",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "vantiv",
"vantiv:merchantPayPageId": "YOUR_PAY_PAGE_ID",
"vantiv:merchantOrderId": "YOUR_ORDER_ID",
"vantiv:merchantTransactionId": "YOUR_TRANSACTION_ID",
"vantiv:merchantReportGroup": "*web"
}
"parameters": {
"gateway": "worldpay",
"gatewayMerchantId": "YOUR_WORLDPAY_MERCHANT_ID"
}
"parameters": {
"gateway": "yandexcheckout",
"gatewayMerchantId": "YOUR_SHOP_ID"
}
Podejmowanie decyzji użytkownika
Gdy Asystent zrealizuje intencję, wysyła realizację żądania z intencją actions_intent_TRANSACTION_DECISION z odpowiedzią użytkownika na decyzję o transakcji. Otrzymasz Argument z wartością TransactionDecisionValue. Ta wartość będzie zawierać:
transactionDecision– decyzja użytkownika dotycząca proponowanego zamówienia. Możliwe wartości toORDER_ACCEPTED,ORDER_REJECTED,DELIVERY_ADDRESS_UPDATED,CART_CHANGE_REQUESTEDorazUSER_CANNOT_TRANSACT.deliveryAddress– zaktualizowany adres dostawy w przypadku zmiany adresu dostawy przez użytkownika. W tym przypadku wartościątransactionDecisionbędzieDELIVERY_ADDRESS_UPDATED.
Aby prawidłowo obsługiwać to żądanie, zadeklaruj intencję Dialogflow wywoływaną przez zdarzenie actions_intent_TRANSACTION_DECISION. Po wywołaniu wpisz je w realizacji:
Node.js
const arg = conv.arguments.get('TRANSACTION_DECISION_VALUE');
if (arg && arg.transactionDecision === 'ORDER_ACCEPTED') {
console.log('Order accepted.');
const order = arg.order;
}
Node.js
const arg = conv.arguments.get('TRANSACTION_DECISION_VALUE');
if (arg && arg.transactionDecision === 'ORDER_ACCEPTED') {
console.log('Order accepted.');
const order = arg.order;
}
Java
// Check transaction decision value
Argument transactionDecisionValue = request
.getArgument("TRANSACTION_DECISION_VALUE");
Map<String, Object> extension = null;
if (transactionDecisionValue != null) {
extension = transactionDecisionValue.getExtension();
}
String transactionDecision = null;
if (extension != null) {
transactionDecision = (String) extension.get("transactionDecision");
}
ResponseBuilder responseBuilder = getResponseBuilder(request);
if ((transactionDecision != null && transactionDecision.equals("ORDER_ACCEPTED"))) {
OrderV3 order = ((OrderV3) extension.get("order"));
}
Java
// Check transaction decision value
Argument transactionDecisionValue = request
.getArgument("TRANSACTION_DECISION_VALUE");
Map<String, Object> extension = null;
if (transactionDecisionValue != null) {
extension = transactionDecisionValue.getExtension();
}
String transactionDecision = null;
if (extension != null) {
transactionDecision = (String) extension.get("transactionDecision");
}
ResponseBuilder responseBuilder = getResponseBuilder(request);
if ((transactionDecision != null && transactionDecision.equals("ORDER_ACCEPTED"))) {
OrderV3 order = ((OrderV3) extension.get("order"));
}
JSON
{
"responseId": "aba44717-4236-4602-af55-e5ae1fc2d97a-594de0a7",
"queryResult": {
"queryText": "actions_intent_TRANSACTION_DECISION",
"action": "transaction.decision.complete",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentText": "Failed to get transaction decision",
"fulfillmentMessages": [
{
"text": {
"text": [
"Failed to get transaction decision"
]
}
}
],
"outputContexts": [
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_media_response_audio"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_audio_output"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_account_linking"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_screen_output"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/google_assistant_input_type_voice"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/_actions_on_google",
"lifespanCount": 97,
"parameters": {
"data": "{\"location\":{\"coordinates\":{\"latitude\":37.432524,\"longitude\":-122.098545},\"zipCode\":\"94043-1351\",\"city\":\"MOUNTAIN VIEW\",\"postalAddress\":{\"regionCode\":\"US\",\"postalCode\":\"94043-1351\",\"administrativeArea\":\"CA\",\"locality\":\"MOUNTAIN VIEW\",\"addressLines\":[\"1600 AMPHITHEATRE PKWY\"],\"recipients\":[\"John Doe\"]},\"phoneNumber\":\"+1 123-456-7890\"}}"
}
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_intent_transaction_decision",
"parameters": {
"TRANSACTION_DECISION_VALUE": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValue",
"transactionDecision": "ORDER_ACCEPTED",
"order": {
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T18:00:00.877Z",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"description": "A four cheese pizza.",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Line Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 8990000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
}
],
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"unitMeasure": {
"measure": 1,
"unit": "POUND"
},
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"state": "ACTUAL",
"name": "Item Price",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1,
"subOptions": []
}
]
}
}
]
},
"buyerInfo": {
"email": "janedoe@gmail.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 3780000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 15770000
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "www.example.com",
"note": "Sale event",
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CREATED",
"userVisibleStatusLabel": "CREATED",
"type": "FOOD",
"returnsInfo": {
"isReturnable": false,
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE"
}
}
},
"text": ""
}
}
],
"intent": {
"name": "projects/df-transactions/agent/intents/fd16d86b-60db-4d19-a683-5b52a22f4795",
"displayName": "Transaction Decision Complete"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"lastSeen": "2019-09-23T19:49:32Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy",
"type": "ACTIVE",
"conversationToken": "[\"merchant_payment\"]"
},
"inputs": [
{
"intent": "actions.intent.TRANSACTION_DECISION",
"rawInputs": [
{
"inputType": "KEYBOARD"
}
],
"arguments": [
{
"name": "TRANSACTION_DECISION_VALUE",
"extension": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValue",
"transactionDecision": "ORDER_ACCEPTED",
"order": {
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T19:00:00.877Z",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"description": "A four cheese pizza.",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Line Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 8990000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
}
],
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"unitMeasure": {
"measure": 1,
"unit": "POUND"
},
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"state": "ACTUAL",
"name": "Item Price",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1,
"subOptions": []
}
]
}
}
]
},
"buyerInfo": {
"email": "janedoe@gmail.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 3780000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 15770000
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "www.example.com",
"note": "Sale event",
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CREATED",
"userVisibleStatusLabel": "CREATED",
"type": "FOOD",
"returnsInfo": {
"isReturnable": false,
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE"
}
}
}
},
{
"name": "text"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
}
]
}
},
"session": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy"
}
JSON
{
"user": {
"locale": "en-US",
"lastSeen": "2019-11-11T23:57:31Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGFwStZlYaQ9YT8rg9t_idVsxZrku1pUDrEbGSJmSUMatVdPwPEEQSCe1IwIBoN4sS4Weyn9pmgetEgbsWgw3JSvQmw",
"type": "ACTIVE",
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\",\"location\":{\"coordinates\":{\"latitude\":37.421578499999995,\"longitude\":-122.0837816},\"zipCode\":\"94043-1351\",\"city\":\"MOUNTAIN VIEW\",\"postalAddress\":{\"regionCode\":\"US\",\"postalCode\":\"94043-1351\",\"administrativeArea\":\"CA\",\"locality\":\"MOUNTAIN VIEW\",\"addressLines\":[\"1600 AMPHITHEATRE PKWY\"],\"recipients\":[\"John Doe\"]},\"phoneNumber\":\"+1 123-456-7890\"},\"latestOrderId\":\"ORDER_ID\"}}"
},
"inputs": [
{
"intent": "actions.intent.TRANSACTION_DECISION",
"rawInputs": [
{}
],
"arguments": [
{
"name": "TRANSACTION_DECISION_VALUE",
"extension": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValue",
"transactionDecision": "ORDER_ACCEPTED",
"order": {
"googleOrderId": "05528125187071048269",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"buyerInfo": {
"email": "janedoe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T18:00:00.877Z",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "8990000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "9990000"
},
"taxIncluded": true
}
],
"description": "A four cheese pizza.",
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1
}
],
"unitMeasure": {
"measure": 1,
"unit": "POUND"
}
},
"vertical": {
"@type": "type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseItemExtension",
"quantity": 1,
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1
}
],
"unitMeasure": {
"measure": 1,
"unit": "POUND"
}
}
}
]
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": "9990000"
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "2000000"
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": "3780000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": "15770000"
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "http://www.example.com",
"note": "Sale event",
"paymentData": {
"paymentResult": {
"merchantPaymentMethodId": "12345678"
},
"paymentInfo": {
"paymentMethodDisplayInfo": {
"paymentType": "PAYMENT_CARD",
"paymentMethodDisplayName": "VISA **** 1234"
},
"paymentMethodProvenance": "PAYMENT_METHOD_PROVENANCE_MERCHANT"
}
},
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CREATED",
"type": "FOOD",
"returnsInfo": {
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"coordinates": {
"latitude": 37.421578499999995,
"longitude": -122.0837816
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "2000000"
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE",
"userVisibleStatusLabel": "CREATED"
},
"vertical": {
"@type": "type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension",
"status": "CREATED",
"type": "FOOD",
"returnsInfo": {
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"coordinates": {
"latitude": 37.421578499999995,
"longitude": -122.0837816
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "2000000"
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE",
"userVisibleStatusLabel": "CREATED"
}
}
}
},
{
"name": "text"
}
]
}
],
"surface": {
"capabilities": [
{
"name": "actions.capability.AUDIO_OUTPUT"
},
{
"name": "actions.capability.MEDIA_RESPONSE_AUDIO"
},
{
"name": "actions.capability.ACCOUNT_LINKING"
},
{
"name": "actions.capability.SCREEN_OUTPUT"
}
]
},
"availableSurfaces": [
{
"capabilities": [
{
"name": "actions.capability.SCREEN_OUTPUT"
},
{
"name": "actions.capability.WEB_BROWSER"
},
{
"name": "actions.capability.AUDIO_OUTPUT"
}
]
}
]
}
4. Sfinalizuj zamówienie i wyślij potwierdzenie
Gdy intencja actions.intent.TRANSACTION_DECISION zwraca intencję transactionDecision o wartości ORDER_ACCEPTED, musisz od razu wykonać czynności wymagane do potwierdzenia zamówienia (np. zachować je w Twojej bazie danych i obciążyć użytkownika).
Możesz zakończyć rozmowę tą odpowiedzią, ale musisz dołączyć prostą odpowiedź, aby ją utrzymać. Gdy podasz tę początkową kwotę orderUpdate, użytkownik zobaczy zwiniętą kartę potwierdzenia wraz z resztą Twojej odpowiedzi.
Ta karta będzie odzwierciedlać potwierdzenie, które użytkownik znalazł w swojej historii zamówień.
W trakcie potwierdzenia zamówienia obiekt zamówienia może zawierać userVisibleOrderId, czyli identyfikator, który widzi użytkownik. Możesz ponownie użyć w tym polu pola merchantOrderId.
Część obiektu OrderUpdate musi zawierać obiekt kontrolny action, który będzie się wyświetlać jako przyciski adresu URL na dole szczegółów zamówienia, które użytkownik może znaleźć w historii zamówień Asystenta.
realizację,
Node.js
// Set lastUpdateTime and update status of order
const order = arg.order;
order.lastUpdateTime = '2019-09-24T19:00:00.877Z';
order.purchase.status = 'CONFIRMED';
order.purchase.userVisibleStatusLabel = 'Order confirmed';
// Send synchronous order update
conv.ask(`Transaction completed! Your order`
+ ` ${conv.data.latestOrderId} is all set!`);
conv.ask(new Suggestions('send order update'));
conv.ask(new OrderUpdate({
type: 'SNAPSHOT',
reason: 'Reason string',
order: order,
}));
Node.js
// Set lastUpdateTime and update status of order
const order = arg.order;
order.lastUpdateTime = '2019-09-24T19:00:00.877Z';
order.purchase.status = 'CONFIRMED';
order.purchase.userVisibleStatusLabel = 'Order confirmed';
// Send synchronous order update
conv.ask(`Transaction completed! Your order `
+ `${conv.data.latestOrderId} is all set!`);
conv.ask(new Suggestions('send order update'));
conv.ask(new OrderUpdate({
type: 'SNAPSHOT',
reason: 'Reason string',
order: order,
}));
Java
OrderV3 order = ((OrderV3) extension.get("order"));
order.setLastUpdateTime("2019-09-24T19:00:00.877Z");
// Update order status
PurchaseOrderExtension purchaseOrderExtension = order.getPurchase();
purchaseOrderExtension.setStatus("CONFIRMED");
purchaseOrderExtension.setUserVisibleStatusLabel("Order confirmed");
order.setPurchase(purchaseOrderExtension);
// Order update
OrderUpdateV3 orderUpdate = new OrderUpdateV3()
.setType("SNAPSHOT")
.setReason("Reason string")
.setOrder(order);
Map<String, Object> conversationData = request.getConversationData();
String orderId = (String) conversationData.get("latestOrderId");
responseBuilder
.add("Transaction completed! Your order " + orderId + " is all set!")
.addSuggestions(new String[] {"send order update"})
.add(new StructuredResponse().setOrderUpdateV3(orderUpdate));
Java
OrderV3 order = ((OrderV3) extension.get("order"));
order.setLastUpdateTime("2019-09-24T19:00:00.877Z");
// Update order status
PurchaseOrderExtension purchaseOrderExtension = order.getPurchase();
purchaseOrderExtension.setStatus("CONFIRMED");
purchaseOrderExtension.setUserVisibleStatusLabel("Order confirmed");
order.setPurchase(purchaseOrderExtension);
// Order update
OrderUpdateV3 orderUpdate = new OrderUpdateV3()
.setType("SNAPSHOT")
.setReason("Reason string")
.setOrder(order);
Map<String, Object> conversationData = request.getConversationData();
String orderId = (String) conversationData.get("latestOrderId");
responseBuilder
.add("Transaction completed! Your order " + orderId + " is all set!")
.addSuggestions(new String[] {"send order update"})
.add(new StructuredResponse().setOrderUpdateV3(orderUpdate));
JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Transaction completed! Your order undefined is all set!"
}
},
{
"structuredResponse": {
"orderUpdateV3": {
"order": {
"buyerInfo": {
"displayName": "Jane Doe",
"email": "janedoe@gmail.com",
"firstName": "Jane",
"lastName": "Doe"
},
"contents": {
"lineItems": [
{
"description": "A four cheese pizza.",
"id": "LINE_ITEM_ID",
"name": "Pizza",
"notes": [
"Extra cheese."
],
"priceAttributes": [
{
"amount": {
"amountInMicros": 8990000,
"currencyCode": "USD"
},
"name": "Line Item Price",
"state": "ACTUAL",
"taxIncluded": true,
"type": "REGULAR"
},
{
"amount": {
"amountInMicros": 9990000,
"currencyCode": "USD"
},
"name": "Total Price",
"state": "ACTUAL",
"taxIncluded": true,
"type": "TOTAL"
}
],
"purchase": {
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"note": "Extra pepperoni",
"prices": [
{
"amount": {
"amountInMicros": 1000000,
"currencyCode": "USD"
},
"name": "Item Price",
"state": "ACTUAL",
"taxIncluded": true,
"type": "REGULAR"
},
{
"amount": {
"amountInMicros": 1000000,
"currencyCode": "USD"
},
"name": "Total Price",
"state": "ACTUAL",
"taxIncluded": true,
"type": "TOTAL"
}
],
"quantity": 1,
"subOptions": []
}
],
"quantity": 1,
"unitMeasure": {
"measure": 1,
"unit": "POUND"
}
}
}
]
},
"createTime": "2019-09-24T18:00:00.877Z",
"followUpActions": [
{
"openUrlAction": {
"url": "http://example.com"
},
"title": "View details",
"type": "VIEW_DETAILS"
},
{
"openUrlAction": {
"url": "tel:+16501112222"
},
"title": "Call us",
"type": "CALL"
},
{
"openUrlAction": {
"url": "mailto:person@example.com"
},
"title": "Email us",
"type": "EMAIL"
}
],
"lastUpdateTime": "2019-09-24T19:00:00.877Z",
"merchantOrderId": "ORDER_ID",
"note": "Sale event",
"priceAttributes": [
{
"amount": {
"amountInMicros": 9990000,
"currencyCode": "USD"
},
"name": "Subtotal",
"state": "ESTIMATE",
"taxIncluded": true,
"type": "SUBTOTAL"
},
{
"amount": {
"amountInMicros": 2000000,
"currencyCode": "USD"
},
"name": "Delivery",
"state": "ACTUAL",
"taxIncluded": true,
"type": "DELIVERY"
},
{
"amount": {
"amountInMicros": 3780000,
"currencyCode": "USD"
},
"name": "Tax",
"state": "ESTIMATE",
"taxIncluded": true,
"type": "TAX"
},
{
"amount": {
"amountInMicros": 15770000,
"currencyCode": "USD"
},
"name": "Total Price",
"state": "ESTIMATE",
"taxIncluded": true,
"type": "TOTAL"
}
],
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"fulfillmentInfo": {
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"fulfillmentContact": {
"displayName": "John Johnson",
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson"
},
"fulfillmentType": "DELIVERY",
"id": "FULFILLMENT_SERVICE_ID",
"location": {},
"price": {
"amount": {
"amountInMicros": 2000000,
"currencyCode": "USD"
},
"name": "Delivery Price",
"state": "ACTUAL",
"taxIncluded": true,
"type": "REGULAR"
}
},
"purchaseLocationType": "ONLINE_PURCHASE",
"returnsInfo": {
"daysToReturn": 1,
"isReturnable": false,
"policyUrl": "http://www.example.com"
},
"status": "CONFIRMED",
"type": "FOOD",
"userVisibleStatusLabel": "Order confirmed"
},
"termsOfServiceUrl": "www.example.com",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"userVisibleOrderId": "ORDER_ID"
},
"reason": "Reason string",
"type": "SNAPSHOT"
}
}
}
],
"suggestions": [
{
"title": "send order update"
}
]
}
}
}
}
JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.TEXT"
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Transaction completed! Your order ORDER_ID is all set!"
}
},
{
"structuredResponse": {
"orderUpdateV3": {
"type": "SNAPSHOT",
"reason": "Reason string",
"order": {
"googleOrderId": "05528125187071048269",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"buyerInfo": {
"email": "janedoe@example.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T19:00:00.877Z",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "8990000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "9990000"
},
"taxIncluded": true
}
],
"description": "A four cheese pizza.",
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1
}
],
"unitMeasure": {
"measure": 1,
"unit": "POUND"
}
},
"vertical": {
"@type": "type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseItemExtension",
"quantity": 1,
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "1000000"
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1
}
],
"unitMeasure": {
"measure": 1,
"unit": "POUND"
}
}
}
]
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": "9990000"
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "2000000"
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": "3780000"
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": "15770000"
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "http://www.example.com",
"note": "Sale event",
"paymentData": {
"paymentResult": {
"merchantPaymentMethodId": "12345678"
},
"paymentInfo": {
"paymentMethodDisplayInfo": {
"paymentType": "PAYMENT_CARD",
"paymentMethodDisplayName": "VISA **** 1234"
},
"paymentMethodProvenance": "PAYMENT_METHOD_PROVENANCE_MERCHANT"
}
},
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CONFIRMED",
"type": "FOOD",
"returnsInfo": {
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"coordinates": {
"latitude": 37.421578499999995,
"longitude": -122.0837816
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "2000000"
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE",
"userVisibleStatusLabel": "Order confirmed"
},
"vertical": {
"@type": "type.googleapis.com/google.actions.orders.v3.verticals.purchase.PurchaseOrderExtension",
"status": "CREATED",
"type": "FOOD",
"returnsInfo": {
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"coordinates": {
"latitude": 37.421578499999995,
"longitude": -122.0837816
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": "2000000"
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE",
"userVisibleStatusLabel": "CREATED"
}
}
}
}
}
],
"suggestions": [
{
"title": "send order update"
}
]
}
}
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\",\"location\":{\"coordinates\":{\"latitude\":37.421578499999995,\"longitude\":-122.0837816},\"zipCode\":\"94043-1351\",\"city\":\"MOUNTAIN VIEW\",\"postalAddress\":{\"regionCode\":\"US\",\"postalCode\":\"94043-1351\",\"administrativeArea\":\"CA\",\"locality\":\"MOUNTAIN VIEW\",\"addressLines\":[\"1600 AMPHITHEATRE PKWY\"],\"recipients\":[\"John Doe\"]},\"phoneNumber\":\"+1 123-456-7890\"},\"latestOrderId\":\"ORDER_ID\"}}"
}
5. Wysyłanie aktualizacji zamówienia
Musisz informować użytkownika o stanie zamówienia przez cały okres jego ważności. Wysyłaj aktualizacje zamówień użytkownika, wysyłając do interfejsu Orders API żądania HTTP PATCH ze stanem i szczegółami zamówienia.
Konfigurowanie żądań asynchronicznych kierowanych do interfejsu Orders API
Żądania aktualizacji zamówień wysyłane do interfejsu Orders API są autoryzowane przez token dostępu. Aby ŁATWIĆ aktualizację zamówienia do interfejsu Orders API, pobierz klucz konta usługi JSON powiązany z projektem w Actions Console, a następnie wymień klucz konta usługi na token okaziciela, który można przekazać do nagłówka Authorization żądania HTTP.
Aby pobrać klucz konta usługi, wykonaj te czynności:
- W konsoli Google Cloud wybierz Menu />< > Interfejsy API i usługi > Dane logowania > Utwórz dane logowania > Klucz konta usługi.
- W sekcji Service Account (Konto usługi) wybierz New Service Account (Nowe konto usługi).
- Ustaw konto usługi na
service-account. - Ustaw Rolę na Projekt > Właściciel.
- Ustaw typ klucza na JSON.
- Wybierz Utwórz.
- Na Twój komputer zostanie pobrany prywatny klucz konta usługi JSON.
W kodzie aktualizacji zamówień możesz wymienić klucz usługi na token okaziciela, korzystając z biblioteki klienta interfejsów API Google i zakresu "https://www.googleapis.com/auth/actions.order.developer". Instrukcje i przykłady instalacji znajdziesz na stronie w GitHubie w bibliotece klienta interfejsu API.
Możesz również odwoływać się do order-update.js naszych przykładów wymiany kluczy Node.js i Java.
Wysyłanie aktualizacji zamówienia
Po wymianie klucza konta usługi na token okaziciela OAuth możesz wysyłać aktualizacje zamówień jako autoryzowane żądania PATCH do interfejsu Orders API.
Adres URL interfejsu Orders API:
PATCH https://actions.googleapis.com/v3/orders/${orderId}
Podaj te nagłówki w żądaniu:
"Authorization: Bearer token"z tokenem okaziciela OAuth, na który wymieniono klucz konta usługi."Content-Type: application/json".
Żądanie PATCH powinno mieć treść JSON w tym formacie:
{ "orderUpdate": OrderUpdate }
Obiekt OrderUpdate składa się z tych pól najwyższego poziomu:
updateMask– pola zamówienia, które aktualizujesz. Aby zaktualizować stan zamówienia, ustaw wartość napurchase.status, purchase.userVisibleStatusLabel.order– zawartość aktualizacji. Jeśli aktualizujesz zawartość zamówienia, ustaw wartość na zaktualizowany obiektOrder. Jeśli aktualizujesz stan zamówienia (na przykład z"CONFIRMED"na"SHIPPED"), obiekt zawiera te pola:merchantOrderId– identyfikator ustawiony w obiekcieOrder.lastUpdateTime– sygnatura czasowa aktualizacji.purchase– obiekt zawierający:status– stan zamówienia toPurchaseStatus, np. „SHIPPED” lub „DELIVERED”.userVisibleStatusLabel– widoczna dla użytkowników etykieta ze szczegółowymi informacjami o stanie zamówienia, np. „Twoje zamówienie zostało wysłane i jest w drodze”.
userNotification, który może się wyświetlać na urządzeniu użytkownika po wysłaniu tej aktualizacji. Pamiętaj, że uwzględnienie tego obiektu nie gwarantuje, że powiadomienie pojawi się na urządzeniu użytkownika.
Poniżej znajduje się przykładowy kod OrderUpdate, który aktualizuje stan zamówienia na DELIVERED:
Node.js
// Import the 'googleapis' module for authorizing the request.
const {google} = require('googleapis');
// Import the 'request-promise' module for sending an HTTP POST request.
const request = require('request-promise');
// Import the OrderUpdate class from the Actions on Google client library.
const {OrderUpdate} = require('actions-on-google');
// Import the service account key used to authorize the request.
// Replacing the string path with a path to your service account key.
// i.e. const serviceAccountKey = require('./service-account.json')
// Create a new JWT client for the Actions API using credentials
// from the service account key.
let jwtClient = new google.auth.JWT(
serviceAccountKey.client_email,
null,
serviceAccountKey.private_key,
['https://www.googleapis.com/auth/actions.order.developer'],
null,
);
// Authorize the client
let tokens = await jwtClient.authorize();
// Declare order update
const orderUpdate = new OrderUpdate({
updateMask: [
'lastUpdateTime',
'purchase.status',
'purchase.userVisibleStatusLabel',
].join(','),
order: {
merchantOrderId: orderId, // Specify the ID of the order to update
lastUpdateTime: new Date().toISOString(),
purchase: {
status: 'DELIVERED',
userVisibleStatusLabel: 'Order delivered',
},
},
reason: 'Order status updated to delivered.',
});
// Set up the PATCH request header and body,
// including the authorized token and order update.
let options = {
method: 'PATCH',
uri: `https://actions.googleapis.com/v3/orders/${orderId}`,
auth: {
bearer: tokens.access_token,
},
body: {
header: {
isInSandbox: true,
},
orderUpdate,
},
json: true,
};
// Send the PATCH request to the Orders API.
try {
await request(options);
conv.close(`The order has been updated.`);
} catch (e) {
console.log(`Error: ${e}`);
conv.close(`There was an error sending an order update.`);
}
Node.js
// Import the 'googleapis' module for authorizing the request.
const {google} = require('googleapis');
// Import the 'request-promise' module for sending an HTTP POST request.
const request = require('request-promise');
// Import the OrderUpdate class from the Actions on Google client library.
const {OrderUpdate} = require('actions-on-google');
// Import the service account key used to authorize the request.
// Replacing the string path with a path to your service account key.
// i.e. const serviceAccountKey = require('./service-account.json')
// Create a new JWT client for the Actions API using credentials
// from the service account key.
let jwtClient = new google.auth.JWT(
serviceAccountKey.client_email,
null,
serviceAccountKey.private_key,
['https://www.googleapis.com/auth/actions.order.developer'],
null,
);
// Authorize the client
let tokens = await jwtClient.authorize();
// Declare order update
const orderUpdate = new OrderUpdate({
updateMask: [
'lastUpdateTime',
'purchase.status',
'purchase.userVisibleStatusLabel',
].join(','),
order: {
merchantOrderId: orderId, // Specify the ID of the order to update
lastUpdateTime: new Date().toISOString(),
purchase: {
status: 'DELIVERED',
userVisibleStatusLabel: 'Order delivered',
},
},
reason: 'Order status updated to delivered.',
});
// Set up the PATCH request header and body,
// including the authorized token and order update.
let options = {
method: 'PATCH',
uri: `https://actions.googleapis.com/v3/orders/${orderId}`,
auth: {
bearer: tokens.access_token,
},
body: {
header: {
isInSandbox: true,
},
orderUpdate,
},
json: true,
};
// Send the PATCH request to the Orders API.
try {
await request(options);
conv.close(`The order has been updated.`);
} catch (e) {
console.log(`Error: ${e}`);
conv.close(`There was an error sending an order update.`);
}
Java
// Setup service account credentials
String serviceAccountFile = MyActionsApp.class.getClassLoader()
.getResource(SERVICE_ACCOUNT_KEY_FILE_NAME)
.getFile();
InputStream actionsApiServiceAccount = new FileInputStream(
serviceAccountFile);
ServiceAccountCredentials serviceAccountCredentials = (ServiceAccountCredentials)
ServiceAccountCredentials.fromStream(actionsApiServiceAccount)
.createScoped(Collections.singleton(
"https://www.googleapis.com/auth/actions.order.developer"));
AccessToken token = serviceAccountCredentials.refreshAccessToken();
// Setup request with headers
HttpPatch patchRequest = new HttpPatch(
"https://actions.googleapis.com/v3/orders/" + orderId);
patchRequest.setHeader("Content-type", "application/json");
patchRequest.setHeader("Authorization", "Bearer " + token.getTokenValue());
// Create order update
FieldMask fieldMask = FieldMask.newBuilder().addAllPaths(Arrays.asList(
"lastUpdateTime",
"purchase.status",
"purchase.userVisibleStatusLabel"))
.build();
OrderUpdateV3 orderUpdate = new OrderUpdateV3()
.setOrder(new OrderV3()
.setMerchantOrderId(orderId)
.setLastUpdateTime(Instant.now().toString())
.setPurchase(new PurchaseOrderExtension()
.setStatus("DELIVERED")
.setUserVisibleStatusLabel("Order delivered.")))
.setUpdateMask(FieldMaskUtil.toString(fieldMask))
.setReason("Order status was updated to delivered.");
// Setup JSON body containing order update
JsonParser parser = new JsonParser();
JsonObject orderUpdateJson =
parser.parse(new Gson().toJson(orderUpdate)).getAsJsonObject();
JsonObject body = new JsonObject();
body.add("orderUpdate", orderUpdateJson);
JsonObject header = new JsonObject();
header.addProperty("isInSandbox", true);
body.add("header", header);
StringEntity entity = new StringEntity(body.toString());
entity.setContentType(ContentType.APPLICATION_JSON.getMimeType());
patchRequest.setEntity(entity);
// Make request
HttpClient httpClient = HttpClientBuilder.create().build();
HttpResponse response = httpClient.execute(patchRequest);
LOGGER.info(response.getStatusLine().getStatusCode() + " " + response
.getStatusLine().getReasonPhrase());
return getResponseBuilder(request)
.add("The order has been updated.")
.build();
Java
// Setup service account credentials
String serviceAccountFile = MyActionsApp.class.getClassLoader()
.getResource(SERVICE_ACCOUNT_KEY_FILE_NAME)
.getFile();
InputStream actionsApiServiceAccount = new FileInputStream(
serviceAccountFile);
ServiceAccountCredentials serviceAccountCredentials = (ServiceAccountCredentials)
ServiceAccountCredentials.fromStream(actionsApiServiceAccount)
.createScoped(Collections.singleton(
"https://www.googleapis.com/auth/actions.order.developer"));
AccessToken token = serviceAccountCredentials.refreshAccessToken();
// Setup request with headers
HttpPatch patchRequest = new HttpPatch(
"https://actions.googleapis.com/v3/orders/" + orderId);
patchRequest.setHeader("Content-type", "application/json");
patchRequest.setHeader("Authorization", "Bearer " + token.getTokenValue());
// Create order update
FieldMask fieldMask = FieldMask.newBuilder().addAllPaths(Arrays.asList(
"lastUpdateTime",
"purchase.status",
"purchase.userVisibleStatusLabel"))
.build();
OrderUpdateV3 orderUpdate = new OrderUpdateV3()
.setOrder(new OrderV3()
.setMerchantOrderId(orderId)
.setLastUpdateTime(Instant.now().toString())
.setPurchase(new PurchaseOrderExtension()
.setStatus("DELIVERED")
.setUserVisibleStatusLabel("Order delivered.")))
.setUpdateMask(FieldMaskUtil.toString(fieldMask))
.setReason("Order status was updated to delivered.");
// Setup JSON body containing order update
JsonParser parser = new JsonParser();
JsonObject orderUpdateJson =
parser.parse(new Gson().toJson(orderUpdate)).getAsJsonObject();
JsonObject body = new JsonObject();
body.add("orderUpdate", orderUpdateJson);
JsonObject header = new JsonObject();
header.addProperty("isInSandbox", true);
body.add("header", header);
StringEntity entity = new StringEntity(body.toString());
entity.setContentType(ContentType.APPLICATION_JSON.getMimeType());
patchRequest.setEntity(entity);
// Make request
HttpClient httpClient = HttpClientBuilder.create().build();
HttpResponse response = httpClient.execute(patchRequest);
LOGGER.info(response.getStatusLine().getStatusCode() + " " + response
.getStatusLine().getReasonPhrase());
return getResponseBuilder(request)
.add("The order has been updated.")
.build();
Ustawianie stanu zakupu
Pole status aktualizacji zamówienia musi zawierać opis jego bieżącego stanu. W polu order.purchase.status aktualizacji użyj jednej z tych wartości:
CREATED– zamówienie jest zaakceptowane przez użytkownika i „utworzone” z perspektywy akcji, ale wymaga ręcznego przetworzenia przez backend.CONFIRMED– zamówienie jest aktywne i trwa przetwarzanie w celu realizacji.IN_PREPARATION– zamówienie jest przygotowywane do wysyłki/dostawy, np. gotowanie lub pakowanie przedmiotu.READY_FOR_PICKUP– zamówienie może zostać odebrane przez odbiorcę.DELIVERED– zamówienie zostało dostarczone do odbiorcyOUT_OF_STOCK– co najmniej jeden produkt w zamówieniu jest niedostępny.CHANGE_REQUESTED– użytkownik poprosił o zmianę zamówienia, która jest przetwarzana.RETURNED– zamówienie zostało zwrócone przez użytkownika po dostawie.REJECTED– jeśli nie udało Ci się przetworzyć, obciążyć lub w inny sposób „aktywować” zamówienia.CANCELLED– zamówienie zostało anulowane przez użytkownika.
Musisz wysyłać aktualizacje zamówienia dla każdego stanu istotnego dla Twojej transakcji. Jeśli na przykład transakcja wymaga ręcznego przetworzenia w celu zarejestrowania zamówienia po jego złożeniu, wysyłaj aktualizację zamówienia CREATED do czasu zakończenia dodatkowego przetwarzania. Nie każde zamówienie wymaga podania wartości stanu.
Rozwiązywanie problemów
Jeśli podczas testowania napotkasz jakieś problemy, przeczytaj nasze instrukcje rozwiązywania problemów z transakcjami.