এই নির্দেশিকাটি আপনাকে একটি অ্যাকশন প্রকল্প তৈরির প্রক্রিয়ার মধ্য দিয়ে নিয়ে যাবে যা আপনার সাইটের দ্বারা পরিচালিত অর্থপ্রদানের পদ্ধতি ব্যবহার করে ভৌত পণ্যগুলির জন্য লেনদেনকে অন্তর্ভুক্ত করে।
লেনদেন প্রবাহ
যখন আপনার অ্যাকশন প্রকল্পটি বণিক-পরিচালিত অর্থপ্রদান ব্যবহার করে শারীরিক লেনদেন পরিচালনা করে, তখন এটি নিম্নলিখিত প্রবাহ ব্যবহার করে:
- তথ্য সংগ্রহ করুন (ঐচ্ছিক) - আপনার লেনদেনের প্রকৃতির উপর নির্ভর করে, আপনি কথোপকথনের শুরুতে ব্যবহারকারীর কাছ থেকে নিম্নলিখিত তথ্য সংগ্রহ করতে চাইতে পারেন:
- লেনদেনের প্রয়োজনীয়তা যাচাই করুন - ব্যবহারকারীর কার্ট তৈরি করার আগে ব্যবহারকারীর অর্থপ্রদানের তথ্য সঠিকভাবে কনফিগার করা এবং উপলব্ধ কিনা তা নিশ্চিত করতে কথোপকথনের শুরুতে লেনদেনের প্রয়োজনীয়তা সহায়ক ব্যবহার করুন।
- একটি ডেলিভারি ঠিকানার অনুরোধ করুন - যদি আপনার লেনদেনের জন্য একটি ডেলিভারি ঠিকানার প্রয়োজন হয়, ব্যবহারকারীর কাছ থেকে একটি সংগ্রহ করার জন্য ডেলিভারি ঠিকানা সাহায্যকারীর অভিপ্রায় পূরণের অনুরোধ করুন।
- অর্ডার তৈরি করুন - ব্যবহারকারীকে একটি "কার্ট অ্যাসেম্বলি" এর মাধ্যমে নিয়ে যান যেখানে তারা কোন আইটেম কিনতে চান তা বেছে নেন।
- অ্যাকাউন্ট লিঙ্কিং সঞ্চালন করুন - ব্যবহারকারীর জন্য একটি অর্থপ্রদানের পদ্ধতি ব্যবহার করতে যাতে তারা আপনার পরিষেবার সাথে সংরক্ষণ করেছে, আপনার পরিষেবাতে তাদের Google অ্যাকাউন্টের সাথে তাদের Google অ্যাকাউন্ট সংযুক্ত করতে অ্যাকাউন্ট লিঙ্কিং ব্যবহার করুন৷
- অর্ডার প্রস্তাব করুন - একবার কার্ট সম্পূর্ণ হলে, ব্যবহারকারীর কাছে অর্ডারটি প্রস্তাব করুন যাতে তারা নিশ্চিত করতে পারে যে এটি সঠিক। অর্ডার কনফার্ম হলে, আপনি অর্ডারের বিবরণ এবং পেমেন্ট টোকেন সহ একটি প্রতিক্রিয়া পাবেন।
- অর্ডারটি চূড়ান্ত করুন এবং একটি রসিদ পাঠান - অর্ডার নিশ্চিত হওয়ার সাথে সাথে আপনার ইনভেন্টরি ট্র্যাকিং বা অন্যান্য পরিপূর্ণতা পরিষেবা আপডেট করুন তারপর ব্যবহারকারীকে একটি রসিদ পাঠান।
- অর্ডার আপডেট পাঠান - অর্ডার পূরণের জীবনকাল ধরে, অর্ডার এপিআই-এ প্যাচ অনুরোধ পাঠিয়ে ব্যবহারকারীকে অর্ডার আপডেট দিন।
সীমাবদ্ধতা এবং পর্যালোচনা নির্দেশিকা
মনে রাখবেন যে অতিরিক্ত নীতিগুলি লেনদেনের সাথে অ্যাকশনগুলিতে প্রযোজ্য। লেনদেনের সাথে অ্যাকশন পর্যালোচনা করতে আমাদের ছয় সপ্তাহ পর্যন্ত সময় লাগতে পারে, তাই আপনার প্রকাশের সময়সূচী পরিকল্পনা করার সময় সেই সময়টিকে বিবেচনা করুন। পর্যালোচনা প্রক্রিয়া সহজ করতে, পর্যালোচনার জন্য আপনার অ্যাকশন জমা দেওয়ার আগে আপনি লেনদেনের জন্য নীতি এবং নির্দেশিকা মেনে চলছেন তা নিশ্চিত করুন।
আপনি শুধুমাত্র নিম্নলিখিত দেশে ভৌত পণ্য বিক্রি করে এমন অ্যাকশন স্থাপন করতে পারেন:
| অস্ট্রেলিয়া ব্রাজিল কানাডা ইন্দোনেশিয়া | জাপান মেক্সিকো কাতার রাশিয়া | সিঙ্গাপুর সুইজারল্যান্ড থাইল্যান্ড তুরস্ক যুক্তরাজ্য যুক্তরাষ্ট্র |
আপনার প্রকল্প তৈরি করুন
লেনদেন সংক্রান্ত কথোপকথনের বিস্তৃত উদাহরণের জন্য, Node.js এবং Java- তে আমাদের লেনদেনের নমুনাগুলি দেখুন।
প্রকল্প সেটআপ
আপনার অ্যাকশন তৈরি করার সময়, আপনাকে অবশ্যই নির্দিষ্ট করতে হবে যে আপনি অ্যাকশন কনসোলে লেনদেন করতে চান। এছাড়াও, আপনি যদি Node.JS ক্লায়েন্ট লাইব্রেরি ব্যবহার করেন, তাহলে অর্ডার API-এর সর্বশেষ সংস্করণ ব্যবহার করার জন্য আপনার পূর্ণতা সেট আপ করুন।
আপনার প্রকল্প এবং পরিপূর্ণতা সেট আপ করতে, নিম্নলিখিতগুলি করুন:
- একটি নতুন প্রকল্প তৈরি করুন বা একটি বিদ্যমান প্রকল্প আমদানি করুন।
- Deploy > ডিরেক্টরির তথ্যে নেভিগেট করুন।
অতিরিক্ত তথ্যের অধীনে > লেনদেন > বাক্সটি চেক করুন যা বলে যে "আপনার অ্যাকশনগুলি কি ভৌত পণ্যের লেনদেন করতে লেনদেন API ব্যবহার করে?"।
আপনি যদি আপনার অ্যাকশনের পূর্ণতা তৈরি করতে 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 Assertion ফ্লো সক্রিয় করার সুপারিশ করছি কারণ এটি একটি খুব সুগমিত ব্যবহারকারীর অভিজ্ঞতা সক্ষম করে।
আমরা actions.intent.SIGN_IN অভিপ্রায় প্রদান করি যা আপনাকে অনুরোধ করতে দেয় যে একজন ব্যবহারকারী কথোপকথনের মাঝামাঝি অ্যাকাউন্ট লিঙ্ক করে। actions.intent.SIGN_IN উদ্দেশ্য ব্যবহার করতে আপনাকে অবশ্যই অ্যাকশন কনসোলে অ্যাকাউন্ট লিঙ্কিং সক্ষম করতে হবে ।
আপনি যদি ওয়েবহুক অনুরোধে User অবজেক্টে accessToken খুঁজে না পান তবে আপনার এই অভিপ্রায়টি ব্যবহার করা উচিত। এর মানে হল যে ব্যবহারকারী এখনও তাদের অ্যাকাউন্ট লিঙ্ক করেননি।
actions.intent.SIGN_IN অভিপ্রায় অনুরোধ করার পরে, আপনি "OK" , "CANCELLED" বা "ERROR" এর মান সহ একটি SignInStatus সম্বলিত একটি Argument পাবেন৷ স্ট্যাটাস "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'));জাভা
@ForIntent("Sign In")
public ActionResponse signIn(ActionRequest request) {
return getResponseBuilder(request).add(
new SignIn()
.setContext("To get your account details"))
.build();
}জাভা
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`));
}
});জাভা
@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();
}জাভা
@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. তথ্য সংগ্রহ করুন (ঐচ্ছিক)
1 ক. লেনদেনের প্রয়োজনীয়তা যাচাই করুন (ঐচ্ছিক)
ব্যবহারকারীর অভিজ্ঞতা
ব্যবহারকারীরা একটি লেনদেন সম্পাদন করতে সক্ষম হবে কিনা তা দ্রুত পরীক্ষা করতে actions.intent.TRANSACTION_REQUIREMENTS_CHECK অভিপ্রায়টি ট্রিগার করুন৷ এই পদক্ষেপটি নিশ্চিত করবে যে ব্যবহারকারীরা এগিয়ে যেতে পারেন এবং তাদের একটি লেনদেন সম্পূর্ণ করতে বাধা দেয় এমন কোনো সেটিংস ঠিক করার সুযোগ দেবে।
উদাহরণস্বরূপ, যখন আহ্বান করা হয়, তখন আপনার অ্যাকশন জিজ্ঞাসা করতে পারে, "আপনি কি জুতা অর্ডার করতে চান, নাকি আপনার অ্যাকাউন্টের ব্যালেন্স পরীক্ষা করতে চান?" ব্যবহারকারী যদি বলে "জুতা অর্ডার করুন", তাহলে আপনাকে অবিলম্বে এই অভিপ্রায়ের জন্য অনুরোধ করা উচিত, যা নিশ্চিত করবে যে তারা এগিয়ে যেতে পারে এবং তাদের লেনদেন চালিয়ে যাওয়া থেকে বাধা দেয় এমন কোনো সেটিংস ঠিক করার সুযোগ দেবে।
লেনদেনের প্রয়োজনীয়তা যাচাই করার জন্য অনুরোধ করলে নিম্নলিখিত ফলাফলগুলির মধ্যে একটি হবে:
- যদি প্রয়োজনীয়তাগুলি পূরণ করা হয়, অভিপ্রায়টি সাফল্যের শর্তের সাথে আপনার পূরণে ফেরত পাঠানো হবে এবং আপনি ব্যবহারকারীর অর্ডার তৈরির সাথে এগিয়ে যেতে পারেন।
- যদি এক বা একাধিক প্রয়োজনীয়তা পূরণ করা না যায়, তাহলে অভিপ্রায়টি ব্যর্থতার শর্তে আপনার পূরণে ফেরত পাঠানো হবে। এই ক্ষেত্রে, আপনার উচিত লেনদেনের অভিজ্ঞতা থেকে কথোপকথনটিকে দূরে সরিয়ে দেওয়া বা কথোপকথনটি শেষ করা।
- যদি ব্যর্থতার অবস্থার ফলে কোনো ত্রুটি ব্যবহারকারী দ্বারা সংশোধন করা যায়, তাহলে তাদের ডিভাইসে সেই সমস্যাগুলি সমাধান করার জন্য অনুরোধ করা হবে। যদি কথোপকথনটি শুধুমাত্র ভয়েসের পৃষ্ঠে সংঘটিত হয় তবে ব্যবহারকারীর ফোনে একটি হ্যান্ডঅফ শুরু করা হবে।
পূর্ণতা
একজন ব্যবহারকারী লেনদেনের প্রয়োজনীয়তা পূরণ করেছে তা নিশ্চিত করতে, একটি TransactionRequirementsCheckSpec অবজেক্টের সাথে actions.intent.TRANSACTION_REQUIREMENTS_CHECK উদ্দেশ্য পূরণের অনুরোধ করুন।
প্রয়োজনীয়তা পরীক্ষা করুন
ক্লায়েন্ট লাইব্রেরি ব্যবহার করে একজন ব্যবহারকারী লেনদেনের প্রয়োজনীয়তা পূরণ করে কিনা তা আপনি দেখতে পারেন:
Node.js
conv.ask(new TransactionRequirements());
Node.js
conv.ask(new TransactionRequirements());
জাভা
return getResponseBuilder(request)
.add(new TransactionRequirements())
.build();জাভা
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\"}}"
}একটি প্রয়োজনীয়তা চেক ফলাফল পান
অ্যাসিস্ট্যান্ট অভিপ্রায় পূরণ করার পরে, এটি চেকের ফলাফল সহ actions.intent.TRANSACTION_REQUIREMENTS_CHECK উদ্দেশ্য সহ আপনার পূরণের অনুরোধ পাঠায়। এই অনুরোধটি সঠিকভাবে পরিচালনা করতে, একটি ডায়ালগফ্লো অভিপ্রায় ঘোষণা করুন যা actions_intent_TRANSACTION_REQUIREMENTS_CHECK ইভেন্ট দ্বারা ট্রিগার হয়েছে৷ ট্রিগার করা হলে, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আপনার পরিপূর্ণতায় এটি পরিচালনা করুন:
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.');
}
});জাভা
@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();
}জাভা
@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"
}
]
}
]
}1 খ. একটি বিতরণ ঠিকানা অনুরোধ করুন (ঐচ্ছিক)
আপনার লেনদেনের জন্য ব্যবহারকারীর ডেলিভারি ঠিকানার প্রয়োজন হলে, আপনি actions.intent.DELIVERY_ADDRESS উদ্দেশ্য পূরণের অনুরোধ করতে পারেন। এটি মোট মূল্য, ডেলিভারি/পিকআপ অবস্থান নির্ধারণের জন্য বা ব্যবহারকারী আপনার পরিষেবা অঞ্চলের মধ্যে রয়েছে তা নিশ্চিত করার জন্য কার্যকর হতে পারে।
এই অভিপ্রায়টি পূরণ করার অনুরোধ করার সময়, আপনি একটি reason বিকল্পে পাস করেন যা আপনাকে একটি স্ট্রিং সহ একটি ঠিকানা পাওয়ার জন্য সহকারীর অনুরোধের প্রস্তাবনা করতে দেয়৷ উদাহরণস্বরূপ, আপনি যদি "অর্ডারটি কোথায় পাঠাতে হবে তা জানতে" উল্লেখ করলে, সহকারী ব্যবহারকারীকে জিজ্ঞাসা করতে পারে:
"কোথায় অর্ডার পাঠাতে হবে তা জানতে, আমাকে আপনার ডেলিভারির ঠিকানা পেতে হবে"
ব্যবহারকারীর অভিজ্ঞতা
স্ক্রীন সহ পৃষ্ঠগুলিতে, ব্যবহারকারী লেনদেনের জন্য কোন ঠিকানাটি ব্যবহার করতে চান তা চয়ন করবেন৷ যদি তারা আগে কোনো ঠিকানা না দিয়ে থাকে, তাহলে তারা একটি নতুন ঠিকানা লিখতে পারবে।
শুধুমাত্র ভয়েস সারফেসে, অ্যাসিস্ট্যান্ট ব্যবহারকারীর কাছে লেনদেনের জন্য তাদের ডিফল্ট ঠিকানা শেয়ার করার অনুমতি চাইবে। যদি তারা আগে কোনো ঠিকানা না দিয়ে থাকে, তাহলে কথোপকথনটি প্রবেশের জন্য একটি ফোনে হস্তান্তর করা হবে।
ঠিকানা অনুরোধ করুন
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',
},
}));জাভা
@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();
}জাভা
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\"}}"
}ঠিকানা গ্রহণ করুন
সহকারী অভিপ্রায় পূরণ করার পরে, এটি actions.intent.DELIVERY_ADDRESS অভিপ্রায় সহ আপনার পূরণের অনুরোধ পাঠায়।
এই অনুরোধটি সঠিকভাবে পরিচালনা করতে, একটি ডায়ালগফ্লো অভিপ্রায় ঘোষণা করুন যা actions_intent_DELIVERY_ADDRESS ইভেন্ট দ্বারা ট্রিগার হয়েছে৷ ট্রিগার করা হলে, ক্লায়েন্ট লাইব্রেরি ব্যবহার করে আপনার পরিপূর্ণতায় এটি পরিচালনা করুন:
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.');
}
});জাভা
@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();
}জাভা
@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',
},
};জাভা
// 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);জাভা
// 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 Assertion ফ্লো সক্রিয় করার সুপারিশ করছি কারণ এটি একটি খুব সুগমিত ব্যবহারকারীর অভিজ্ঞতা সক্ষম করে।
আমরা actions.intent.SIGN_IN অভিপ্রায় প্রদান করি যা আপনাকে অনুরোধ করতে দেয় যে একজন ব্যবহারকারী কথোপকথনের মাঝামাঝি অ্যাকাউন্ট লিঙ্ক করে। actions.intent.SIGN_IN উদ্দেশ্য ব্যবহার করতে আপনাকে অবশ্যই অ্যাকশন কনসোলে অ্যাকাউন্ট লিঙ্কিং সক্ষম করতে হবে ।
আপনি যদি ওয়েবহুক অনুরোধে User অবজেক্টে accessToken খুঁজে না পান তবে আপনার এই অভিপ্রায়টি ব্যবহার করা উচিত। এর মানে হল যে ব্যবহারকারী এখনও তাদের অ্যাকাউন্ট লিঙ্ক করেননি।
actions.intent.SIGN_IN অভিপ্রায় অনুরোধ করার পরে, আপনি "OK" , "CANCELLED" বা "ERROR" এর মান সহ একটি SignInStatus সম্বলিত একটি Argument পাবেন৷ স্ট্যাটাস "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'));জাভা
@ForIntent("Sign In")
public ActionResponse signIn(ActionRequest request) {
return getResponseBuilder(request).add(
new SignIn()
.setContext("To get your account details"))
.build();
}জাভা
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`));
}
});জাভা
@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();
}জাভা
@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 অভিপ্রায়ের জন্য অনুরোধ করেন, তখন সহকারী একটি অন্তর্নির্মিত অভিজ্ঞতা শুরু করে যেখানে আপনি যে Order দিয়েছিলেন তা সরাসরি একটি "কার্ট প্রিভিউ কার্ড"-এ রেন্ডার করা হয়। ব্যবহারকারী বলতে পারেন "অর্ডার করুন", লেনদেন প্রত্যাখ্যান করতে পারেন, ক্রেডিট কার্ড বা ঠিকানার মতো একটি অর্থপ্রদানের বিকল্প পরিবর্তন করতে পারেন বা অর্ডারের বিষয়বস্তু পরিবর্তন করার অনুরোধ করতে পারেন৷
ব্যবহারকারী এই সময়ে অর্ডার পরিবর্তনের অনুরোধ করতে পারেন। এই ক্ষেত্রে, আপনার নিশ্চিত হওয়া উচিত যে আপনার পূরণটি কার্ট সমাবেশের অভিজ্ঞতা শেষ করার পরে অর্ডার পরিবর্তনের অনুরোধগুলি পরিচালনা করতে পারে।
পূর্ণতা
আপনি যখন actions.intent.TRANSACTION_DECISION অভিপ্রায়ের জন্য অনুরোধ করবেন, তখন আপনি একটি TransactionDecision তৈরি করবেন যাতে Order পাশাপাশি orderOptions এবং paymentParameters থাকে। আপনার paymentParameters merchantPaymentOption এমন ক্ষেত্র রয়েছে যা ব্যবহারকারীর অর্থপ্রদানের পদ্ধতি বর্ণনা করে।
নিম্নলিখিত কোডটি একটি ভিসা ক্রেডিট কার্ড ব্যবহার করে অর্থপ্রদানের একটি অর্ডারের জন্য TransactionsDecision একটি উদাহরণ দেখায়:
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,
}));জাভা
// 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();জাভা
// 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\"}}"
}ব্যবহারকারীর সিদ্ধান্ত হ্যান্ডেল
অ্যাসিস্ট্যান্ট অভিপ্রায় পূরণ করার পরে, এটি লেনদেনের সিদ্ধান্তের ব্যবহারকারীর উত্তর সহ actions_intent_TRANSACTION_DECISION উদ্দেশ্য সহ আপনার পূরণের অনুরোধ পাঠায়। আপনি একটি TransactionDecisionValue সম্বলিত একটি Argument পাবেন। এই মান নিম্নলিখিত ধারণ করবে:
-
transactionDecision- প্রস্তাবিত আদেশের বিষয়ে ব্যবহারকারীর সিদ্ধান্ত। সম্ভাব্য মানগুলি হলORDER_ACCEPTED,ORDER_REJECTED,DELIVERY_ADDRESS_UPDATED,CART_CHANGE_REQUESTED, এবংUSER_CANNOT_TRANSACT। -
deliveryAddress- একটি আপডেট ডেলিভারি ঠিকানা, যদি ব্যবহারকারী তাদের ডেলিভারি ঠিকানা পরিবর্তন করে। এই ক্ষেত্রে,transactionDecisionমান হবেDELIVERY_ADDRESS_UPDATED।
এই অনুরোধটি সঠিকভাবে পরিচালনা করতে, একটি ডায়ালগফ্লো অভিপ্রায় ঘোষণা করুন যা actions_intent_TRANSACTION_DECISION ইভেন্ট দ্বারা ট্রিগার হয়েছে৷ ট্রিগার করা হলে, আপনার পূর্ণতায় এটি পরিচালনা করুন:
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;
}জাভা
// 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"));
}জাভা
// 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 অবজেক্টের অংশে একটি ফলো-আপ অ্যাকশন অবজেক্ট থাকতে হবে, যেটি অর্ডারের বিবরণের নীচে ইউআরএল বোতাম হিসেবে প্রকাশ করে যা ব্যবহারকারী তাদের অ্যাসিস্ট্যান্ট অর্ডার ইতিহাসে খুঁজে পেতে পারেন।
পূর্ণতা
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,
}));জাভা
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));জাভা
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. অর্ডার আপডেট পাঠান
আপনাকে ব্যবহারকারীকে তার জীবদ্দশায় অর্ডারের স্থিতি সম্পর্কে অবহিত রাখতে হবে। অর্ডার স্থিতি এবং বিশদ বিবরণ সহ অর্ডার API এ HTTP প্যাচ অনুরোধ পাঠিয়ে ব্যবহারকারীর অর্ডার আপডেট পাঠান।
অর্ডার API এ অ্যাসিঙ্ক্রোনাস অনুরোধ সেট আপ করুন
অর্ডার এপিআই-তে অর্ডার আপডেট করার অনুরোধগুলি একটি অ্যাক্সেস টোকেন দ্বারা অনুমোদিত। অর্ডার API-এ একটি অর্ডার আপডেট প্যাচ করতে, আপনার অ্যাকশন কনসোল প্রকল্পের সাথে যুক্ত একটি JSON পরিষেবা অ্যাকাউন্ট কী ডাউনলোড করুন, তারপর একটি বাহক টোকেনের জন্য পরিষেবা অ্যাকাউন্ট কীটি বিনিময় করুন যা HTTP অনুরোধের Authorization শিরোনামে পাস করা যেতে পারে।
আপনার পরিষেবা অ্যাকাউন্ট কী পুনরুদ্ধার করতে, নিম্নলিখিত পদক্ষেপগুলি সম্পাদন করুন:
- Google ক্লাউড কনসোলে , মেনুতে যান ☰ > APIs এবং পরিষেবাগুলি > শংসাপত্র > শংসাপত্র তৈরি করুন > পরিষেবা অ্যাকাউন্ট কী ।
- পরিষেবা অ্যাকাউন্টের অধীনে, নতুন পরিষেবা অ্যাকাউন্ট নির্বাচন করুন।
- পরিষেবা অ্যাকাউন্ট
service-accountসেট করুন। - প্রকল্প > মালিকের ভূমিকা সেট করুন।
- JSON- এ কী টাইপ সেট করুন।
- তৈরি করুন নির্বাচন করুন।
- একটি ব্যক্তিগত JSON পরিষেবা অ্যাকাউন্ট কী আপনার স্থানীয় মেশিনে ডাউনলোড করা হবে।
আপনার অর্ডার আপডেট কোডে, আপনি Google APIs ক্লায়েন্ট লাইব্রেরি এবং "https://www.googleapis.com/auth/actions.order.developer" সুযোগ ব্যবহার করে একটি বাহক টোকেনের জন্য আপনার পরিষেবা কী বিনিময় করতে পারেন৷ আপনি API ক্লায়েন্ট লাইব্রেরি GitHub পৃষ্ঠায় ইনস্টলেশন পদক্ষেপ এবং উদাহরণ খুঁজে পেতে পারেন।
আপনি একটি উদাহরণ কী বিনিময়ের জন্য আমাদের Node.js এবং Java নমুনায় order-update.js উল্লেখ করতে পারেন।
অর্ডার আপডেট পাঠান
একবার আপনি একটি OAuth বহনকারী টোকেনের জন্য আপনার পরিষেবা অ্যাকাউন্ট কী বিনিময় করলে, আপনি অর্ডার এপিআই-এ অনুমোদিত প্যাচ অনুরোধ হিসাবে অর্ডার আপডেট পাঠাতে পারেন।
অর্ডার API URL: PATCH https://actions.googleapis.com/v3/orders/${orderId}
আপনার অনুরোধে নিম্নলিখিত শিরোনামগুলি প্রদান করুন:
-
"Authorization: Bearer token"OAuth বহনকারী টোকেনের সাথে আপনি আপনার পরিষেবা অ্যাকাউন্ট কী বিনিময় করেছেন৷ -
"Content-Type: application/json"।
প্যাচ অনুরোধে নিম্নলিখিত বিন্যাসের একটি JSON বডি নেওয়া উচিত:
{ "orderUpdate": OrderUpdate }
OrderUpdate অবজেক্টটি নিম্নলিখিত শীর্ষ-স্তরের ক্ষেত্রগুলি নিয়ে গঠিত:
-
updateMask- অর্ডারের ক্ষেত্রগুলি যা আপনি আপডেট করছেন। অর্ডার স্ট্যাটাস আপডেট করতে, মান নির্ধারণ করুনpurchase.status, purchase.userVisibleStatusLabel। order- আপডেটের বিষয়বস্তু। আপনি যদি অর্ডারের বিষয়বস্তু আপডেট করছেন, তাহলে মানটিকে আপডেট করাOrderঅবজেক্টে সেট করুন। আপনি যদি অর্ডারের স্থিতি আপডেট করেন (উদাহরণস্বরূপ,"CONFIRMED"থেকে"SHIPPED") অবজেক্টে নিম্নলিখিত ক্ষেত্রগুলি রয়েছে:-
merchantOrderId- একই আইডি আপনি আপনারOrderঅবজেক্টে সেট করেছেন। -
lastUpdateTime- এই আপডেটের টাইমস্ট্যাম্প। -
purchase- নিম্নলিখিত সমন্বিত একটি বস্তু:-
status- একটিPurchaseStatusহিসাবে অর্ডারের স্থিতি, যেমন "SHIPPED" বা "DELIVERED"৷ -
userVisibleStatusLabel- একটি ব্যবহারকারী-মুখী লেবেল যা অর্ডার স্থিতির বিশদ প্রদান করে, যেমন "আপনার অর্ডার পাঠানো হয়েছে এবং পথে চলছে"।
-
-
userNotification(ঐচ্ছিক) - একটি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.`);
}জাভা
// 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();জাভা
// 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 অর্ডার আপডেট পাঠান। প্রতিটি অর্ডার প্রতিটি স্ট্যাটাস মান প্রয়োজন হয় না.
সমস্যা সমাধান
পরীক্ষার সময় আপনি যদি কোনো সমস্যায় পড়েন, তাহলে আপনাকে লেনদেনের জন্য আমাদের সমস্যা সমাধানের পদক্ষেপগুলি পড়তে হবে।