রিজার্ভেশন তৈরি করা (Dialogflow)

এই নির্দেশিকা আপনাকে একটি অ্যাকশন প্রোজেক্ট ডেভেলপ করার প্রক্রিয়ার মাধ্যমে নিয়ে যাবে যা রিজার্ভেশন করার জন্য Orders API ব্যবহার করে।

ট্রানজ্যাকশন ফ্লো

আপনার অ্যাকশন প্রোজেক্ট রিজার্ভেশন ম্যানেজ করার সময়, এটি নিম্নলিখিত ফ্লো ব্যবহার করে:

  1. ট্রানজ্যাকশনের প্রয়োজনীয়তা যাচাই করা (ঐচ্ছিক) - ব্যবহারকারী ট্রানজ্যাকশন করতে পারবেন কিনা তা নিশ্চিত করতে কথোপকথনের শুরুতে ট্রানজ্যাকশনের প্রয়োজনীয়তা সংক্রান্ত হেল্পার ব্যবহার করুন।
  2. অর্ডার তৈরি করা - ব্যবহারকারীকে "কার্ট অ্যাসেম্বলি"র মাধ্যমে নিয়ে যান যেখানে তিনি রিজার্ভেশনের বিবরণ তৈরি করেন।
  3. অর্ডার প্রস্তাব করা - "কার্ট" সম্পূর্ণ হয়ে গেলে, ব্যবহারকারীকে রিজার্ভেশন "অর্ডার" প্রস্তাব করুন, যাতে তিনি সেটি সঠিক কিনা তা কনফার্ম করতে পারেন। রিজার্ভেশন কনফার্ম করা হলে, আপনি রিজার্ভেশনের বিবরণ সহ একটি উত্তর পাবেন।
  4. অর্ডার চূড়ান্ত করা এবং রসিদ পাঠানো - অর্ডার কনফার্ম হয়ে গেলে, আপনার রিজার্ভেশন সিস্টেম আপডেট করুন এবং ব্যবহারকারীকে রসিদ পাঠান।
  5. অর্ডার সংক্রান্ত আপডেট পাঠানো - রিজার্ভেশনের লাইফস্প্যান চলাকালীন, Orders API-তে PATCH অনুরোধ পাঠিয়ে ব্যবহারকারীকে রিজার্ভেশন স্ট্যাটাস সংক্রান্ত আপডেট দিন।

বিধিনিষেধ ও পর্যালোচনার নির্দেশিকা

মনে রাখবেন যে ট্রানজ্যাকশন ও অর্ডার API ব্যবহার করে এমন অ্যাকশনের ক্ষেত্রে অতিরিক্ত নীতি প্রযোজ্য হয়। ট্রানজ্যাকশন সহ অ্যাকশন পর্যালোচনা করতে আমাদের ছয় সপ্তাহ পর্যন্ত সময় লাগতে পারে, তাই আপনার রিলিজ শিডিউল প্ল্যান করার সময় সেই সময়টি বিবেচনা করুন। পর্যালোচনা করার প্রক্রিয়া সহজ করতে, পর্যালোচনার জন্য আপনার অ্যাকশন জমা দেওয়ার আগে ট্রানজ্যাকশনের জন্য নীতি ও নির্দেশিকা মেনে চলছেন কিনা তা নিশ্চিত করুন।

আপনি শুধুমাত্র নিম্নলিখিত দেশগুলিতে Orders API ব্যবহার করে এমন অ্যাকশন ডিপ্লয় করতে পারবেন:

অস্ট্রেলিয়া
ব্রাজিল
কানাডা
ইন্দোনেশিয়া
জাপান
মেক্সিকো
কাতার
রাশিয়া
সিঙ্গাপুর
সুইজারল্যান্ড
থাইল্যান্ড
তুরস্ক
যুক্তরাজ্য
মার্কিন যুক্তরাষ্ট্র

আপনার প্রোজেক্ট তৈরি করুন

ট্রানজ্যাকশন সংক্রান্ত কথোপকথনের বিস্তারিত উদাহরণ দেখতে, Node.js এবং Java-তে আমাদের ট্রানজ্যাকশন স্যাম্পেল দেখুন।

প্রোজেক্ট সেট-আপ

আপনার অ্যাকশন তৈরি করার সময়, অ্যাকশন কনসোলে ট্রানজ্যাকশন করতে চান কিনা তা উল্লেখ করতে হবে। এছাড়াও, আপনি Node.JS ক্লায়েন্ট লাইব্রেরি ব্যবহার করলে, Orders API-এর লেটেস্ট ভার্সন ব্যবহার করার জন্য আপনার ফুলফিলমেন্ট সেট-আপ করুন।

আপনার প্রোজেক্ট ও ফুলফিলমেন্ট সেট-আপ করতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. নতুন প্রোজেক্ট তৈরি করুন অথবা আগে থেকে থাকা প্রোজেক্ট ইমপোর্ট করুন।
  2. ডিপ্লয় করুন > ডিরেক্টরি তথ্য বিকল্পে নেভিগেট করুন।
  3. অতিরিক্ত তথ্য > ট্রানজ্যাকশন > "আপনার অ্যাকশন কি ভৌত প্রোডাক্টের ট্রানজ্যাকশন করার জন্য Transactions API ব্যবহার করে?" লেখা বক্সটিতে টিকচিহ্ন দিন।

  4. আপনার অ্যাকশনের ফুলফিলমেন্ট তৈরি করতে Node.JS ক্লায়েন্ট লাইব্রেরি ব্যবহার করলে, ফুলফিলমেন্ট কোড খুলুন এবং ordersv3 ফ্ল্যাগ true-এ সেট করতে আপনার অ্যাপ ডিক্লারেশন আপডেট করুন। নিম্নলিখিত কোড স্নিপেট Orders ভার্সন ৩-এর জন্য অ্যাপ ডিক্লারেশনের উদাহরণ দেখায়।

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,
});

১. ট্রানজ্যাকশন সংক্রান্ত প্রয়োজনীয়তা যাচাই করুন (ঐচ্ছিক)

ব্যবহারকারীর অভিজ্ঞতা

ব্যবহারকারী রিজার্ভেশন সেট-আপ করতে চান বলে ইঙ্গিত দেওয়ার সাথে সাথেই, আমরা actions.intent.TRANSACTION_REQUIREMENTS_CHECK ইনটেন্ট ট্রিগার করার সাজেশন দিই যাতে তিনি রিজার্ভেশনের অনুরোধ করতে পারেন। যেমন, চালু করার সময় আপনার অ্যাকশন হয়ত জিজ্ঞাসা করতে পারে, "আপনি কি সিট রিজার্ভ করতে চান?" ব্যবহারকারী "হ্যাঁ" বললে, আপনাকে এই ইনটেন্টটি এখনই অনুরোধ করতে হবে। এটি নিশ্চিত করবে যে তারা এগিয়ে যেতে পারবে এবং তাদের এমন কোনও সেটিংস ঠিক করার সুযোগ দেবে যা তাদের ট্রানজ্যাকশন চালিয়ে যেতে বাধা দিচ্ছে।

ট্রানজ্যাকশন সংক্রান্ত প্রয়োজনীয়তা চেক করার ইনটেন্ট অনুরোধ করলে, নিম্নলিখিত ফলাফলগুলির মধ্যে একটি পাওয়া যায়:

  • প্রয়োজনীয়তা পূরণ করা হলে, আপনার ফুলফিলমেন্ট একটি ইন্টেন্ট পাবে যার সাথে সাফল্যের শর্ত থাকবে এবং আপনি ব্যবহারকারীর অর্ডার তৈরি করার কাজ চালিয়ে যেতে পারবেন।
  • এক বা একাধিক প্রয়োজনীয়তা পূরণ না হলে, আপনার ফুলফিলমেন্ট ব্যর্থতার শর্ত সহ ইনটেন্ট পায়। এই ক্ষেত্রে, কথোপকথন শেষ করুন অথবা রিজার্ভেশন ফ্লো থেকে বেরিয়ে আসুন।

    ব্যবহারকারী যদি সমস্যার সমাধান করতে পারেন, তাহলে তার ডিভাইসে অটোমেটিক সেইসব সমস্যার সমাধান করার জন্য প্রম্পট দেখানো হয়। স্মার্ট স্পিকারের মতো শুধু ভয়েস সারফেসে কথোপকথন হলে, এটি ব্যবহারকারীর ফোনে হ্যান্ড-অফ করা হয়।

অর্ডার পূরণ করা

ব্যবহারকারী ট্রানজ্যাকশন সংক্রান্ত প্রয়োজনীয়তা পূরণ করছেন কিনা তা নিশ্চিত করতে, actions.intent.TRANSACTION_REQUIREMENTS_CHECK ইনটেন্ট পূরণ করার অনুরোধ করুন, TransactionRequirementsCheckSpec অবজেক্টের মাধ্যমে।

প্রয়োজনীয়তা চেক করুন

ক্লায়েন্ট লাইব্রেরির মাধ্যমে কোনও ব্যবহারকারী রিজার্ভেশন সংক্রান্ত প্রয়োজনীয়তা পূরণ করছেন কিনা তা চেক করে দেখুন:

Node.js
conv.ask(new TransactionRequirements());
Java
return getResponseBuilder(request)
    .add("Placeholder for transaction requirements text")
    .add(new TransactionRequirements())
    .build();
Dialogflow JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "systemIntent": {
        "intent": "actions.intent.TRANSACTION_REQUIREMENTS_CHECK",
        "data": {
          "@type": "type.googleapis.com/google.actions.transactions.v3.TransactionRequirementsCheckSpec"
        }
      }
    }
  }
}
Actions SDK JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.TRANSACTION_REQUIREMENTS_CHECK",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.transactions.v3.TransactionRequirementsCheckSpec"
          }
        }
      ]
    }
  ]
}
প্রয়োজনীয়তা চেক করার ফলাফল পান

Assistant ইনটেন্ট পূরণ করার পরে, এটি আপনার পূরণ করার অনুরোধ পাঠায় actions.intent.TRANSACTION_REQUIREMENTS_CHECK ইনটেন্টের সাথে চেক করার ফলাফল সহ।

এই অনুরোধ সঠিকভাবে ম্যানেজ করতে, Dialogflow ইনটেন্ট ঘোষণা করুন যা actions_intent_TRANSACTION_REQUIREMENTS_CHECK ইভেন্টের মাধ্যমে ট্রিগার করা হয়। ট্রিগার করা হলে, আপনার ফুলফিলমেন্টে এই ইনটেন্ট ম্যানেজ করুন:

Node.js
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!`);
} else {
  conv.close('Transaction failed.');
}
Java
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) {
  responseBuilder.add("Looks like you're good to go! Now say 'confirm transaction'");
} else {
  responseBuilder.add("Transaction failed");
}
return responseBuilder.build();
Dialogflow JSON

মনে রাখবেন যে নিচের JSON একটি ওয়েবহুক অনুরোধের বর্ণনা দেয়।

{
  "responseId": "",
  "queryResult": {
    "queryText": "",
    "action": "",
    "parameters": {},
    "allRequiredParamsPresent": true,
    "fulfillmentText": "",
    "fulfillmentMessages": [],
    "outputContexts": [],
    "intent": {
      "name": "reservation_transaction_check_complete_df",
      "displayName": "reservation_transaction_check_complete_df"
    },
    "intentDetectionConfidence": 1,
    "diagnosticInfo": {},
    "languageCode": ""
  },
  "originalDetectIntentRequest": {
    "source": "google",
    "version": "2",
    "payload": {
      "isInSandbox": true,
      "surface": {
        "capabilities": [
          {
            "name": "actions.capability.SCREEN_OUTPUT"
          },
          {
            "name": "actions.capability.AUDIO_OUTPUT"
          },
          {
            "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
          },
          {
            "name": "actions.capability.WEB_BROWSER"
          }
        ]
      },
      "inputs": [
        {
          "rawInputs": [],
          "intent": "",
          "arguments": [
            {
              "extension": {
                "@type": "type.googleapis.com/google.transactions.v3.TransactionRequirementsCheckResult",
                "resultType": "CAN_TRANSACT"
              },
              "name": "TRANSACTION_REQUIREMENTS_CHECK_RESULT"
            }
          ]
        }
      ],
      "user": {},
      "conversation": {},
      "availableSurfaces": [
        {
          "capabilities": [
            {
              "name": "actions.capability.SCREEN_OUTPUT"
            },
            {
              "name": "actions.capability.AUDIO_OUTPUT"
            },
            {
              "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
            },
            {
              "name": "actions.capability.WEB_BROWSER"
            }
          ]
        }
      ]
    }
  },
  "session": ""
}
Actions SDK JSON

মনে রাখবেন যে নিচের JSON একটি ওয়েবহুক অনুরোধের বর্ণনা দেয়।

{
  "user": {},
  "device": {},
  "surface": {
    "capabilities": [
      {
        "name": "actions.capability.SCREEN_OUTPUT"
      },
      {
        "name": "actions.capability.AUDIO_OUTPUT"
      },
      {
        "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
      },
      {
        "name": "actions.capability.WEB_BROWSER"
      }
    ]
  },
  "conversation": {},
  "inputs": [
    {
      "rawInputs": [],
      "intent": "reservation_transaction_check_complete_asdk",
      "arguments": [
        {
          "extension": {
            "@type": "type.googleapis.com/google.transactions.v3.TransactionRequirementsCheckResult",
            "resultType": "CAN_TRANSACT"
          },
          "name": "TRANSACTION_REQUIREMENTS_CHECK_RESULT"
        }
      ]
    }
  ],
  "availableSurfaces": [
    {
      "capabilities": [
        {
          "name": "actions.capability.SCREEN_OUTPUT"
        },
        {
          "name": "actions.capability.AUDIO_OUTPUT"
        },
        {
          "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
        },
        {
          "name": "actions.capability.WEB_BROWSER"
        }
      ]
    }
  ]
}

২. অর্ডার তৈরি করুন

ব্যবহারকারীর অভিজ্ঞতা

ব্যবহারকারীর প্রয়োজনীয় তথ্য পেয়ে গেলে, "কার্ট অ্যাসেম্বলি" অভিজ্ঞতা তৈরি করুন যা ব্যবহারকারীকে রিজার্ভেশন করতে সাহায্য করবে। প্রতিটি Action-এর জন্য কার্ট অ্যাসেম্বলি ফ্লো কিছুটা আলাদা হবে, যা তাদের পরিষেবার জন্য উপযুক্ত।

কার্ট অ্যাসেম্বলি অভিজ্ঞতার প্রাথমিক পর্যায়ে, ব্যবহারকারী তার রিজার্ভেশনে যোগ করার জন্য তালিকা থেকে বিকল্প বেছে নেন, যদিও ব্যবহারকারীর অভিজ্ঞতা আরও সহজ করার জন্য আপনি কথোপকথন ডিজাইন করতে পারেন। যেমন, কার্ট অ্যাসেম্বলি অভিজ্ঞতা তৈরি করুন যা ব্যবহারকারীকে সহজ হ্যাঁ বা না প্রশ্নের মাধ্যমে মাসিক রিজার্ভেশন শিডিউল করতে দেয়। এছাড়াও, আপনি ব্যবহারকারীকে "সাজেস্ট করা" রিজার্ভেশনের ক্যারোজেল বা তালিকা কার্ড দেখাতে পারেন।

ব্যবহারকারীর বিকল্পগুলি ভিজ্যুয়ালি উপস্থাপন করার জন্য আমরা রিচ রেসপন্স ব্যবহার করার সাজেশন দিই, তবে কথোপকথনটি এমনভাবে ডিজাইন করুন যাতে ব্যবহারকারী শুধুমাত্র তার ভয়েস ব্যবহার করে তার কার্ট তৈরি করতে পারেন। কার্ট অ্যাসেম্বলি অভিজ্ঞতার কিছু পেশাদার পদ্ধতি এবং উদাহরণের জন্য, ট্রানজ্যাকশন ডিজাইন নির্দেশিকা দেখুন।

অর্ডার পূরণ করা

আপনার কথোপকথন চলাকালীন, ব্যবহারকারী যে রিজার্ভেশন কিনতে চান তার বিবরণ সংগ্রহ করুন এবং তারপর একটি Order অবজেক্ট তৈরি করুন।

আপনার Order-এ অন্তত নিম্নলিখিত তথ্য থাকতে হবে:

  • buyerInfo - রিজার্ভেশন শিডিউল করা ব্যবহারকারী সম্পর্কে তথ্য।
  • transactionMerchant - রিজার্ভেশনের সুবিধা প্রদানকারী মার্চেন্ট সম্পর্কে তথ্য।
  • contents - lineItems হিসেবে তালিকাভুক্ত রিজার্ভেশনের আসল বিবরণ।

আপনার কার্ট তৈরি করতে Order রেসপন্স ডকুমেন্টেশন দেখুন। মনে রাখবেন যে রিজার্ভেশনের উপর নির্ভর করে আপনাকে বিভিন্ন ফিল্ড অন্তর্ভুক্ত করতে হতে পারে।

নিচে দেওয়া স্যাম্পেল কোডে ঐচ্ছিক ফিল্ড সহ সম্পূর্ণ রিজার্ভেশন অর্ডার দেখানো হয়েছে:

Node.js
app.intent('build_reservation_df', (conv) => {
  const now = new Date().toISOString();
  const order = {
    createTime: now,
    lastUpdateTime: now,
    merchantOrderId: 'UNIQUE_ORDER_ID',
    userVisibleOrderId: 'USER_VISIBLE_ORDER_ID',
    transactionMerchant: {
      id: 'https://www.example.com',
      name: 'Example Merchant',
    },
    contents: {
      lineItems: [
        {
          id: 'LINE_ITEM_ID',
          name: 'Dinner reservation',
          description: 'A world of flavors all in one destination.',
          reservation: {
            status: 'PENDING',
            userVisibleStatusLabel: 'Reservation is pending.',
            type: 'RESTAURANT',
            reservationTime: {
              timeIso8601: '2020-01-16T01:30:15.01Z',
            },
            userAcceptableTimeRange: {
              timeIso8601: '2020-01-15/2020-01-17',
            },
            partySize: 6,
            staffFacilitators: [
              {
                name: 'John Smith',
              },
            ],
            location: {
              zipCode: '94086',
              city: 'Sunnyvale',
              postalAddress: {
                regionCode: 'US',
                postalCode: '94086',
                administrativeArea: 'CA',
                locality: 'Sunnyvale',
                addressLines: [
                  '222, Some other Street',
                ],
              },
            },
          },
        },
      ],
    },
    buyerInfo: {
      email: 'janedoe@gmail.com',
      firstName: 'Jane',
      lastName: 'Doe',
      displayName: 'Jane Doe',
    },
    followUpActions: [
      {
        type: 'VIEW_DETAILS',
        title: 'View details',
        openUrlAction: {
          url: 'https://example.com',
        },
      },
      {
        type: 'CALL',
        title: 'Call us',
        openUrlAction: {
          url: 'tel:+16501112222',
        },
      },
      {
        type: 'EMAIL',
        title: 'Email us',
        openUrlAction: {
          url: 'mailto:person@example.com',
        },
      },
    ],
    termsOfServiceUrl: 'https://www.example.com',
  };
Java
private static OrderV3 createOrder() {
  // Transaction Merchant
  MerchantV3 transactionMerchant = new MerchantV3()
      .setId("http://www.example.com")
      .setName("Example Merchant");

  // Line Item

  // Reservation Item Extension
  ReservationItemExtension reservationItemExtension = new ReservationItemExtension()
      .setStatus("PENDING")
      .setUserVisibleStatusLabel("Reservation pending.")
      .setType("RESTAURANT")
      .setReservationTime(new TimeV3()
          .setTimeIso8601("2020-01-16T01:30:15.01Z"))
      .setUserAcceptableTimeRange(new TimeV3()
          .setTimeIso8601("2020-01-15/2020-01-17"))
      .setPartySize(6)
      .setStaffFacilitators(Collections.singletonList(new StaffFacilitator()
          .setName("John Smith")))
      .setLocation(new Location()
          .setZipCode("94086")
          .setCity("Sunnyvale")
          .setPostalAddress(new PostalAddress()
              .setRegionCode("US")
              .setPostalCode("94086")
              .setAdministrativeArea("CA")
              .setLocality("Sunnyvale")
              .setAddressLines(
                  Collections.singletonList("222, Some other Street"))));

  LineItemV3 lineItem = new LineItemV3()
      .setId("LINE_ITEM_ID")
      .setName("Dinner reservation")
      .setDescription("A world of flavors all in one destination.")
      .setReservation(reservationItemExtension);

  // 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");

  // 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 = "https://example.com";

  String now = Instant.now().toString();

  OrderV3 order = new OrderV3()
      .setCreateTime(now)
      .setLastUpdateTime(now)
      .setMerchantOrderId("UNIQUE_ORDER_ID")
      .setUserVisibleOrderId("UNIQUE_USER_VISIBLE_ORDER_ID")
      .setTransactionMerchant(transactionMerchant)
      .setContents(contents)
      .setBuyerInfo(buyerInfo)
      .setFollowUpActions(Arrays.asList(
          viewDetails,
          call,
          email
      ))
      .setTermsOfServiceUrl(termsOfServiceUrl);

  return order;
}
JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "systemIntent": {
        "intent": "actions.intent.TRANSACTION_DECISION",
        "data": {
          "@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec",
          "order": {
            "createTime": "2019-07-17T18:25:30.182Z",
            "lastUpdateTime": "2019-07-17T18:25:30.182Z",
            "merchantOrderId": "UNIQUE_ORDER_ID",
            "userVisibleOrderId": "USER_VISIBLE_ORDER_ID",
            "transactionMerchant": {
              "id": "https://www.example.com",
              "name": "Example Merchant"
            },
            "contents": {
              "lineItems": [
                {
                  "id": "LINE_ITEM_ID",
                  "name": "Dinner reservation",
                  "description": "A world of flavors all in one destination.",
                  "reservation": {
                    "status": "PENDING",
                    "userVisibleStatusLabel": "Reservation is pending.",
                    "type": "RESTAURANT",
                    "reservationTime": {
                      "timeIso8601": "2020-01-16T01:30:15.01Z"
                    },
                    "userAcceptableTimeRange": {
                      "timeIso8601": "2020-01-15/2020-01-17"
                    },
                    "partySize": 6,
                    "staffFacilitators": [
                      {
                        "name": "John Smith"
                      }
                    ],
                    "location": {
                      "zipCode": "94086",
                      "city": "Sunnyvale",
                      "postalAddress": {
                        "regionCode": "US",
                        "postalCode": "94086",
                        "administrativeArea": "CA",
                        "locality": "Sunnyvale",
                        "addressLines": [
                          "222, Some other Street"
                        ]
                      }
                    }
                  }
                }
              ]
            },
            "buyerInfo": {
              "email": "janedoe@gmail.com",
              "firstName": "Jane",
              "lastName": "Doe",
              "displayName": "Jane Doe"
            },
            "followUpActions": [
              {
                "type": "VIEW_DETAILS",
                "title": "View details",
                "openUrlAction": {
                  "url": "https://example.com"
                }
              },
              {
                "type": "CALL",
                "title": "Call us",
                "openUrlAction": {
                  "url": "tel:+16501112222"
                }
              },
              {
                "type": "EMAIL",
                "title": "Email us",
                "openUrlAction": {
                  "url": "mailto:person@example.com"
                }
              }
            ],
            "termsOfServiceUrl": "https://www.example.com"
          },
          "orderOptions": {
            "requestDeliveryAddress": false,
            "userInfoOptions": {
              "userInfoProperties": [
                "EMAIL"
              ]
            }
          },
          "presentationOptions": {
            "actionDisplayName": "RESERVE"
          }
        }
      }
    }
  }
}

৩. অর্ডার প্রস্তাব করুন

ব্যবহারকারীকে তার রিজার্ভেশন অর্ডার দেখান যাতে তিনি সেটি কনফার্ম বা বাতিল করতে পারেন। actions.intent.TRANSACTION_DECISION ইনটেন্টের জন্য অনুরোধ করুন এবং আপনার তৈরি করা Order প্রদান করুন।

ব্যবহারকারীর অভিজ্ঞতা

আপনি actions.intent.TRANSACTION_DECISION ইনটেন্টের অনুরোধ করলে, Assistant একটি বিল্ট-ইন অভিজ্ঞতা শুরু করে যেখানে Order সরাসরি "কার্ট প্রিভিউ কার্ডে" রেন্ডার করা হয়। ব্যবহারকারী "রিজার্ভেশন শিডিউল করো" বলতে পারেন, ট্রানজ্যাকশন বাতিল করতে পারেন অথবা রিজার্ভেশনের বিবরণ পরিবর্তন করার অনুরোধ করতে পারেন।

এই পর্যায়ে ব্যবহারকারী অর্ডারে পরিবর্তন করার অনুরোধও করতে পারেন। এই ক্ষেত্রে, আপনাকে নিশ্চিত করতে হবে যে কার্ট অ্যাসেম্বলি অভিজ্ঞতা শেষ করার পরে আপনার ফুলফিলমেন্ট অর্ডার পরিবর্তনের অনুরোধগুলি ম্যানেজ করতে পারে।

অর্ডার পূরণ করা

আপনি actions.intent.TRANSACTION_DECISION ইনটেন্টের অনুরোধ করলে, TransactionDecision তৈরি করুন যার মধ্যে Order এবং orderOptions থাকবে

নিম্নলিখিত কোডটি একটি অর্ডারের জন্য উদাহরণ TransactionsDecision দেখায়:

Node.js
conv.ask(new TransactionDecision({
  orderOptions: {
    requestDeliveryAddress: 'false',
  },
  presentationOptions: {
    actionDisplayName: 'RESERVE',
  },
  order: order,
}));
Java
// Create order options
OrderOptionsV3 orderOptions = new OrderOptionsV3()
    .setRequestDeliveryAddress(false)
    .setUserInfoOptions(new UserInfoOptions()
        .setUserInfoProperties(Collections.singletonList("EMAIL")));

// Create presentation options
PresentationOptionsV3 presentationOptions = new PresentationOptionsV3()
    .setActionDisplayName("RESERVE");

// Ask for transaction decision
return getResponseBuilder(request)
    .add("Placeholder for transaction decision text")
    .add(new TransactionDecision()
        .setOrder(order)
        .setOrderOptions(orderOptions)
        .setPresentationOptions(presentationOptions)
    )
    .build();
Dialogflow JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "systemIntent": {
        "intent": "actions.intent.TRANSACTION_DECISION",
        "data": {
          "@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec",
          "orderOptions": {
            "requestDeliveryAddress": "false"
          },
          "presentationOptions": {
            "actionDisplayName": "RESERVE"
          },
          "order": {
            "createTime": "2019-07-17T18:25:30.184Z",
            "lastUpdateTime": "2019-07-17T18:25:30.184Z",
            "merchantOrderId": "UNIQUE_ORDER_ID",
            "userVisibleOrderId": "USER_VISIBLE_ORDER_ID",
            "transactionMerchant": {
              "id": "https://www.example.com",
              "name": "Example Merchant"
            },
            "contents": {
              "lineItems": [
                {
                  "id": "LINE_ITEM_ID",
                  "name": "Dinner reservation",
                  "description": "A world of flavors all in one destination.",
                  "reservation": {
                    "status": "PENDING",
                    "userVisibleStatusLabel": "Reservation is pending.",
                    "type": "RESTAURANT",
                    "reservationTime": {
                      "timeIso8601": "2020-01-16T01:30:15.01Z"
                    },
                    "userAcceptableTimeRange": {
                      "timeIso8601": "2020-01-15/2020-01-17"
                    },
                    "partySize": 6,
                    "staffFacilitators": [
                      {
                        "name": "John Smith"
                      }
                    ],
                    "location": {
                      "zipCode": "94086",
                      "city": "Sunnyvale",
                      "postalAddress": {
                        "regionCode": "US",
                        "postalCode": "94086",
                        "administrativeArea": "CA",
                        "locality": "Sunnyvale",
                        "addressLines": [
                          "222, Some other Street"
                        ]
                      }
                    }
                  }
                }
              ]
            },
            "buyerInfo": {
              "email": "janedoe@gmail.com",
              "firstName": "Jane",
              "lastName": "Doe",
              "displayName": "Jane Doe"
            },
            "followUpActions": [
              {
                "type": "VIEW_DETAILS",
                "title": "View details",
                "openUrlAction": {
                  "url": "https://example.com"
                }
              },
              {
                "type": "CALL",
                "title": "Call us",
                "openUrlAction": {
                  "url": "tel:+16501112222"
                }
              },
              {
                "type": "EMAIL",
                "title": "Email us",
                "openUrlAction": {
                  "url": "mailto:person@example.com"
                }
              }
            ],
            "termsOfServiceUrl": "https://www.example.com"
          }
        }
      }
    }
  }
}
Actions SDK JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.TRANSACTION_DECISION",
          "inputValueData": {
            "@type": "type.googleapis.com/google.actions.transactions.v3.TransactionDecisionValueSpec",
            "orderOptions": {
              "requestDeliveryAddress": "false"
            },
            "presentationOptions": {
              "actionDisplayName": "RESERVE"
            },
            "order": {
              "createTime": "2019-07-17T18:25:30.057Z",
              "lastUpdateTime": "2019-07-17T18:25:30.057Z",
              "merchantOrderId": "UNIQUE_ORDER_ID",
              "userVisibleOrderId": "USER_VISIBLE_ORDER_ID",
              "transactionMerchant": {
                "id": "https://www.example.com",
                "name": "Example Merchant"
              },
              "contents": {
                "lineItems": [
                  {
                    "id": "LINE_ITEM_ID",
                    "name": "Dinner reservation",
                    "description": "A world of flavors all in one destination.",
                    "reservation": {
                      "status": "PENDING",
                      "userVisibleStatusLabel": "Reservation is pending.",
                      "type": "RESTAURANT",
                      "reservationTime": {
                        "timeIso8601": "2020-01-16T01:30:15.01Z"
                      },
                      "userAcceptableTimeRange": {
                        "timeIso8601": "2020-01-15/2020-01-17"
                      },
                      "partySize": 6,
                      "staffFacilitators": [
                        {
                          "name": "John Smith"
                        }
                      ],
                      "location": {
                        "zipCode": "94086",
                        "city": "Sunnyvale",
                        "postalAddress": {
                          "regionCode": "US",
                          "postalCode": "94086",
                          "administrativeArea": "CA",
                          "locality": "Sunnyvale",
                          "addressLines": [
                            "222, Some other Street"
                          ]
                        }
                      }
                    }
                  }
                ]
              },
              "buyerInfo": {
                "email": "janedoe@gmail.com",
                "firstName": "Jane",
                "lastName": "Doe",
                "displayName": "Jane Doe"
              },
              "followUpActions": [
                {
                  "type": "VIEW_DETAILS",
                  "title": "View details",
                  "openUrlAction": {
                    "url": "https://example.com"
                  }
                },
                {
                  "type": "CALL",
                  "title": "Call us",
                  "openUrlAction": {
                    "url": "tel:+16501112222"
                  }
                },
                {
                  "type": "EMAIL",
                  "title": "Email us",
                  "openUrlAction": {
                    "url": "mailto:person@example.com"
                  }
                }
              ],
              "termsOfServiceUrl": "https://www.example.com"
            }
          }
        }
      ]
    }
  ]
}
ব্যবহারকারীর সিদ্ধান্ত ম্যানেজ করা

ব্যবহারকারী প্রস্তাবিত অর্ডারের উত্তর দেওয়ার পরে, আপনার ফুলফিলমেন্ট actions_intent_TRANSACTION_DECISION ইনটেন্ট পায়, যার সাথে একটি আর্গুমেন্ট থাকে, যাতে TransactionDecisionValue থাকে। এই ভ্যালুতে নিম্নলিখিত তথ্য থাকবে:

  • transactionDecision - প্রস্তাবিত অর্ডার সম্পর্কে ব্যবহারকারীর সিদ্ধান্ত। সম্ভাব্য ভ্যালুগুলি হল ORDER_ACCEPTED, ORDER_REJECTED, CART_CHANGE_REQUESTED এবং USER_CANNOT_TRANSACT।

এই অনুরোধ ম্যানেজ করতে, Dialogflow ইনটেন্ট ঘোষণা করুন যা 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;
}
Java
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");
}
if ((transactionDecision != null && transactionDecision.equals("ORDER_ACCEPTED"))) {
  OrderV3 order = ((OrderV3) extension.get("order"));
}
Dialogflow JSON

মনে রাখবেন যে নিচের JSON একটি ওয়েবহুক অনুরোধের বর্ণনা দেয়।

{
  "responseId": "",
  "queryResult": {
    "queryText": "",
    "action": "",
    "parameters": {},
    "allRequiredParamsPresent": true,
    "fulfillmentText": "",
    "fulfillmentMessages": [],
    "outputContexts": [],
    "intent": {
      "name": "reservation_get_transaction_decision_df",
      "displayName": "reservation_get_transaction_decision_df"
    },
    "intentDetectionConfidence": 1,
    "diagnosticInfo": {},
    "languageCode": ""
  },
  "originalDetectIntentRequest": {
    "source": "google",
    "version": "2",
    "payload": {
      "isInSandbox": true,
      "surface": {
        "capabilities": [
          {
            "name": "actions.capability.SCREEN_OUTPUT"
          },
          {
            "name": "actions.capability.AUDIO_OUTPUT"
          },
          {
            "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
          },
          {
            "name": "actions.capability.WEB_BROWSER"
          }
        ]
      },
      "inputs": [
        {
          "rawInputs": [],
          "intent": "",
          "arguments": []
        }
      ],
      "user": {},
      "conversation": {},
      "availableSurfaces": [
        {
          "capabilities": [
            {
              "name": "actions.capability.SCREEN_OUTPUT"
            },
            {
              "name": "actions.capability.AUDIO_OUTPUT"
            },
            {
              "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
            },
            {
              "name": "actions.capability.WEB_BROWSER"
            }
          ]
        }
      ]
    }
  },
  "session": ""
}
Actions SDK JSON

মনে রাখবেন যে নিচের JSON একটি ওয়েবহুক অনুরোধের বর্ণনা দেয়।

{
  "user": {},
  "device": {},
  "surface": {
    "capabilities": [
      {
        "name": "actions.capability.SCREEN_OUTPUT"
      },
      {
        "name": "actions.capability.AUDIO_OUTPUT"
      },
      {
        "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
      },
      {
        "name": "actions.capability.WEB_BROWSER"
      }
    ]
  },
  "conversation": {},
  "inputs": [
    {
      "rawInputs": [],
      "intent": "reservation_get_transaction_decision_asdk",
      "arguments": []
    }
  ],
  "availableSurfaces": [
    {
      "capabilities": [
        {
          "name": "actions.capability.SCREEN_OUTPUT"
        },
        {
          "name": "actions.capability.AUDIO_OUTPUT"
        },
        {
          "name": "actions.capability.MEDIA_RESPONSE_AUDIO"
        },
        {
          "name": "actions.capability.WEB_BROWSER"
        }
      ]
    }
  ]
}

৪. রিজার্ভেশন চূড়ান্ত করুন এবং একটি রসিদ পাঠান

actions.intent.TRANSACTION_DECISION ইনটেন্ট ORDER_ACCEPTED-এর transactionDecision -এর সাথে ফিরে এলে, রিজার্ভেশন শিডিউল করার জন্য প্রয়োজনীয় প্রসেসিং করুন (যেমন, আপনার নিজের ডেটাবেসে এটি সেভ করা)।

কথোপকথন চালিয়ে যেতে সহজ উত্তর পাঠান। ব্যবহারকারী আপনার উত্তরের সাথে একটি "আড়াল করা রসিদ কার্ড" পাবেন।

অর্ডার পূরণ করা

Node.js
// Set lastUpdateTime and update status of reservation
order.lastUpdateTime = new Date().toISOString();
order.reservation.status = 'CONFIRMED';
order.reservation.userVisibleStatusLabel = 'Reservation confirmed';
order.reservation.confirmationCode = '123ABCDEFGXYZ';

// Send synchronous order update
conv.ask(`Transaction completed! You're all set!`);
conv.ask(new OrderUpdate({
  type: 'SNAPSHOT',
  reason: 'Reason string',
  order: order,
}));
Java
ResponseBuilder responseBuilder = getResponseBuilder(request);
order.setLastUpdateTime(Instant.now().toString());

// Set reservation status to confirmed and provide confirmation code
LineItemV3 lineItem = order.getContents().getLineItems().get(0);
ReservationItemExtension reservationItemExtension = lineItem.getReservation();
reservationItemExtension.setStatus("CONFIRMED");
reservationItemExtension.setUserVisibleStatusLabel("Reservation confirmed.");
reservationItemExtension.setConfirmationCode("123ABCDEFGXYZ");
lineItem.setReservation(reservationItemExtension);
order.getContents().getLineItems().set(0, lineItem);

// Order update
OrderUpdateV3 orderUpdate = new OrderUpdateV3()
    .setType("SNAPSHOT")
    .setReason("Reason string")
    .setOrder(order);

responseBuilder
    .add("Transaction completed! You're all set! Would you like to do anything else?")
    .add(new StructuredResponse().setOrderUpdateV3(orderUpdate));
return responseBuilder.build();
Dialogflow JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "payload": {
    "google": {
      "expectUserResponse": true,
      "richResponse": {
        "items": [
          {
            "simpleResponse": {
              "textToSpeech": "Transaction completed! You're all set!"
            }
          },
          {
            "structuredResponse": {
              "orderUpdateV3": {
                "type": "SNAPSHOT",
                "reason": "Reason string",
                "order": {
                  "merchantOrderId": "UNIQUE_ORDER_ID",
                  "reservation": {
                    "status": "CONFIRMED",
                    "userVisibleStatusLabel": "Reservation confirmed",
                    "confirmationCode": "123ABCDEFGXYZ"
                  },
                  "lastUpdateTime": "2019-07-17T18:25:30.187Z"
                }
              }
            }
          }
        ]
      }
    }
  }
}
Actions SDK JSON

মনে রাখবেন, নিচের JSON-এ ওয়েবহুক রেসপন্স বর্ণনা করা হয়েছে।

{
  "expectUserResponse": true,
  "expectedInputs": [
    {
      "possibleIntents": [
        {
          "intent": "actions.intent.TEXT"
        }
      ],
      "inputPrompt": {
        "richInitialPrompt": {
          "items": [
            {
              "simpleResponse": {
                "textToSpeech": "Transaction completed! You're all set!"
              }
            },
            {
              "structuredResponse": {
                "orderUpdateV3": {
                  "type": "SNAPSHOT",
                  "reason": "Reason string",
                  "order": {
                    "merchantOrderId": "UNIQUE_ORDER_ID",
                    "reservation": {
                      "status": "CONFIRMED",
                      "userVisibleStatusLabel": "Reservation confirmed",
                      "confirmationCode": "123ABCDEFGXYZ"
                    },
                    "lastUpdateTime": "2019-07-17T18:25:30.059Z"
                  }
                }
              }
            }
          ]
        }
      }
    }
  ]
}

৫. অর্ডার সংক্রান্ত আপডেট পাঠান

রিজার্ভেশনের স্ট্যাটাস তার লাইফটাইম চলাকালীন পরিবর্তন হয়। Orders API-তে HTTP PATCH অনুরোধের মাধ্যমে ব্যবহারকারীকে রিজার্ভেশন অর্ডারের আপডেট পাঠান, যাতে অর্ডারের স্ট্যাটাস ও বিবরণ থাকে।

Orders API-তে অ্যাসিঙ্ক্রোনাস অনুরোধ সেট-আপ করুন

Orders API-তে অর্ডার আপডেট করার অনুরোধ অ্যাক্সেস টোকেনের মাধ্যমে অনুমোদিত হয়। Orders API-তে অর্ডার আপডেট PATCH করতে, আপনার Actions Console প্রোজেক্টের সাথে যুক্ত JSON পরিষেবা অ্যাকাউন্ট কী ডাউনলোড করুন, তারপর বিয়ারার টোকেনের জন্য পরিষেবা অ্যাকাউন্ট কী এক্সচেঞ্জ করুন যা HTTP অনুরোধের Authorization হেডারে পাস করা যেতে পারে।

আপনার পরিষেবা অ্যাকাউন্ট কী ফিরিয়ে আনতে, নিম্নলিখিত ধাপগুলি অনুসরণ করুন:

  1. Google Cloud Console-এ, মেনু ☰ > API ও পরিষেবা > ক্রেডেনশিয়াল > ক্রেডেনশিয়াল তৈরি করুন > পরিষেবা অ্যাকাউন্ট কী বিকল্পে যান।
  2. পরিষেবা অ্যাকাউন্ট বিকল্পের মধ্যে, নতুন পরিষেবা অ্যাকাউন্ট বিকল্প বেছে নিন।
  3. পরিষেবা অ্যাকাউন্ট service-account-এ সেট করুন।
  4. ভূমিকা প্রোজেক্ট > মালিক হিসেবে সেট করুন।
  5. কী-এর ধরন JSON হিসেবে সেট করুন।
  6. তৈরি করুন বিকল্প বেছে নিন।
  7. আপনার লোকাল মেশিনে একটি ব্যক্তিগত JSON পরিষেবা অ্যাকাউন্ট কী ডাউনলোড করা হবে।

আপনার অর্ডার আপডেট কোডে, Google APIs ক্লায়েন্ট লাইব্রেরি এবং "https://www.googleapis.com/auth/actions.order.developer" স্কোপ ব্যবহার করে আপনার সার্ভিস কী বিয়ারার টোকেনের সাথে এক্সচেঞ্জ করুন। আপনি API ক্লায়েন্ট লাইব্রেরির GitHub পৃষ্ঠায় ইনস্টলেশন সংক্রান্ত ধাপ ও উদাহরণ দেখতে পাবেন।

কী এক্সচেঞ্জের উদাহরণের জন্য আমাদের Node.js এবং Java স্যাম্পেলে order-update.js রেফারেন্স দেখুন।

অর্ডার সংক্রান্ত আপডেট পাঠান

OAuth বিয়ারার টোকেনের জন্য আপনার পরিষেবা অ্যাকাউন্ট কী এক্সচেঞ্জ করার পরে, Orders API-তে অনুমোদিত PATCH অনুরোধ হিসেবে অর্ডার আপডেট পাঠান।

Orders API URL: PATCH https://actions.googleapis.com/v3/orders/${orderId}

আপনার অনুরোধে নিম্নলিখিত হেডার প্রদান করুন:

  • "Authorization: Bearer token"-এ OAuth বিয়ারার টোকেন ব্যবহার করে আপনার পরিষেবা অ্যাকাউন্ট কী এক্সচেঞ্জ করেছেন।
  • "Content-Type: application/json"।

PATCH অনুরোধে নিম্নলিখিত ফর্ম্যাটের JSON বডি থাকতে হবে:

{ "orderUpdate": OrderUpdate }

OrderUpdate অবজেক্টে নিম্নলিখিত টপ-লেভেল ফিল্ড থাকে:

  • updateMask - আপনি যে অর্ডারের ফিল্ড আপডেট করছেন। রিজার্ভেশনের স্ট্যাটাস আপডেট করতে, ভ্যালু reservation.status, reservation.userVisibleStatusLabel হিসেবে সেট করুন।
  • order - আপডেটের কন্টেন্ট। আপনি যদি রিজার্ভেশনের কন্টেন্ট আপডেট করেন, তাহলে ভ্যালু আপডেট করা Order অবজেক্টে সেট করুন। আপনি যদি শুধু রিজার্ভেশনের স্ট্যাটাস আপডেট করেন (যেমন, "PENDING" থেকে "FULFILLED"), তাহলে অবজেক্টে নিম্নলিখিত ফিল্ড থাকে:

    • merchantOrderId - আপনার Order অবজেক্টে সেট করা একই আইডি।
    • lastUpdateTime - এই আপডেটের টাইমস্ট্যাম্প।
    • purchase - একটি অবজেক্ট যাতে নিম্নলিখিতগুলি রয়েছে:
      • status - ReservationStatus হিসেবে অর্ডারের স্ট্যাটাস, যেমন "CONFIRMED" বা "CANCELLED"।
      • userVisibleStatusLabel - ব্যবহারকারী নিজে ইন্টার‌্যাক্ট করতে পারেন এমন লেবেল যা অর্ডারের স্ট্যাটাস সম্পর্কে বিবরণ প্রদান করে, যেমন "আপনার রিজার্ভেশন কনফার্ম করা হয়েছে"।
  • userNotification (ঐচ্ছিক) - একটি userNotification অবজেক্ট যা এই আপডেট পাঠানোর সময় ব্যবহারকারীর ডিভাইসে দেখানো যেতে পারে। মনে রাখবেন যে এই অবজেক্ট অন্তর্ভুক্ত করার অর্থ এই নয় যে ব্যবহারকারীর ডিভাইসে বিজ্ঞপ্তি দেখা যাবেই।

নিম্নলিখিত স্যাম্পেল কোড একটি উদাহরণ OrderUpdate দেখায় যা রিজার্ভেশন অর্ডারের স্ট্যাটাস FULFILLED-এ আপডেট করে:

Node.js
// Import the 'googleapis' module for authorizing the request.
const {google} = require('googleapis');
// Import the 'request' module for sending an HTTP POST request.
const request = require('request');
// 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. Replace the string path with a path to your service account key.
const key = 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(
    key.client_email,
    null,
    key.private_key,
    ['https://www.googleapis.com/auth/actions.order.developer'],
    null
);
// Authorize the client asynchronously, passing in a callback to run upon authorization.
jwtClient.authorize((err, tokens) => {
    if (err) {
        console.log(err);
        return;
    }
    // Declare the ID of the order to update.
    const orderId = '<UNIQUE_MERCHANT_ORDER_ID>';

    const orderUpdateJson = new OrderUpdate({
        updateMask: [
          'lastUpdateTime',
          'contents.lineItems.reservation.status',
          'contents.lineItems.reservation.userVisibleStatusLabel',
      ].join(','),
        order: {
          merchantOrderId: orderId,
          lastUpdateTime: new Date().toISOString(),
          contents: {
            lineItems: [
              {
                reservation: {
                  status: 'FULFILLED',
                  userVisibleStatusLabel: 'Reservation fulfilled',
                },
              }
            ]
          }
        },
        reason: 'Reservation status was updated to fulfilled.',
    });

    // Set up the PATCH request header and body, including the authorized token
    // and order update.
    const bearer = 'Bearer ' + tokens.access_token;
    const options = {
        method: 'PATCH',
        url: `https://actions.googleapis.com/v3/orders/${orderId}`,
        headers: {
          'Authorization': bearer,
        },
        body: {
          header: {
            'isInSandbox': true,
          },
          orderUpdate: orderUpdateJson,
        },
        json: true,
      };
    // Send the PATCH request to the Orders API.
    request.patch(options, (err, httpResponse, body) => {
        if (err) {
            console.log('There was an error...');
            console.log(err);
            return;
        }
    });
});
Java
// Create order update
FieldMask fieldMask = FieldMask.newBuilder().addAllPaths(Arrays.asList(
    "lastUpdateTime",
    "contents.lineItems.reservation.status",
    "contents.lineItems.reservation.userVisibleStatusLabel"))
    .build();

OrderUpdateV3 orderUpdate = new OrderUpdateV3()
    .setOrder(new OrderV3()
        .setMerchantOrderId(orderId)
        .setLastUpdateTime(Instant.now().toString())
        .setContents(new OrderContents()
        .setLineItems(Collections.singletonList(new LineItemV3()
            .setReservation(new ReservationItemExtension()
                .setStatus("FULFILLED")
                .setUserVisibleStatusLabel("Reservation fulfilled."))))))
    .setUpdateMask(FieldMaskUtil.toString(fieldMask))
    .setReason("Reservation status was updated to fulfilled.");

// 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());
request.setEntity(entity);

// Make request
HttpClient httpClient = HttpClientBuilder.create().build();
HttpResponse response = httpClient.execute(request);
রিজার্ভেশনের স্ট্যাটাস সেট করুন

অর্ডার আপডেটের ReservationStatus অবশ্যই অর্ডারের বর্তমান অবস্থার বর্ণনামূলক হতে হবে। আপনার আপডেটের order.ReservationStatus ফিল্ডে, নিম্নলিখিত ভ্যালুগুলির মধ্যে যেকোনও একটি ব্যবহার করুন:

  • PENDING - আপনার অ্যাকশনের মাধ্যমে রিজার্ভেশন "তৈরি করা" হয়েছে, তবে আপনার ব্যাক-এন্ডে অতিরিক্ত প্রসেসিং প্রয়োজন।
  • CONFIRMED - আপনার শিডিউলিং ব্যাক-এন্ডে রিজার্ভেশন কনফার্ম করা হয়েছে।
  • CANCELLED - ব্যবহারকারী তার রিজার্ভেশন বাতিল করেছেন।
  • FULFILLED - ব্যবহারকারীর রিজার্ভেশন পরিষেবা দ্বারা পূরণ করা হয়েছে।
  • CHANGE_REQUESTED - ব্যবহারকারী রিজার্ভেশনে পরিবর্তন করার অনুরোধ করেছেন এবং পরিবর্তনটি প্রসেস করা হচ্ছে।
  • REJECTED - আপনি যদি রিজার্ভেশন প্রসেস বা অন্য কোনওভাবে কনফার্ম করতে না পারেন।

আপনার রিজার্ভেশনের সাথে প্রাসঙ্গিক প্রতিটি স্ট্যাটাসের জন্য অর্ডার সংক্রান্ত আপডেট পাঠান। যেমন, আপনার রিজার্ভেশন অনুরোধ করার পরে সেটি কনফার্ম করার জন্য যদি ম্যানুয়াল প্রসেসিংয়ের প্রয়োজন হয়, তাহলে অতিরিক্ত প্রসেসিং সম্পূর্ণ না হওয়া পর্যন্ত PENDING অর্ডার আপডেট পাঠান। প্রতিটি রিজার্ভেশনের জন্য প্রতিটি স্ট্যাটাস ভ্যালু প্রয়োজন হয় না।

সমস্যার সমাধান

টেস্ট করার সময় কোনও সমস্যা হলে, ট্রানজ্যাকশনের জন্য আমাদের সমস্যার সমাধান করার ধাপ পড়ুন।