এই নির্দেশিকা আপনাকে একটি অ্যাকশন প্রজেক্ট তৈরি করার প্রক্রিয়ার মধ্য দিয়ে নিয়ে যাবে যা প্রকৃত পণ্যের জন্য লেনদেনকে অন্তর্ভুক্ত করে এবং অর্থপ্রদানের জন্য Google Pay ব্যবহার করে।
লেনদেন প্রবাহ
যখন আপনার অ্যাকশন প্রোজেক্ট Google Pay ব্যবহার করে শারীরিক লেনদেন পরিচালনা করে, তখন এটি নিম্নলিখিত ফ্লো ব্যবহার করে:
- তথ্য সংগ্রহ করুন (ঐচ্ছিক) - আপনার লেনদেনের প্রকৃতির উপর নির্ভর করে, আপনি কথোপকথনের শুরুতে ব্যবহারকারীর কাছ থেকে নিম্নলিখিত তথ্য সংগ্রহ করতে চাইতে পারেন।
- লেনদেনের প্রয়োজনীয়তা যাচাই করুন - ব্যবহারকারীর কার্ট তৈরি করার আগে ব্যবহারকারীর অর্থপ্রদানের তথ্য সঠিকভাবে কনফিগার করা এবং উপলব্ধ কিনা তা নিশ্চিত করতে কথোপকথনের শুরুতে লেনদেনের প্রয়োজনীয়তা সহায়ক ব্যবহার করুন।
- একটি ডেলিভারি ঠিকানার অনুরোধ করুন - যদি আপনার লেনদেনের জন্য একটি ডেলিভারি ঠিকানার প্রয়োজন হয়, ব্যবহারকারীর কাছ থেকে একটি সংগ্রহ করার জন্য ডেলিভারি ঠিকানা সাহায্যকারীর অভিপ্রায় পূরণের অনুরোধ করুন।
- অর্ডার তৈরি করুন - ব্যবহারকারীকে একটি "কার্ট অ্যাসেম্বলি" এর মাধ্যমে নিয়ে যান যেখানে তারা কোন আইটেম কিনতে চান তা বেছে নেন।
- অর্ডার প্রস্তাব করুন - একবার কার্ট সম্পূর্ণ হলে, ব্যবহারকারীর কাছে অর্ডারটি প্রস্তাব করুন যাতে তারা নিশ্চিত করতে পারে যে এটি সঠিক। অর্ডার কনফার্ম হলে, আপনি অর্ডারের বিবরণ এবং পেমেন্ট টোকেন সহ একটি প্রতিক্রিয়া পাবেন।
- অর্ডারটি চূড়ান্ত করুন এবং একটি রসিদ পাঠান - অর্ডার নিশ্চিত হওয়ার সাথে সাথে আপনার ইনভেন্টরি ট্র্যাকিং বা অন্যান্য পরিপূর্ণতা পরিষেবা আপডেট করুন এবং তারপর ব্যবহারকারীকে একটি রসিদ পাঠান।
- অর্ডার আপডেট পাঠান - অর্ডার পূরণের জীবনকাল ধরে, অর্ডার এপিআই-এ প্যাচ অনুরোধ পাঠিয়ে ব্যবহারকারীকে অর্ডার আপডেট দিন।
সীমাবদ্ধতা এবং পর্যালোচনা নির্দেশিকা
মনে রাখবেন যে অতিরিক্ত নীতিগুলি লেনদেনের সাথে অ্যাকশনগুলিতে প্রযোজ্য। লেনদেনের সাথে অ্যাকশন পর্যালোচনা করতে আমাদের ছয় সপ্তাহ পর্যন্ত সময় লাগতে পারে, তাই আপনার প্রকাশের সময়সূচী পরিকল্পনা করার সময় সেই সময়টিকে বিবেচনা করুন। পর্যালোচনা প্রক্রিয়া সহজ করতে, পর্যালোচনার জন্য আপনার অ্যাকশন জমা দেওয়ার আগে আপনি লেনদেনের জন্য নীতি এবং নির্দেশিকা মেনে চলছেন তা নিশ্চিত করুন।
আপনি শুধুমাত্র নিম্নলিখিত দেশে ভৌত পণ্য বিক্রি করে এমন অ্যাকশন স্থাপন করতে পারেন:
| অস্ট্রেলিয়া ব্রাজিল কানাডা ইন্দোনেশিয়া | জাপান মেক্সিকো কাতার রাশিয়া | সিঙ্গাপুর সুইজারল্যান্ড থাইল্যান্ড তুরস্ক যুক্তরাজ্য মার্কিন যুক্তরাষ্ট্র |
আপনার প্রকল্প তৈরি করুন
লেনদেন সংক্রান্ত কথোপকথনের বিস্তৃত উদাহরণের জন্য, 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,
});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,
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Looks like you're good to go! Next I'll need your delivery address.Try saying \"get delivery address\"."
}
}
],
"suggestions": [
{
"title": "get delivery address"
}
]
}
}
}
}JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.TEXT"
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Looks like you're good to go! Next I'll need your delivery address.Try saying \"get delivery address\"."
}
}
],
"suggestions": [
{
"title": "get delivery address"
}
]
}
}
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"google_payment\"}}"
}একটি প্রয়োজনীয়তা চেক ফলাফল পান
অ্যাসিস্ট্যান্ট অভিপ্রায় পূরণ করার পরে, এটি চেকের ফলাফল সহ 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. আদেশ প্রস্তাব
একবার আপনি একটি অর্ডার তৈরি করলে, নিশ্চিত বা প্রত্যাখ্যান করার জন্য আপনাকে অবশ্যই এটি ব্যবহারকারীর কাছে উপস্থাপন করতে হবে। actions.intent.TRANSACTION_DECISION অভিপ্রায়ের অনুরোধ করুন এবং আপনার তৈরি করা অর্ডারটি প্রদান করুন।
ব্যবহারকারীর অভিজ্ঞতা
আপনি যখন actions.intent.TRANSACTION_DECISION অভিপ্রায়ের জন্য অনুরোধ করেন, তখন সহকারী একটি অন্তর্নির্মিত অভিজ্ঞতা শুরু করে যেখানে আপনি যে Order দিয়েছিলেন তা সরাসরি একটি "কার্ট প্রিভিউ কার্ড"-এ রেন্ডার করা হয়। ব্যবহারকারী বলতে পারেন "অর্ডার করুন", লেনদেন প্রত্যাখ্যান করতে পারেন, ক্রেডিট কার্ড বা ঠিকানার মতো একটি অর্থপ্রদানের বিকল্প পরিবর্তন করতে পারেন বা অর্ডারের বিষয়বস্তু পরিবর্তন করার অনুরোধ করতে পারেন৷
ব্যবহারকারী এই সময়ে অর্ডার পরিবর্তনের অনুরোধ করতে পারেন। এই ক্ষেত্রে, আপনার নিশ্চিত হওয়া উচিত যে আপনার পূরণটি কার্ট সমাবেশের অভিজ্ঞতা শেষ করার পরে অর্ডার পরিবর্তনের অনুরোধগুলি পরিচালনা করতে পারে।
পূর্ণতা
আপনি যখন actions.intent.TRANSACTION_DECISION অভিপ্রায়ের জন্য অনুরোধ করবেন, তখন আপনি একটি TransactionDecision তৈরি করবেন যাতে Order পাশাপাশি orderOptions এবং paymentParameters থাকে।
আপনার paymentParameters অবজেক্টে টোকেনাইজেশন প্যারামিটার অন্তর্ভুক্ত থাকবে যা আপনি কোন Google Pay প্রসেসর ব্যবহার করার পরিকল্পনা করছেন তার উপর নির্ভর করে (যেমন স্ট্রাইপ, ব্রেনট্রি, এসিআই ইত্যাদি)।
নিম্নলিখিত কোড একটি অর্ডারের জন্য একটি উদাহরণ TransactionsDecision দেখায়:
Node.js
conv.ask(new TransactionDecision({
orderOptions: {
userInfoOptions: {
userInfoProperties: [
'EMAIL',
],
},
},
paymentParameters: {
googlePaymentOption: {
// facilitationSpec is expected to be a serialized JSON string
facilitationSpec: JSON.stringify({
apiVersion: 2,
apiVersionMinor: 0,
merchantInfo: {
merchantName: 'Example Merchant',
},
allowedPaymentMethods: [
{
type: 'CARD',
parameters: {
allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
allowedCardNetworks: [
'AMEX', 'DISCOVER', 'JCB', 'MASTERCARD', 'VISA'],
},
tokenizationSpecification: {
type: 'PAYMENT_GATEWAY',
parameters: {
gateway: 'example',
gatewayMerchantId: 'exampleGatewayMerchantId',
},
},
},
],
transactionInfo: {
totalPriceStatus: 'FINAL',
totalPrice: '15.77',
currencyCode: 'USD',
},
}),
},
},
presentationOptions: {
actionDisplayName: 'PLACE_ORDER',
},
order: order,
}));Node.js
conv.ask(new TransactionDecision({
orderOptions: {
userInfoOptions: {
userInfoProperties: [
'EMAIL',
],
},
},
paymentParameters: {
googlePaymentOption: {
// facilitationSpec is expected to be a serialized JSON string
facilitationSpec: JSON.stringify({
apiVersion: 2,
apiVersionMinor: 0,
merchantInfo: {
merchantName: 'Example Merchant',
},
allowedPaymentMethods: [
{
type: 'CARD',
parameters: {
allowedAuthMethods: ['PAN_ONLY', 'CRYPTOGRAM_3DS'],
allowedCardNetworks: [
'AMEX', 'DISCOVER', 'JCB', 'MASTERCARD', 'VISA'],
},
tokenizationSpecification: {
type: 'PAYMENT_GATEWAY',
parameters: {
gateway: 'example',
gatewayMerchantId: 'exampleGatewayMerchantId',
},
},
},
],
transactionInfo: {
totalPriceStatus: 'FINAL',
totalPrice: '15.77',
currencyCode: 'USD',
},
}),
},
},
presentationOptions: {
actionDisplayName: 'PLACE_ORDER',
},
order: order,
}));জাভা
// Create order options
OrderOptionsV3 orderOptions = new OrderOptionsV3()
.setUserInfoOptions(new UserInfoOptions()
.setUserInfoProperties(Collections.singletonList("EMAIL")));
// Create presentation options
PresentationOptionsV3 presentationOptions = new PresentationOptionsV3()
.setActionDisplayName("PLACE_ORDER");
// Create payment parameters
JSONObject merchantInfo = new JSONObject();
merchantInfo.put("merchantName", "Example Merchant");
JSONObject facilitationSpec = new JSONObject();
facilitationSpec.put("apiVersion", 2);
facilitationSpec.put("apiVersionMinor", 0);
facilitationSpec.put("merchantInfo", merchantInfo);
JSONObject allowedPaymentMethod = new JSONObject();
allowedPaymentMethod.put("type", "CARD");
JSONArray allowedAuthMethods = new JSONArray();
allowedAuthMethods.addAll(Arrays.asList("PAN_ONLY", "CRYPTOGRAM_3DS"));
JSONArray allowedCardNetworks = new JSONArray();
allowedCardNetworks.addAll(Arrays.asList("AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"));
JSONObject allowedPaymentMethodParameters = new JSONObject();
allowedPaymentMethodParameters.put("allowedAuthMethods", allowedAuthMethods);
allowedPaymentMethodParameters.put("allowedCardNetworks", allowedCardNetworks);
allowedPaymentMethod.put("parameters", allowedPaymentMethodParameters);
JSONObject tokenizationSpecificationParameters = new JSONObject();
tokenizationSpecificationParameters.put("gateway", "example");
tokenizationSpecificationParameters.put("gatewayMerchantId", "exampleGatewayMerchantId");
JSONObject tokenizationSpecification = new JSONObject();
tokenizationSpecification.put("type", "PAYMENT_GATEWAY");
tokenizationSpecification.put("parameters", tokenizationSpecificationParameters);
allowedPaymentMethod.put("tokenizationSpecification", tokenizationSpecification);
JSONArray allowedPaymentMethods = new JSONArray();
allowedPaymentMethods.add(allowedPaymentMethod);
facilitationSpec.put("allowedPaymentMethods", allowedPaymentMethods);
JSONObject transactionInfo = new JSONObject();
transactionInfo.put("totalPriceStatus", "FINAL");
transactionInfo.put("totalPrice", "15.77");
transactionInfo.put("currencyCode", "USD");
facilitationSpec.put("transactionInfo", transactionInfo);
GooglePaymentOption googlePaymentOption = new GooglePaymentOption()
.setFacilitationSpec(facilitationSpec.toJSONString());
paymentParameters.setGooglePaymentOption(googlePaymentOption);
return getResponseBuilder(request)
.add(new TransactionDecision()
.setOrder(order)
.setOrderOptions(orderOptions)
.setPresentationOptions(presentationOptions)
.setPaymentParameters(paymentParameters)
)
.build();জাভা
// Create order options
OrderOptionsV3 orderOptions = new OrderOptionsV3()
.setUserInfoOptions(new UserInfoOptions()
.setUserInfoProperties(Collections.singletonList("EMAIL")));
// Create presentation options
PresentationOptionsV3 presentationOptions = new PresentationOptionsV3()
.setActionDisplayName("PLACE_ORDER");
// Create payment parameters
JSONObject merchantInfo = new JSONObject();
merchantInfo.put("merchantName", "Example Merchant");
JSONObject facilitationSpec = new JSONObject();
facilitationSpec.put("apiVersion", 2);
facilitationSpec.put("apiVersionMinor", 0);
facilitationSpec.put("merchantInfo", merchantInfo);
JSONObject allowedPaymentMethod = new JSONObject();
allowedPaymentMethod.put("type", "CARD");
JSONArray allowedAuthMethods = new JSONArray();
allowedAuthMethods.addAll(Arrays.asList("PAN_ONLY", "CRYPTOGRAM_3DS"));
JSONArray allowedCardNetworks = new JSONArray();
allowedCardNetworks.addAll(Arrays.asList("AMEX", "DISCOVER", "JCB", "MASTERCARD", "VISA"));
JSONObject allowedPaymentMethodParameters = new JSONObject();
allowedPaymentMethodParameters.put("allowedAuthMethods", allowedAuthMethods);
allowedPaymentMethodParameters.put("allowedCardNetworks", allowedCardNetworks);
allowedPaymentMethod.put("parameters", allowedPaymentMethodParameters);
JSONObject tokenizationSpecificationParameters = new JSONObject();
tokenizationSpecificationParameters.put("gateway", "example");
tokenizationSpecificationParameters.put("gatewayMerchantId", "exampleGatewayMerchantId");
JSONObject tokenizationSpecification = new JSONObject();
tokenizationSpecification.put("type", "PAYMENT_GATEWAY");
tokenizationSpecification.put("parameters", tokenizationSpecificationParameters);
allowedPaymentMethod.put("tokenizationSpecification", tokenizationSpecification);
JSONArray allowedPaymentMethods = new JSONArray();
allowedPaymentMethods.add(allowedPaymentMethod);
facilitationSpec.put("allowedPaymentMethods", allowedPaymentMethods);
JSONObject transactionInfo = new JSONObject();
transactionInfo.put("totalPriceStatus", "FINAL");
transactionInfo.put("totalPrice", "15.77");
transactionInfo.put("currencyCode", "USD");
facilitationSpec.put("transactionInfo", transactionInfo);
GooglePaymentOption googlePaymentOption = new GooglePaymentOption()
.setFacilitationSpec(facilitationSpec.toJSONString());
paymentParameters.setGooglePaymentOption(googlePaymentOption);
return getResponseBuilder(request)
.add(new TransactionDecision()
.setOrder(order)
.setOrderOptions(orderOptions)
.setPresentationOptions(presentationOptions)
.setPaymentParameters(paymentParameters)
)
.build();JSON
{
"payload": {
"google": {
"expectUserResponse": true,
"richResponse": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Transaction Decision Placeholder."
}
}
]
},
"systemIntent": {
"intent": "actions.intent.TRANSACTION_DECISION",
"data": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec",
"orderOptions": {
"userInfoOptions": {
"userInfoProperties": [
"EMAIL"
]
}
},
"paymentParameters": {
"merchantPaymentOption": {
"defaultMerchantPaymentMethodId": "12345678",
"managePaymentMethodUrl": "https://example.com/managePayment",
"merchantPaymentMethod": [
{
"paymentMethodDisplayInfo": {
"paymentMethodDisplayName": "VISA **** 1234",
"paymentType": "PAYMENT_CARD"
},
"paymentMethodGroup": "Payment method group",
"paymentMethodId": "12345678",
"paymentMethodStatus": {
"status": "STATUS_OK",
"statusMessage": "Status message"
}
}
]
}
},
"presentationOptions": {
"actionDisplayName": "PLACE_ORDER"
},
"order": {
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T18:00:00.877Z",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"description": "A four cheese pizza.",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 8990000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
}
],
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"unitMeasure": {
"measure": 1,
"unit": "POUND"
},
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"state": "ACTUAL",
"name": "Item Price",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1,
"subOptions": []
}
]
}
}
]
},
"buyerInfo": {
"email": "janedoe@gmail.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 3780000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 15770000
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "http://www.example.com",
"note": "Sale event",
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CREATED",
"userVisibleStatusLabel": "CREATED",
"type": "FOOD",
"returnsInfo": {
"isReturnable": false,
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"city": "MOUNTAIN VIEW",
"coordinates": {
"latitude": 37.432524,
"longitude": -122.098545
},
"phoneNumber": "+1 123-456-7890",
"postalAddress": {
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"postalCode": "94043-1351",
"recipients": [
"John Doe"
],
"regionCode": "US"
},
"zipCode": "94043-1351"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE"
}
}
}
}
}
},
"outputContexts": [
{
"name": "projects/df-transactions/agent/sessions/ABwppHGYEP2Fj7tJBxoaKMevL6lZ2rs063lOEWhSW5etZWVOoJe7Dzm_bLejRTYIYXL3D78ER7YvA5aN9Wpy/contexts/_actions_on_google",
"lifespanCount": 99,
"parameters": {
"data": "{\"location\":{\"coordinates\":{\"latitude\":37.432524,\"longitude\":-122.098545},\"zipCode\":\"94043-1351\",\"city\":\"MOUNTAIN VIEW\",\"postalAddress\":{\"regionCode\":\"US\",\"postalCode\":\"94043-1351\",\"administrativeArea\":\"CA\",\"locality\":\"MOUNTAIN VIEW\",\"addressLines\":[\"1600 AMPHITHEATRE PKWY\"],\"recipients\":[\"John Doe\"]},\"phoneNumber\":\"+1 123-456-7890\"},\"latestOrderId\":\"ORDER_ID\"}"
}
}
]
}JSON
{
"expectUserResponse": true,
"expectedInputs": [
{
"possibleIntents": [
{
"intent": "actions.intent.TRANSACTION_DECISION",
"inputValueData": {
"@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec",
"orderOptions": {
"userInfoOptions": {
"userInfoProperties": [
"EMAIL"
]
}
},
"paymentParameters": {
"merchantPaymentOption": {
"defaultMerchantPaymentMethodId": "12345678",
"managePaymentMethodUrl": "https://example.com/managePayment",
"merchantPaymentMethod": [
{
"paymentMethodDisplayInfo": {
"paymentMethodDisplayName": "VISA **** 1234",
"paymentType": "PAYMENT_CARD"
},
"paymentMethodGroup": "Payment method group",
"paymentMethodId": "12345678",
"paymentMethodStatus": {
"status": "STATUS_OK",
"statusMessage": "Status message"
}
}
]
}
},
"presentationOptions": {
"actionDisplayName": "PLACE_ORDER"
},
"order": {
"createTime": "2019-09-24T18:00:00.877Z",
"lastUpdateTime": "2019-09-24T18:00:00.877Z",
"merchantOrderId": "ORDER_ID",
"userVisibleOrderId": "ORDER_ID",
"transactionMerchant": {
"id": "http://www.example.com",
"name": "Example Merchant"
},
"contents": {
"lineItems": [
{
"id": "LINE_ITEM_ID",
"name": "Pizza",
"description": "A four cheese pizza.",
"priceAttributes": [
{
"type": "REGULAR",
"name": "Item Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 8990000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
}
],
"notes": [
"Extra cheese."
],
"purchase": {
"quantity": 1,
"unitMeasure": {
"measure": 1,
"unit": "POUND"
},
"itemOptions": [
{
"id": "ITEM_OPTION_ID",
"name": "Pepperoni",
"prices": [
{
"type": "REGULAR",
"state": "ACTUAL",
"name": "Item Price",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 1000000
},
"taxIncluded": true
}
],
"note": "Extra pepperoni",
"quantity": 1,
"subOptions": []
}
]
}
}
]
},
"buyerInfo": {
"email": "janedoe@gmail.com",
"firstName": "Jane",
"lastName": "Doe",
"displayName": "Jane Doe"
},
"priceAttributes": [
{
"type": "SUBTOTAL",
"name": "Subtotal",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 9990000
},
"taxIncluded": true
},
{
"type": "DELIVERY",
"name": "Delivery",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
{
"type": "TAX",
"name": "Tax",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 3780000
},
"taxIncluded": true
},
{
"type": "TOTAL",
"name": "Total Price",
"state": "ESTIMATE",
"amount": {
"currencyCode": "USD",
"amountInMicros": 15770000
},
"taxIncluded": true
}
],
"followUpActions": [
{
"type": "VIEW_DETAILS",
"title": "View details",
"openUrlAction": {
"url": "http://example.com"
}
},
{
"type": "CALL",
"title": "Call us",
"openUrlAction": {
"url": "tel:+16501112222"
}
},
{
"type": "EMAIL",
"title": "Email us",
"openUrlAction": {
"url": "mailto:person@example.com"
}
}
],
"termsOfServiceUrl": "http://www.example.com",
"note": "Sale event",
"promotions": [
{
"coupon": "COUPON_CODE"
}
],
"purchase": {
"status": "CREATED",
"userVisibleStatusLabel": "CREATED",
"type": "FOOD",
"returnsInfo": {
"isReturnable": false,
"daysToReturn": 1,
"policyUrl": "http://www.example.com"
},
"fulfillmentInfo": {
"id": "FULFILLMENT_SERVICE_ID",
"fulfillmentType": "DELIVERY",
"expectedFulfillmentTime": {
"timeIso8601": "2019-09-25T18:00:00.877Z"
},
"location": {
"coordinates": {
"latitude": 37.421578499999995,
"longitude": -122.0837816
},
"zipCode": "94043-1351",
"city": "MOUNTAIN VIEW",
"postalAddress": {
"regionCode": "US",
"postalCode": "94043-1351",
"administrativeArea": "CA",
"locality": "MOUNTAIN VIEW",
"addressLines": [
"1600 AMPHITHEATRE PKWY"
],
"recipients": [
"John Doe"
]
},
"phoneNumber": "+1 123-456-7890"
},
"price": {
"type": "REGULAR",
"name": "Delivery Price",
"state": "ACTUAL",
"amount": {
"currencyCode": "USD",
"amountInMicros": 2000000
},
"taxIncluded": true
},
"fulfillmentContact": {
"email": "johnjohnson@gmail.com",
"firstName": "John",
"lastName": "Johnson",
"displayName": "John Johnson"
}
},
"purchaseLocationType": "ONLINE_PURCHASE"
}
}
}
}
],
"inputPrompt": {
"richInitialPrompt": {
"items": [
{
"simpleResponse": {
"textToSpeech": "Transaction Decision Placeholder."
}
}
]
}
}
}
],
"conversationToken": "{\"data\":{\"paymentType\":\"merchant_payment\",\"location\":{\"coordinates\":{\"latitude\":37.421578499999995,\"longitude\":-122.0837816},\"zipCode\":\"94043-1351\",\"city\":\"MOUNTAIN VIEW\",\"postalAddress\":{\"regionCode\":\"US\",\"postalCode\":\"94043-1351\",\"administrativeArea\":\"CA\",\"locality\":\"MOUNTAIN VIEW\",\"addressLines\":[\"1600 AMPHITHEATRE PKWY\"],\"recipients\":[\"John Doe\"]},\"phoneNumber\":\"+1 123-456-7890\"},\"latestOrderId\":\"ORDER_ID\"}}"
} tokenizationSpecification অবজেক্টের বিষয়বস্তু প্রতিটি পেমেন্ট গেটওয়ের জন্য আলাদা হবে। নিম্নলিখিত টেবিল প্রতিটি গেটওয়ে দ্বারা ব্যবহৃত পরামিতি দেখায়:
"parameters": {
"gateway": "example",
"gatewayMerchantId": "exampleGatewayMerchantId"
}
"parameters": {
"gateway": "aciworldwide",
"gatewayMerchantId": "YOUR_ENTITY_ID"
}
"parameters": {
"gateway": "adyen",
"gatewayMerchantId": "YOUR_MERCHANT_ACCOUNT_NAME"
}
"parameters": {
"gateway": "alfabank",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "bluemedia",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "bluesnap",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "braintree",
"braintree:apiVersion": "v1",
"braintree:sdkVersion": braintree.client.VERSION,
"braintree:merchantId": "YOUR_BRAINTREE_MERCHANT_ID",
"braintree:clientKey": "YOUR_BRAINTREE_TOKENIZATION_KEY"
}
"parameters": {
"gateway": "chase",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ACCOUNT_NUMBER"
}
"parameters": {
"gateway": "checkoutltd",
"gatewayMerchantId": "YOUR_PUBLIC_KEY"
}
"parameters": {
"gateway": "cloudpayments",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "cybersource",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "datatrans",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "ebanx",
"gatewayMerchantId": "YOUR_PUBLIC_INTEGRATION_KEY"
}
"parameters": {
"gateway": "firstdata",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "globalpayments",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "gopay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "hitrustpay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "imsolutions",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "lyra",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "mpgs",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "moneymailru",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "newebpay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "nexi",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "creditcall",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "paysafe",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "payture",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "payu",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "przelewy24",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "rbkmoney",
"gatewayMerchantId": "YOUR_MERCHANT_ID"
}
"parameters": {
"gateway": "sberbank",
"gatewayMerchantId": "YOUR_ORGANIZATION_NAME"
}
"parameters": {
"gateway": "square",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "stripe",
"stripe:version": "2018-10-31",
"stripe:publishableKey": "YOUR_PUBLIC_STRIPE_KEY"
}
"parameters": {
"gateway": "tappay",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "tinkoff",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "uniteller",
"gatewayMerchantId": "YOUR_GATEWAY_MERCHANT_ID"
}
"parameters": {
"gateway": "vantiv",
"vantiv:merchantPayPageId": "YOUR_PAY_PAGE_ID",
"vantiv:merchantOrderId": "YOUR_ORDER_ID",
"vantiv:merchantTransactionId": "YOUR_TRANSACTION_ID",
"vantiv:merchantReportGroup": "*web"
}
"parameters": {
"gateway": "worldpay",
"gatewayMerchantId": "YOUR_WORLDPAY_MERCHANT_ID"
}
"parameters": {
"gateway": "yandexcheckout",
"gatewayMerchantId": "YOUR_SHOP_ID"
}
ব্যবহারকারীর সিদ্ধান্ত হ্যান্ডেল
অ্যাসিস্ট্যান্ট অভিপ্রায় পূরণ করার পরে, এটি লেনদেনের সিদ্ধান্তের ব্যবহারকারীর উত্তর সহ 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"
}
]
}
]
}4. অর্ডার চূড়ান্ত করুন এবং একটি রসিদ পাঠান
যখন 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\"}}"
}5. অর্ডার আপডেট পাঠান
আপনাকে ব্যবহারকারীকে তার জীবদ্দশায় অর্ডারের স্থিতি সম্পর্কে অবহিত রাখতে হবে। অর্ডার স্থিতি এবং বিশদ বিবরণ সহ অর্ডার 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 অর্ডার আপডেট পাঠান। প্রতিটি অর্ডার প্রতিটি স্ট্যাটাস মান প্রয়োজন হয় না.
সমস্যা সমাধান
পরীক্ষার সময় আপনি যদি কোনো সমস্যায় পড়েন, তাহলে আপনাকে লেনদেনের জন্য আমাদের সমস্যা সমাধানের পদক্ষেপগুলি পড়তে হবে।