इस गाइड में, ऐसा ऐक्शन प्रोजेक्ट बनाने का तरीका बताया गया है जिसमें सामान के लिए किए गए लेन-देन शामिल हैं. इसके लिए, पैसे चुकाने के ऐसे तरीके इस्तेमाल किए जाते हैं जिन्हें आपकी साइट मैनेज करती है.
लेन-देन फ़्लो
जब आपका ऐक्शन प्रोजेक्ट, कारोबारी की ओर से मैनेज किए जाने वाले पेमेंट की मदद से फ़िज़िकल लेन-देन मैनेज करता है, तब यह इस फ़्लो का इस्तेमाल करता है:
- जानकारी इकट्ठा करें (ज़रूरी नहीं) - अपने लेन-देन के हिसाब से, आप बातचीत की शुरुआत में उपयोगकर्ता से यह जानकारी इकट्ठा कर सकते हैं:
- लेन-देन की ज़रूरी शर्तों की पुष्टि करना - बातचीत की शुरुआत में लेन-देन से जुड़ी ज़रूरी शर्तों के लिए हेल्पर का इस्तेमाल करें. इससे यह पक्का हो जाएगा कि उपयोगकर्ता के कार्ट बनाने से पहले, उसकी क्रेडिट/डेबिट कार्ड की जानकारी सही तरीके से कॉन्फ़िगर और उपलब्ध है.
- डिलीवरी के पते के लिए अनुरोध करना - अगर आपके लेन-देन के लिए डिलीवरी के पते की ज़रूरत है, तो डिलीवरी पते के हेल्पर इंटेंट को उपयोगकर्ता से इकट्ठा करने के लिए अनुरोध करें.
- ऑर्डर बनाएं - उपयोगकर्ता को "कार्ट असेंबली" की प्रोसेस पर ले जाएं, जहां वे खरीदे जाने वाले आइटम चुनते हैं.
- खाता लिंक करना - उपयोगकर्ता आपकी सेवा के साथ सेव किए गए पेमेंट के तरीके का इस्तेमाल कर सकें, इसके लिए खाता लिंक करने की सुविधा इस्तेमाल करें. इससे उनके Google खाते को आपकी सेवा पर मौजूद उनके खाते से जोड़ा जा सकेगा.
- ऑर्डर प्रपोज़ करें - कार्ट पूरा हो जाने पर, उपयोगकर्ता को ऑर्डर का सुझाव दें, ताकि वे पुष्टि कर सकें कि ऑर्डर सही है. अगर ऑर्डर की पुष्टि हो जाती है, तो आपको ऑर्डर की जानकारी और पेमेंट टोकन के साथ जवाब मिलेगा.
- ऑर्डर पूरा करें और रसीद भेजें - ऑर्डर की पुष्टि हो जाने के बाद, अपनी इन्वेंट्री ट्रैकिंग या ग्राहक को आइटम भेजने से जुड़ी दूसरी सेवाओं को अपडेट करें. इसके बाद, उपयोगकर्ता को रसीद भेजें.
- ऑर्डर के अपडेट भेजें - ऑर्डर पूरा करने के दौरान, ऑर्डर एपीआई को PATCH अनुरोध भेजकर, उपयोगकर्ता के ऑर्डर का अपडेट दें.
पाबंदियां और समीक्षा के लिए दिशा-निर्देश
ध्यान रखें कि 'लेन-देन' वाली कार्रवाइयों पर दूसरी नीतियां भी लागू होती हैं. ट्रांज़ैक्शन से जुड़ी कार्रवाइयों की समीक्षा करने में हमें छह हफ़्ते लग सकते हैं. इसलिए, रिलीज़ शेड्यूल बनाते समय उस समय का ध्यान रखें. समीक्षा के लिए की गई कार्रवाई को सबमिट करने से पहले, पक्का करें कि समीक्षा की प्रोसेस को आसान बनाने के लिए, लेन-देन से जुड़ी नीतियों और दिशा-निर्देशों का पालन किया जा रहा हो.
सिर्फ़ ऐसी कार्रवाइयों को डिप्लॉय किया जा सकता है जो सामान बेचते हैं. यह सुविधा इन देशों में उपलब्ध है:
|
ऑस्ट्रेलिया ब्राज़ील कनाडा इंडोनेशिया |
जापान मेक्सिको कतर रूस |
सिंगापुर स्विट्ज़रलैंड थाईलैंड तुर्किये यूनाइटेड किंगडम अमेरिका |
अपना प्रोजेक्ट बनाएं
लेन-देन से जुड़ी बातचीत के सभी उदाहरणों के लिए, Node.js और Java में हमारे लेन-देन के नमूने देखें.
प्रोजेक्ट सेटअप
कार्रवाई बनाते समय, आपको यह बताना होगा कि आपको Actions कंसोल में लेन-देन करना है. साथ ही, अगर Node.JS क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो ऑर्डर एपीआई के नए वर्शन का इस्तेमाल करने के लिए, फ़ुलफ़िलमेंट सेट अप करें.
अपना प्रोजेक्ट सेट अप करने और उसे पूरा करने के लिए, यह तरीका अपनाएं:
- एक नया प्रोजेक्ट बनाएं या कोई मौजूदा प्रोजेक्ट इंपोर्ट करें.
- डिप्लॉय करें > डायरेक्ट्री की जानकारी पर जाएं.
ज़्यादा जानकारी > लेन-देन में जाकर > "क्या आपकी कार्रवाइयां, भौतिक चीज़ों के लेन-देन के लिए लेन-देन एपीआई का इस्तेमाल करती हैं?" वाले बॉक्स को चुनें.
अगर आपकी सेट की गई कार्रवाई को पूरा करने के लिए Node.JS क्लाइंट लाइब्रेरी का इस्तेमाल किया जा रहा है, तो फ़ुलफ़िलमेंट कोड खोलें और
ordersv3फ़्लैग कोtrueपर सेट करने के लिए, अपने ऐप्लिकेशन के एलान को अपडेट करें. नीचे दिया गया कोड स्निपेट, ऑर्डर के वर्शन 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,
});
साइन-इन सेटअप
उपयोगकर्ता से शुल्क लेने के लिए अपना पैसे चुकाने का तरीका इस्तेमाल करते समय, हम सुझाव देते हैं कि आप उनके Google खाते को उस खाते से लिंक करें जो उनके पास आपकी अपनी सेवा के साथ है. ऐसा इसलिए किया जाता है, ताकि वहां सेव किए गए पैसे चुकाने के तरीकों को वापस पाया जा सके, दिखाया जा सके, और उससे शुल्क लिया जा सके.
इस ज़रूरी शर्त को पूरा करने के लिए, हम OAuth 2.0 खाता लिंक करने की सुविधा देते हैं. हमारा सुझाव है कि आप OAuth 2.0 असर के फ़्लो को चालू करें. इससे, उपयोगकर्ताओं को बेहतर अनुभव मिलता है.
हम actions.intent.SIGN_IN इंटेंट देते हैं, जिसकी मदद से आप यह अनुरोध कर सकते हैं कि उपयोगकर्ता बातचीत के बीच में ही खातों को लिंक कर दे. actions.intent.SIGN_IN इंटेंट का इस्तेमाल करने के लिए, आपको Actions Console में
खाता जोड़ने की सुविधा चालू करनी होगी.
अगर आपको वेबहुक अनुरोध के User ऑब्जेक्ट में accessToken नहीं मिल रहा है, तो आपको इस इंटेंट का इस्तेमाल करना चाहिए. इसका मतलब है कि उपयोगकर्ता ने अभी तक अपना खाता
लिंक नहीं किया है.
actions.intent.SIGN_IN इंटेंट का अनुरोध करने के बाद, आपको
Argument मिलेगा. इसमें SignInStatus की वैल्यू "OK",
"CANCELLED" या "ERROR" होगी. अगर स्टेटस "OK" है, तो आपको
User ऑब्जेक्ट में accessToken दिखेगा.
ग्राहक का ऑर्डर पूरा करना
साइन इन करने का अनुरोध करें
Node.js
app.intent('Sign In', (conv) => {
conv.ask(new SignIn('To get your account details'));
});
Node.js
conv.ask(new SignIn('To get your account details'));
Java
@ForIntent("Sign In")
public ActionResponse signIn(ActionRequest request) {
return getResponseBuilder(request).add(
new SignIn()
.setContext("To get your account details"))
.build();
}
Java
return getResponseBuilder(request).add(
new SignIn()
.setContext("To get your account details"))
.build();
JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.SIGN_IN",
"data": {
"@type": "type.googleapis.com/google.actions.v2.SignInValueSpec",
"optContext": "To get your account details"
}
}
}
}
}
JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.SIGN_IN",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.SignInValueSpec",
"optContext": "To get your account details"
}
}
]
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\"}}"
}
साइन इन से जुड़ा नतीजा पाएं
Node.js
app.intent('Sign In Complete', (conv, params, signin) => {
if (signin.status !== 'OK') {
conv.ask('You need to sign in before making a transaction.');
} else {
const accessToken = conv.user.access.token;
// possibly do something with access token
conv.ask('You must meet all the requirements necessary ' +
'to make a transaction. Try saying ' +
'"check transaction requirements".');
conv.ask(new Suggestions(`check requirements`));
}
});
Node.js
app.intent('actions.intent.SIGN_IN', (conv, params, signin) => {
if (signin.status !== 'OK') {
conv.ask('You need to sign in before making a transaction.');
} else {
const accessToken = conv.user.access.token;
// possibly do something with access token
conv.ask('You must meet all the requirements necessary ' +
'to make a transaction. Try saying ' +
'"check transaction requirements".');
conv.ask(new Suggestions(`check requirements`));
}
});
Java
@ForIntent("Sign In Complete")
public ActionResponse signInComplete(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (request.isSignInGranted()) {
responseBuilder
.add("You must meet all the requirements necessary to make a " +
"transaction. Try saying \"check transaction requirements\".")
.addSuggestions(new String[] {
"check requirements"
});
} else {
responseBuilder.add("You need to sign in before making a transaction.");
}
return responseBuilder.build();
}
Java
@ForIntent("actions.intent.SIGN_IN")
public ActionResponse signInComplete(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (request.isSignInGranted()) {
responseBuilder
.add("You must meet all the requirements necessary to make a " +
"transaction. Try saying \"check transaction requirements\".")
.addSuggestions(new String[] {
"check requirements"
});
} else {
responseBuilder.add("You need to sign in before making a transaction.");
}
return responseBuilder.build();
}
JSON
{
"responseId": "d2123d8d-3f00-466e-b5a9-1a4ed53a7cb7-594de0a7",
"queryResult": {
"queryText": "actions_intent_SIGN_IN",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentMessages": [
{
"text": {
"text": [
""
]
}
}
],
"outputContexts": [
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/merchant_payment",
"lifespanCount": 2
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_screen_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_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/google_assistant_input_type_keyboard"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_intent_sign_in",
"parameters": {
"SIGN_IN": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
},
"text": ""
}
}
],
"intent": {
"name": "projects/df-transactions/agent/intents/105b925b-b186-4f5d-8bde-a9a782a0fa9f",
"displayName": "Sign In Complete"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"lastSeen": "2019-09-23T19:49:18Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy",
"type": "ACTIVE",
"conversationToken": "[]"
},
"inputs": [
{
"intent": "actions.intent.SIGN_IN",
"rawInputs": [
{
"inputType": "KEYBOARD"
}
],
"arguments": [
{
"name": "SIGN_IN",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
}
},
{
"name": "text"
}
]
}
],
"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:55:52Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGFwStZlYaQ9YT8rg9t_idVsxZrku1pUDrEbGSJmSUMatVdPwPEEQSCe1IwIBoN4sS4Weyn9pmgetEgbsWgw3JSvQmw",
"type": "ACTIVE",
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\"}}"
},
"inputs": [
{
"intent": "actions.intent.SIGN_IN",
"rawInputs": [
{}
],
"arguments": [
{
"name": "SIGN_IN",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
}
},
{
"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"
}
]
}
]
}
1. जानकारी इकट्ठा करना (ज़रूरी नहीं)
1a. लेन-देन से जुड़ी ज़रूरी शर्तों की पुष्टि करना (ज़रूरी नहीं)
लोगों का अनुभव
actions.intent.TRANSACTION_REQUIREMENTS_CHECK इंटेंट को ट्रिगर करके तुरंत देखें कि उपयोगकर्ता लेन-देन कर पाएंगे या नहीं. इस
चरण से उपयोगकर्ताओं को लेन-देन पूरा करने से रोकने वाली
किसी भी सेटिंग को ठीक करने का मौक़ा मिलेगा.
उदाहरण के लिए, इस्तेमाल किए जाने पर आपकी सेट की गई कार्रवाई में यह पूछ सकता है कि "क्या आपको जूते ऑर्डर करने हैं या अपने खाते का बैलेंस देखना है?" अगर उपयोगकर्ता "जूते ऑर्डर करें" कहता है, तो आपको तुरंत इस इंटेंट के लिए अनुरोध करना चाहिए. इससे यह पक्का किया जा सकेगा कि वह कार्रवाई कर सके. साथ ही, उसे उन सेटिंग को ठीक करने का मौका दिया जाए जिनकी वजह से वह लेन-देन नहीं कर पा रहा है.
ट्रांज़ैक्शन की ज़रूरी शर्तों की जांच के इंटेंट का अनुरोध करने से, इनमें से कोई एक नतीजा मिलेगा:
- अगर ज़रूरी शर्तें पूरी हो जाती हैं, तो इंटेंट को आपके फ़ुलफ़िलमेंट के तौर पर वापस भेज दिया जाएगा. इसके बाद, उपयोगकर्ता के लिए ऑर्डर बनाया जा सकता है.
- अगर एक या उससे ज़्यादा ज़रूरी शर्तें पूरी नहीं हो पाती हैं, तो इंटेंट को
आपका अनुरोध पूरा करने के लिए वापस भेज दिया जाएगा. ऐसी स्थिति में, आपको बातचीत को
लेन-देन के अनुभव से दूर रखना चाहिए या बातचीत खत्म करनी चाहिए.
- अगर गड़बड़ी होने की किसी वजह को उपयोगकर्ता ठीक कर पाते हैं, तो उन्हें अपने डिवाइस पर उन समस्याओं को ठीक करने के लिए कहा जाएगा. अगर कोई बातचीत किसी ऐसी जगह पर हो रही है जहां सिर्फ़ आवाज़ हो, तो उपयोगकर्ता के फ़ोन पर हैंडऑफ़ शुरू हो जाएगा.
ग्राहक का ऑर्डर पूरा करना
यह पक्का करने के लिए कि उपयोगकर्ता
लेन-देन की ज़रूरी शर्तें पूरी करता है,
TransactionRequirementsCheckSpec ऑब्जेक्ट की मदद से,
actions.intent.TRANSACTION_REQUIREMENTS_CHECK इंटेंट को पूरा करने का अनुरोध करें.
ज़रूरी शर्तें देखें
क्लाइंट लाइब्रेरी का इस्तेमाल करके यह देखा जा सकता है कि कोई उपयोगकर्ता लेन-देन की ज़रूरी शर्तों को पूरा करता है या नहीं:
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,
"systemIntent": {
"intent": "actions.intent.TRANSACTION_REQUIREMENTS_CHECK",
"data": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionRequirementsCheckSpec"
}
}
}
}
}
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\":\"merchant_payment\"}}"
}
ज़रूरी शर्तों से जुड़ी जांच का नतीजा पाएं
Assistant जब आपके इंटेंट को पूरा कर लेती है, तब वह आपकी जांच के नतीजे के साथ, actions.intent.TRANSACTION_REQUIREMENTS_CHECK इंटेंट के साथ आपका पूरा करने का अनुरोध भेजती है. इस अनुरोध को सही तरीके से मैनेज करने के लिए, actions_intent_TRANSACTION_REQUIREMENTS_CHECK इवेंट से ट्रिगर होने वाले Dialogflow इंटेंट के बारे में बताएं. ट्रिगर होने पर,
क्लाइंट लाइब्रेरी का इस्तेमाल करके, इसे अपने फ़ुलफ़िलमेंट में हैंडल करें:
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. डिलीवरी के पते का अनुरोध करें (ज़रूरी नहीं)
अगर आपके लेन-देन के लिए उपयोगकर्ता के डिलीवरी के पते की ज़रूरत है, तो actions.intent.DELIVERY_ADDRESS इंटेंट पूरा करने का अनुरोध किया जा सकता है. इससे कुल कीमत, डिलीवरी/पिकअप की जगह का पता लगाने या यह पक्का करने में मदद मिल सकती है कि उपयोगकर्ता आपके सेवा देने के इलाके में है.
इस इंटेंट को पूरा करने का अनुरोध करते समय, आपको reason विकल्प दिखता है. यह विकल्प आपको स्ट्रिंग की मदद से, Assistant के पते को पाने के अनुरोध की शुरुआत करने देता है.
उदाहरण के लिए, अगर आपने "ऑर्डर भेजने के लिए जगह की जानकारी" दी है, तो Assistant
उपयोगकर्ता से पूछ सकती है:
"ऑर्डर कहां भेजना है, यह जानने के लिए मुझे डिलीवरी का पता चाहिए"
लोगों का अनुभव
स्क्रीन वाले प्लैटफ़ॉर्म पर, उपयोगकर्ता चुन सकता है कि लेन-देन के लिए उसे कौनसा पता इस्तेमाल करना है. अगर उन्होंने पहले पता नहीं दिया है, तो वे नया पता डाल सकते हैं.
सिर्फ़ आवाज़ वाले प्लैटफ़ॉर्म पर, Assistant इस लेन-देन के लिए, उपयोगकर्ता से अपना डिफ़ॉल्ट पता शेयर करने की अनुमति मांगेगी. अगर उन्होंने पहले कोई पता नहीं दिया है, तो प्रवेश के लिए उनकी बातचीत फ़ोन को सौंप दी जाएगी.
पते का अनुरोध करें
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\"}}"
}
पता पाएं
Assistant जब आपके इंटेंट को पूरा कर लेती है, तब वह आपको actions.intent.DELIVERY_ADDRESS इंटेंट के साथ
पूरा करने का एक अनुरोध भेजती है.
इस अनुरोध को सही तरीके से मैनेज करने के लिए, actions_intent_DELIVERY_ADDRESSइवेंट से ट्रिगर होने वाले Dialogflow इंटेंट के बारे में बताएं. ट्रिगर होने पर, क्लाइंट लाइब्रेरी का इस्तेमाल करके
इसे अपने फ़ुलफ़िलमेंट में मैनेज करें:
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. ऑर्डर बनाएं
लोगों का अनुभव
उपयोगकर्ता की ज़रूरत की जानकारी मिलने के बाद, "कार्ट असेंबली" का एक अनुभव बनाया जाता है. यह उपयोगकर्ता को ऑर्डर बनाने के लिए गाइड करता है. हर कार्रवाई में अपने प्रॉडक्ट या सेवा के हिसाब से, कार्ट असेंबली फ़्लो थोड़ा अलग होगा.
कार्ट असेंबली करने के सबसे बुनियादी अनुभव में, उपयोगकर्ता किसी सूची से आइटम चुनता है, ताकि उसे उनके क्रम में जोड़ा जा सके. हालांकि, आपके पास उपयोगकर्ता अनुभव को आसान बनाने के लिए बातचीत का डिज़ाइन तैयार करने का विकल्प होता है. आपके पास कार्ट असेंबली का ऐसा अनुभव तैयार करने की सुविधा है जिससे लोग हाल ही में की गई अपनी खरीदारी को फिर से ऑर्डर कर सकें. इसके लिए, हां या नहीं में सवाल का इस्तेमाल करें. आप उपयोगकर्ता को "चुनिंदा" या "सुझाए गए" सबसे ज़्यादा इस्तेमाल किए गए आइटम का कैरसेल या सूची कार्ड भी दिखा सकते हैं.
हमारा सुझाव है कि लोगों के विकल्पों को विज़ुअल तरीके से दिखाने के लिए, बेहतर रिस्पॉन्स का इस्तेमाल करें. साथ ही, बातचीत को इस तरह से तैयार करें कि लोग सिर्फ़ अपनी आवाज़ का इस्तेमाल करके अपनी कार्ट बना सकें. कार्ट असेंबली की अच्छी क्वालिटी के कुछ सबसे सही तरीकों और उदाहरणों के लिए, ट्रांज़ैक्शन डिज़ाइन से जुड़े दिशा-निर्देश देखें.
ग्राहक का ऑर्डर पूरा करना
बातचीत के दौरान, आपको उन आइटम को इकट्ठा करना होगा जिन्हें कोई उपयोगकर्ता
खरीदना चाहता है और फिर एक Order ऑब्जेक्ट बनाना होगा.
आपके Order में कम से कम ये चीज़ें होनी चाहिए:
buyerInfo- खरीदारी करने वाले उपयोगकर्ता के बारे में जानकारी.transactionMerchant- उस व्यापारी/कंपनी के बारे में जानकारी जिसने ऑर्डर देने की सुविधा दी थी.contents- ऑर्डर का असल कॉन्टेंटlineItemsके तौर पर लिस्ट किया गया है.priceAttributes- ऑर्डर की कीमत की जानकारी, जिसमें छूट और टैक्स के साथ ऑर्डर की कुल कीमत शामिल होती है.
अपना कार्ट बनाने के लिए, Order रिस्पॉन्स दस्तावेज़
देखें. ध्यान दें कि आपको क्रम के आधार पर
अलग-अलग फ़ील्ड शामिल करने पड़ सकते हैं.
नीचे दिए गए सैंपल कोड में पूरा ऑर्डर दिखता है. इसमें वैकल्पिक फ़ील्ड भी शामिल हैं:
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. खाता लिंक करने की प्रोसेस शुरू करें
उपयोगकर्ता से शुल्क लेने के लिए अपना पैसे चुकाने का तरीका इस्तेमाल करते समय, हम सुझाव देते हैं कि आप उनके Google खाते को उस खाते से लिंक करें जो उनके पास आपकी अपनी सेवा के साथ है. ऐसा इसलिए किया जाता है, ताकि वहां सेव किए गए पैसे चुकाने के तरीकों को वापस पाया जा सके, दिखाया जा सके, और उससे शुल्क लिया जा सके.
इस ज़रूरी शर्त को पूरा करने के लिए, हम OAuth 2.0 खाता लिंक करने की सुविधा देते हैं. हमारा सुझाव है कि आप OAuth 2.0 असर के फ़्लो को चालू करें. इससे, उपयोगकर्ताओं को बेहतर अनुभव मिलता है.
हम actions.intent.SIGN_IN इंटेंट देते हैं, जिसकी मदद से आप यह अनुरोध कर सकते हैं कि उपयोगकर्ता बातचीत के बीच में ही खातों को लिंक कर दे. actions.intent.SIGN_IN इंटेंट का इस्तेमाल करने के लिए, आपको Actions Console में
खाता जोड़ने की सुविधा चालू करनी होगी.
अगर आपको वेबहुक अनुरोध के User ऑब्जेक्ट में accessToken नहीं मिल रहा है, तो आपको इस इंटेंट का इस्तेमाल करना चाहिए. इसका मतलब है कि उपयोगकर्ता ने अभी तक अपना खाता
लिंक नहीं किया है.
actions.intent.SIGN_IN इंटेंट का अनुरोध करने के बाद, आपको
Argument मिलेगा. इसमें SignInStatus की वैल्यू "OK",
"CANCELLED" या "ERROR" होगी. अगर स्टेटस "OK" है, तो आपको
User ऑब्जेक्ट में accessToken दिखेगा.
ग्राहक का ऑर्डर पूरा करना
साइन इन करने का अनुरोध करें
Node.js
app.intent('Sign In', (conv) => {
conv.ask(new SignIn('To get your account details'));
});
Node.js
conv.ask(new SignIn('To get your account details'));
Java
@ForIntent("Sign In")
public ActionResponse signIn(ActionRequest request) {
return getResponseBuilder(request).add(
new SignIn()
.setContext("To get your account details"))
.build();
}
Java
return getResponseBuilder(request).add(
new SignIn()
.setContext("To get your account details"))
.build();
JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"systemIntent": {
"intent": "actions.intent.SIGN_IN",
"data": {
"@type": "type.googleapis.com/google.actions.v2.SignInValueSpec",
"optContext": "To get your account details"
}
}
}
}
}
JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.SIGN_IN",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.v2.SignInValueSpec",
"optContext": "To get your account details"
}
}
]
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\"}}"
}
साइन इन से जुड़ा नतीजा पाएं
Node.js
app.intent('Sign In Complete', (conv, params, signin) => {
if (signin.status !== 'OK') {
conv.ask('You need to sign in before making a transaction.');
} else {
const accessToken = conv.user.access.token;
// possibly do something with access token
conv.ask('You must meet all the requirements necessary ' +
'to make a transaction. Try saying ' +
'"check transaction requirements".');
conv.ask(new Suggestions(`check requirements`));
}
});
Node.js
app.intent('actions.intent.SIGN_IN', (conv, params, signin) => {
if (signin.status !== 'OK') {
conv.ask('You need to sign in before making a transaction.');
} else {
const accessToken = conv.user.access.token;
// possibly do something with access token
conv.ask('You must meet all the requirements necessary ' +
'to make a transaction. Try saying ' +
'"check transaction requirements".');
conv.ask(new Suggestions(`check requirements`));
}
});
Java
@ForIntent("Sign In Complete")
public ActionResponse signInComplete(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (request.isSignInGranted()) {
responseBuilder
.add("You must meet all the requirements necessary to make a " +
"transaction. Try saying \"check transaction requirements\".")
.addSuggestions(new String[] {
"check requirements"
});
} else {
responseBuilder.add("You need to sign in before making a transaction.");
}
return responseBuilder.build();
}
Java
@ForIntent("actions.intent.SIGN_IN")
public ActionResponse signInComplete(ActionRequest request) {
ResponseBuilder responseBuilder = getResponseBuilder(request);
if (request.isSignInGranted()) {
responseBuilder
.add("You must meet all the requirements necessary to make a " +
"transaction. Try saying \"check transaction requirements\".")
.addSuggestions(new String[] {
"check requirements"
});
} else {
responseBuilder.add("You need to sign in before making a transaction.");
}
return responseBuilder.build();
}
JSON
{
"responseId": "d2123d8d-3f00-466e-b5a9-1a4ed53a7cb7-594de0a7",
"queryResult": {
"queryText": "actions_intent_SIGN_IN",
"parameters": {},
"allRequiredParamsPresent": true,
"fulfillmentMessages": [
{
"text": {
"text": [
""
]
}
}
],
"outputContexts": [
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/merchant_payment",
"lifespanCount": 2
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_web_browser"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_capability_screen_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_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/google_assistant_input_type_keyboard"
},
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/actions_intent_sign_in",
"parameters": {
"SIGN_IN": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
},
"text": ""
}
}
],
"intent": {
"name": "projects/df-transactions/agent/intents/105b925b-b186-4f5d-8bde-a9a782a0fa9f",
"displayName": "Sign In Complete"
},
"intentDetectionConfidence": 1,
"languageCode": "en"
},
"originalDetectIntentRequest": {
"source": "google",
"version": "2",
"payload": {
"user": {
"locale": "en-US",
"lastSeen": "2019-09-23T19:49:18Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy",
"type": "ACTIVE",
"conversationToken": "[]"
},
"inputs": [
{
"intent": "actions.intent.SIGN_IN",
"rawInputs": [
{
"inputType": "KEYBOARD"
}
],
"arguments": [
{
"name": "SIGN_IN",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
}
},
{
"name": "text"
}
]
}
],
"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:55:52Z",
"userVerificationStatus": "VERIFIED"
},
"conversation": {
"conversationId": "ABwppHGFwStZlYaQ9YT8rg9t_idVsxZrku1pUDrEbGSJmSUMatVdPwPEEQSCe1IwIBoN4sS4Weyn9pmgetEgbsWgw3JSvQmw",
"type": "ACTIVE",
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\"}}"
},
"inputs": [
{
"intent": "actions.intent.SIGN_IN",
"rawInputs": [
{}
],
"arguments": [
{
"name": "SIGN_IN",
"extension": {
"@type": "type.googleapis.com/google.actions.v2.SignInValue",
"status": "OK"
}
},
{
"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"
}
]
}
]
}
4. आदेश प्रस्तावित करें
ऑर्डर बनाने के बाद, आपको इसकी पुष्टि या अस्वीकार करने के लिए, इसे उपयोगकर्ता के सामने पेश करना होगा. actions.intent.TRANSACTION_DECISION इंटेंट के लिए अनुरोध करें और वह ऑर्डर दें जो आपने उपयोगकर्ता के सेव किए गए पेमेंट की जानकारी से बनाया है.
प्रयोक्ता अनुभव
actions.intent.TRANSACTION_DECISION इंटेंट का अनुरोध करने पर Assistant, पहले से मौजूद अनुभव देती है. इसमें आपके पास किया गया Order सीधे "कार्ट की झलक दिखाने वाले कार्ड" में रेंडर होता है. उपयोगकर्ता "ऑर्डर करो" कह सकते हैं,
लेन-देन अस्वीकार कर सकते हैं, क्रेडिट कार्ड या पते जैसा पेमेंट का विकल्प बदल सकते हैं या
ऑर्डर की सामग्री बदलने का अनुरोध कर सकते हैं.
इस समय, उपयोगकर्ता ऑर्डर में बदलाव करने का अनुरोध भी कर सकता है. इस मामले में, आपको यह पक्का करना चाहिए कि कार्ट असेंबली अनुभव पूरा करने के बाद आपका फ़ुलफ़िलमेंट, ऑर्डर में बदलाव के अनुरोधों को हैंडल कर सके.
ग्राहक का ऑर्डर पूरा करना
actions.intent.TRANSACTION_DECISION इंटेंट का अनुरोध करने पर, आपको ऐसा TransactionDecision बनाना होगा जिसमें Order के साथ-साथ orderOptions और paymentParameters भी शामिल हों. आपके paymentParameters ऑब्जेक्ट में एक merchantPaymentOption शामिल है. इस फ़ील्ड में मौजूद फ़ील्ड में, उपयोगकर्ता के पैसे चुकाने के तरीके की जानकारी होती है.
नीचे दिया गया कोड एक ऑर्डर के लिए TransactionsDecision का उदाहरण दिखाता है, जिसका पेमेंट Visa क्रेडिट कार्ड से किया गया था:
Node.js
conv.ask(new TransactionDecision({
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: order,
}));
Node.js
conv.ask(new TransactionDecision({
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: 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
MerchantPaymentMethod merchantPaymentMethod = new MerchantPaymentMethod()
.setPaymentMethodDisplayInfo(new PaymentMethodDisplayInfo()
.setPaymentMethodDisplayName("VISA **** 1234")
.setPaymentType("PAYMENT_CARD"))
.setPaymentMethodGroup("Payment method group")
.setPaymentMethodId("12345678")
.setPaymentMethodStatus(new PaymentMethodStatus()
.setStatus("STATUS_OK")
.setStatusMessage("Status message"));
MerchantPaymentOption merchantPaymentOption = new MerchantPaymentOption()
.setDefaultMerchantPaymentMethodId("12345678")
.setManagePaymentMethodUrl("https://example.com/managePayment")
.setMerchantPaymentMethod(Collections.singletonList(merchantPaymentMethod));
paymentParameters.setMerchantPaymentOption(merchantPaymentOption);
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
MerchantPaymentMethod merchantPaymentMethod = new MerchantPaymentMethod()
.setPaymentMethodDisplayInfo(new PaymentMethodDisplayInfo()
.setPaymentMethodDisplayName("VISA **** 1234")
.setPaymentType("PAYMENT_CARD"))
.setPaymentMethodGroup("Payment method group")
.setPaymentMethodId("12345678")
.setPaymentMethodStatus(new PaymentMethodStatus()
.setStatus("STATUS_OK")
.setStatusMessage("Status message"));
MerchantPaymentOption merchantPaymentOption = new MerchantPaymentOption()
.setDefaultMerchantPaymentMethodId("12345678")
.setManagePaymentMethodUrl("https://example.com/managePayment")
.setMerchantPaymentMethod(Collections.singletonList(merchantPaymentMethod));
paymentParameters.setMerchantPaymentOption(merchantPaymentOption);
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\"}}"
}
उपयोगकर्ता का फ़ैसला मैनेज करें
जब Assistant आपके मकसद को पूरा कर लेती है, तब वह आपको actions_intent_TRANSACTION_DECISION इंटेंट के साथ, लेन-देन के फ़ैसले के बारे में उपयोगकर्ता के जवाब भेजती है. आपको
लेन-देन रिकॉर्ड करने वाली वैल्यू वाला एक Argument मिलेगा. इस वैल्यू में नीचे दी गई चीज़ें शामिल होंगी:
transactionDecision- प्रस्तावित आदेश के बारे में उपयोगकर्ता का फ़ैसला. इसकी वैल्यूORDER_ACCEPTED,ORDER_REJECTED,DELIVERY_ADDRESS_UPDATED,CART_CHANGE_REQUESTED, औरUSER_CANNOT_TRANSACTहो सकती हैं.deliveryAddress- अगर उपयोगकर्ता ने डिलीवरी का पता बदल दिया है, तो डिलीवरी का अपडेट किया गया पता. इस मामले में,transactionDecisionकी वैल्यूDELIVERY_ADDRESS_UPDATEDहोगी.
इस अनुरोध को ठीक से मैनेज करने के लिए, actions_intent_TRANSACTION_DECISION इवेंट से ट्रिगर होने वाले Dialogflow इंटेंट का एलान करें. ट्रिगर होने पर, इसे
अपने ऑर्डर के मुताबिक करें:
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"
}
]
}
]
}
5. ऑर्डर पूरा करें और रसीद भेजें
जब actions.intent.TRANSACTION_DECISION इंटेंट, ORDER_ACCEPTED के
transactionDecision
के साथ वापस आता है, तो आपको ऑर्डर की "पुष्टि" करने के लिए, प्रोसेस की जा रही हर प्रोसेस तुरंत करनी होगी. जैसे, इसे अपने डेटाबेस में बनाए रखना और उपयोगकर्ता से शुल्क लेना.
आप इस जवाब के साथ बातचीत खत्म कर सकते हैं, लेकिन बातचीत जारी रखने के लिए आपको एक आसान जवाब शामिल करना होगा. जब शुरुआती orderUpdate की जानकारी सबमिट की जाती है, तो
उपयोगकर्ता को एक "छोटा किया गया रसीद कार्ड" दिखेगा. साथ ही, आपके जवाब के साथ-साथ अन्य जानकारी भी दिखेगी.
यह कार्ड उस रसीद की कॉपी दिखाएगा जो उपयोगकर्ता को उनके ऑर्डर के इतिहास में मिलेगी.
ऑर्डर की पुष्टि करते समय, आपके ऑर्डर ऑब्जेक्ट में एक userVisibleOrderId शामिल हो सकता है. यह वह आईडी होता है जो उपयोगकर्ता को ऑर्डर के लिए दिखता है. इस फ़ील्ड के लिए, अपने merchantOrderId
का फिर से इस्तेमाल किया जा सकता है.
OrderUpdate ऑब्जेक्ट के एक हिस्से में फ़ॉलो-अप कार्रवाई ऑब्जेक्ट होना चाहिए. यह ऑब्जेक्ट, ऑर्डर की जानकारी के सबसे नीचे यूआरएल बटन के तौर पर दिखना चाहिए, जो उपयोगकर्ता को अपने Assistant ऑर्डर के इतिहास में दिखेगा.
ग्राहक का ऑर्डर पूरा करना
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\"}}"
}
6. ऑर्डर के अपडेट भेजें
आपको उपयोगकर्ता को ऑर्डर की पूरी अवधि के बारे में जानकारी देते रहना होगा. ऑर्डर की स्थिति और जानकारी के साथ, ऑर्डर एपीआई को एचटीटीपी पैच अनुरोध भेजकर, उपयोगकर्ता के ऑर्डर के अपडेट भेजें.
ऑर्डर एपीआई के लिए एसिंक्रोनस अनुरोध सेट अप करना
ऑर्डर एपीआई को ऑर्डर अपडेट करने के अनुरोधों को ऐक्सेस टोकन से अनुमति दी जाती है. ऑर्डर अपडेट को ऑर्डर एपीआई में पैच करने के लिए, अपने Actions Console प्रोजेक्ट से जुड़ा JSON सेवा खाता कुंजी डाउनलोड करें. इसके बाद, सेवा खाता कुंजी को एक ऐसे बेयरर टोकन से बदलें जिसे एचटीटीपी अनुरोध के Authorization हेडर में भेजा जा सके.
सेवा खाते की कुंजी को वापस पाने के लिए, यह तरीका अपनाएं:
- Google Cloud कंसोल में, मेन्यू ≡ > एपीआई और सेवाएं > क्रेडेंशियल > क्रेडेंशियल बनाएं > सेवा खाता कुंजी पर जाएं.
- सेवा खाते में, नया सेवा खाता चुनें.
- सेवा खाते को
service-accountपर सेट करें. - भूमिका को प्रोजेक्ट > मालिक पर सेट करें.
- कुंजी के टाइप को JSON पर सेट करें.
- बनाएं चुनें.
- आपके कंप्यूटर पर एक निजी JSON सेवा खाता कुंजी डाउनलोड हो जाएगी.
अपने ऑर्डर अपडेट कोड में, Google API क्लाइंट लाइब्रेरी और "https://www.googleapis.com/auth/actions.order.developer" स्कोप का इस्तेमाल करके, अपनी सेवा कुंजी को बेयरर टोकन से बदला जा सकता है. एपीआई क्लाइंट लाइब्रेरी के GitHub पेज पर, आपको इंस्टॉल करने के तरीके और उदाहरण मिल सकते हैं.
की एक्सचेंज के उदाहरण के लिए, हमारे Node.js और Java में दिए गए सैंपल में, order-update.js का रेफ़रंस भी दिया जा सकता है.
ऑर्डर के अपडेट भेजें
सेवा खाते की कुंजी को OAuth बेयरर टोकन से बदलने के बाद, ऑर्डर के अपडेट को अनुमति वाले PATCH अनुरोधों के तौर पर, ऑर्डर एपीआई को भेजा जा सकता है.
ऑर्डर एपीआई यूआरएल:
PATCH https://actions.googleapis.com/v3/orders/${orderId}
अपने अनुरोध में ये हेडर दें:
"Authorization: Bearer token"को OAuth बेयरर टोकन के साथ बदला गया है. इसके लिए, आपने अपनी सेवा खाता कुंजी का इस्तेमाल किया है."Content-Type: application/json".
PATCH अनुरोध को JSON फ़ॉर्मैट में इस तरह लिखा जाना चाहिए:
{ "orderUpdate": OrderUpdate }
OrderUpdate
ऑब्जेक्ट में, ये टॉप लेवल फ़ील्ड होते हैं:
updateMask- ऑर्डर के वे फ़ील्ड जिन्हें अपडेट किया जा रहा है. ऑर्डर की स्थिति अपडेट करने के लिए, वैल्यू कोpurchase.status, purchase.userVisibleStatusLabelपर सेट करें.order- अपडेट का कॉन्टेंट. अगर ऑर्डर के कॉन्टेंट अपडेट किए जा रहे हैं, तो अपडेट किए गएOrderऑब्जेक्ट पर वैल्यू सेट करें. अगर ऑर्डर की स्थिति अपडेट की जा रही है (उदाहरण के लिए,"CONFIRMED"से"SHIPPED"में), तो ऑब्जेक्ट में ये फ़ील्ड शामिल होंगे:merchantOrderId- वही आईडी जिसे आपने अपनेOrderऑब्जेक्ट में सेट किया है.lastUpdateTime- इस अपडेट का टाइमस्टैंप.purchase- एक ऑब्जेक्ट जिसमें ये चीज़ें शामिल हैं:status- ऑर्डर की स्थितिPurchaseStatusके तौर पर, जैसे कि "SHIPPED" या "DELIVERED".userVisibleStatusLabel- उपयोगकर्ता को दिखने वाला लेबल, जो ऑर्डर की स्थिति के बारे में जानकारी देता है. जैसे, "आपका ऑर्डर भेज दिया गया है और प्रोसेस जारी है".
userNotificationऑब्जेक्ट, जो यह अपडेट भेजे जाने के बाद, उपयोगकर्ता के डिवाइस पर दिख सकता है. ध्यान दें कि इस ऑब्जेक्ट को शामिल करने से यह गारंटी नहीं मिलती कि उपयोगकर्ता के डिवाइस पर सूचना दिखेगी.
यह सैंपल कोड एक उदाहरण OrderUpdate दिखाता है, जो ऑर्डर की स्थिति को 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();
खरीदारी की स्थिति सेट करना
किसी ऑर्डर के अपडेट के status में, ऑर्डर की मौजूदा स्थिति के बारे में जानकारी होनी चाहिए. अपने अपडेट के order.purchase.status फ़ील्ड में, इनमें से किसी एक वैल्यू का इस्तेमाल करें:
CREATED- उपयोगकर्ता ने ऑर्डर स्वीकार कर लिया है और आपकी सेट की गई कार्रवाई के हिसाब से उसे "बनाया" गया है. हालांकि, इसके लिए आपके बैक-एंड पर मैन्युअल प्रोसेसिंग की ज़रूरत होती है.CONFIRMED- ऑर्डर चालू है और उसे पूरा करने के लिए प्रोसेस किया जा रहा है.IN_PREPARATION- ऑर्डर को शिपमेंट/डिलीवरी के लिए तैयार किया जा रहा है. जैसे कि खाना पकाया जा रहा है या कोई आइटम पैक किया जा रहा है.READY_FOR_PICKUP- पाने वाला व्यक्ति ऑर्डर ले सकता है.DELIVERED- ऑर्डर पाने वाले व्यक्ति को डिलीवर कर दिया गया हैOUT_OF_STOCK- ऑर्डर में मौजूद एक या उससे ज़्यादा सामान, स्टॉक में नहीं हैं.CHANGE_REQUESTED- उपयोगकर्ता ने ऑर्डर में बदलाव का अनुरोध किया है और बदलाव प्रोसेस किया जा रहा है.RETURNED- डिलीवरी के बाद, उपयोगकर्ता ने ऑर्डर वापस किया.REJECTED- अगर ऑर्डर को प्रोसेस, चार्ज या किसी और तरीके से "चालू" नहीं किया जा सका, तोCANCELLED- उपयोगकर्ता ने ऑर्डर रद्द कर दिया था.
आपको अपने लेन-देन के लिए प्रासंगिक हर एक स्थिति के लिए ऑर्डर के अपडेट भेजने चाहिए. उदाहरण के लिए, अगर आपके लेन-देन के लिए ऑर्डर लॉग करने के बाद उसे लॉग करने के लिए मैन्युअल तरीके से प्रोसेस करना ज़रूरी है, तो अतिरिक्त प्रोसेसिंग पूरी होने तक CREATED के लिए ऑर्डर का अपडेट भेजें. हर ऑर्डर के लिए, हर स्टेटस वैल्यू की ज़रूरत नहीं होती.
समस्या हल करना
अगर जांच के दौरान आपको कोई समस्या आती है, तो आपको लेन-देन से जुड़ी समस्या हल करने के हमारे तरीके पढ़ना चाहिए.