- সম্পদ: প্রাপ্যতা
- সম্পদ
- পুনরাবৃত্তি
- সময়সূচী ব্যতিক্রম
- সময়কালের প্রয়োজনীয়তা
- SchedulingRuleOverrides
- নিশ্চিতকরণ মোড
- পদ্ধতি
সম্পদ: প্রাপ্যতা
বণিকের পরিষেবার একটি প্রাপ্যতা স্লট, সময় এবং দাগের সংখ্যা নির্দেশ করে।
JSON প্রতিনিধিত্ব |
---|
{ "startTime": string, "duration": string, "spotsTotal": string, "spotsOpen": string, "availabilityTag": string, "resources": { object ( |
ক্ষেত্র | |
---|---|
startTime | অ্যাপয়েন্টমেন্ট স্লটের শুরুর সময়। RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
duration | অ্যাপয়েন্টমেন্ট স্লটের সময়কাল নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' |
spotsTotal | এই প্রাপ্যতার মোট স্পট এবং খোলা দাগের সংখ্যা। উদাহরণ:
দ্রষ্টব্য: নীচে সংজ্ঞায়িত উপলব্ধতা কম্প্রেশন বিন্যাস ব্যবহার করে অনুরোধ পাঠানো হলে, এই দুটি ক্ষেত্র অনুমান করা হবে।
|
spotsOpen | খোলা জায়গার সংখ্যা। |
availabilityTag | এই প্রাপ্যতা স্লট সনাক্ত করতে একটি ঐচ্ছিক অস্বচ্ছ স্ট্রিং। সেট করা থাকলে, অ্যাপয়েন্টমেন্ট বুক/আপডেট/বাতিল করার অনুরোধে এটি অন্তর্ভুক্ত করা হবে। |
resources | বিভিন্ন স্টাফ সদস্য বা রুম পরিষেবার অংশ হলে অন্যদের থেকে এই প্রাপ্যতা স্লটটিকে দ্ব্যর্থিত করতে ব্যবহৃত ঐচ্ছিক সংস্থানগুলি। যেমন দুইজন প্রশিক্ষকের সাথে একই যোগ ক্লাস:
|
paymentOptionId[] | এই স্লটের জন্য অর্থ প্রদানের জন্য ব্যবহার করা যেতে পারে এমন অর্থপ্রদানের বিকল্পগুলি উল্লেখ করে আইডিগুলির একটি তালিকা৷ প্রকৃত অর্থপ্রদানের বিকল্পগুলি বণিক স্তরে সংজ্ঞায়িত করা হয় এবং একাধিক বণিকদের মধ্যেও শেয়ার করা যেতে পারে৷ এই ক্ষেত্রটি পরিষেবা বার্তায় নির্দিষ্ট করা যেকোনো payment_option_ids ওভাররাইড করে। একইভাবে এখানে উল্লেখ করা পেমেন্ট_অপশন_আইডিগুলিকে পরিষেবা বার্তায় উপস্থিত থাকতে হবে না, যদিও বণিক স্তরে সংজ্ঞায়িত করা আবশ্যক। |
recurrence | প্রাপ্যতার জন্য পুনরাবৃত্তি তথ্য, একাধিক শুরুর সময় প্রতিনিধিত্ব করে। একটি পুনরাবৃত্তিতে একটি কার্যদিবসের জন্য অ্যাপয়েন্টমেন্ট থাকা উচিত। |
scheduleException[] | সময় যখন এই পরিষেবা নির্ধারিত করা যাবে না. সময়সূচী ব্যতিক্রম বার্তার সংখ্যা সীমিত করতে, সন্নিহিত ব্যতিক্রমগুলিতে যোগদান বিবেচনা করুন। |
deposit | এই প্রাপ্যতার জন্য ঐচ্ছিক আমানত। একটি নির্দিষ্ট করা হলে পরিষেবা আমানত ওভাররাইড করে। |
noShowFee | এই প্রাপ্যতা জন্য ঐচ্ছিক কোন শো ফি. পরিষেবাটি ওভাররাইড করে যদি একটি নির্দিষ্ট করা হয় তবে কোনও শো ফি নেই৷ |
requireCreditCard | এই প্রাপ্যতা স্লট বুক করার জন্য ব্যবহারকারীকে একটি ক্রেডিট কার্ড প্রদান করতে হবে কিনা তা নির্দেশ করে৷ যদি মান সেট করা না থাকে, তবে এটি সেখানে সেট করা থাকলে পরিষেবা স্তর থেকে উত্তরাধিকারসূত্রে প্রাপ্ত হয়। (ঐচ্ছিক) |
ticketTypeId[] | এই প্রাপ্যতা স্লটের জন্য সমর্থিত টিকিটের প্রকারের একটি তালিকা নির্দেশ করে৷ সেট না থাকলে, এই স্লটের জন্য অভিভাবক পরিষেবাতে সমস্ত টিকিটের প্রকার উপলব্ধ। মনে রাখবেন যে এই ক্ষেত্রের মানগুলি অবশ্যই অভিভাবক পরিষেবাতে সংজ্ঞায়িত করা উচিত। উদাহরণ:
সপ্তাহের দিনগুলিতে ইনভেন্টরি প্রতিনিধিত্ব করতে:
এই সময়ের স্লটের জন্য তিনটি টিকিটের ধরন উপলব্ধ রয়েছে তা নির্দেশ করতে, হয় (ঐচ্ছিক) |
durationRequirement | স্লটের সময়কাল এবং/অথবা শেষ সময় দেখানোর প্রয়োজনীয়তা। স্লট অনুপলব্ধ হলে এই ক্ষেত্রটি উপেক্ষা করা হবে৷ থিংস-টু-ডু উল্লম্ব ব্যবহার করা হয় না। (ঐচ্ছিক) |
schedulingRuleOverrides | প্রাপ্যতা সময়সূচী নিয়ম. যদি ক্ষেত্রগুলি জনবহুল হয়, তবে সেগুলি পরিষেবা-স্তরের সময়সূচী বিধিগুলির সাথে সম্পর্কিত যে কোনও সময়সূচী নিয়মগুলিকে ওভাররাইড করবে৷ |
confirmationMode | এই উপলব্ধতা বুক করার সময় নিশ্চিতকরণ মোড ব্যবহার করা হবে। CONFIRMATION_MODE_SYNCHRONOUS এর নিশ্চিতকরণ মোড সহ উপলব্ধতার জন্য বুকিং তৈরি করার প্রচেষ্টা অবিলম্বে নিশ্চিত বা অস্বীকার করতে হবে৷ CONFIRMATION_MODE_ASYNCHRONOUS এর নিশ্চিতকরণ মোড সহ উপলব্ধতার জন্য বুকিং তৈরি করার প্রচেষ্টা অবশ্যই অবিলম্বে অস্বীকার করতে হবে বা মুলতুবি স্থিতি সহ তৈরি করতে হবে৷ |
সম্পদ
যখন বিভিন্ন স্টাফ সদস্য, বা রুম পরিষেবার অংশ হয় তখন একটি সংস্থান একে অপরের থেকে প্রাপ্যতা স্লটগুলিকে দ্ব্যর্থিত করতে ব্যবহৃত হয়। একই পরিষেবা এবং সময়ের ব্যবধানের জন্য একাধিক স্লট সহ-অবস্থান করতে পারে যখন তাদের বিভিন্ন সংস্থান থাকে।
JSON প্রতিনিধিত্ব |
---|
{ "staffId": string, "staffName": string, "roomId": string, "roomName": string, "partySize": integer } |
ক্ষেত্র | |
---|---|
staffId | পরিষেবা প্রদানকারী একজন কর্মী সদস্যের জন্য ঐচ্ছিক আইডি। এই ক্ষেত্রটি সমস্ত বণিক, পরিষেবা এবং প্রাপ্যতা রেকর্ড জুড়ে কর্মী সদস্যকে সনাক্ত করে৷ অতীতের বুকিংগুলির সাথে পারস্পরিক সম্পর্ককে অনুমতি দেওয়ার জন্য এটি সময়ের সাথে স্থিতিশীল হতে হবে। এই ক্ষেত্রটি অবশ্যই উপস্থিত থাকতে হবে যদি staffName উপস্থিত থাকে। |
staffName | পরিষেবা প্রদানকারী একজন কর্মী সদস্যের ঐচ্ছিক নাম। এই ক্ষেত্রটি বুকিং করা ব্যবহারকারীদের কাছে প্রদর্শিত হবে এবং একটি অস্বচ্ছ শনাক্তকারীর বিপরীতে মানুষের পাঠযোগ্য হওয়া উচিত। স্টাফআইডি উপস্থিত থাকলে এই ক্ষেত্রটি অবশ্যই উপস্থিত থাকতে হবে। |
roomId | পরিষেবাটি যে রুমে অবস্থিত তার জন্য একটি ঐচ্ছিক আইডি৷ এই ক্ষেত্রটি সমস্ত বণিক, পরিষেবা এবং উপলব্ধতার রেকর্ড জুড়ে রুমটিকে চিহ্নিত করে৷ অতীতের বুকিংগুলির সাথে পারস্পরিক সম্পর্ককে অনুমতি দেওয়ার জন্য এটি সময়ের সাথে স্থিতিশীল হতে হবে। roomName উপস্থিত থাকলে এই ক্ষেত্রটি অবশ্যই উপস্থিত থাকতে হবে৷ |
roomName | পরিষেবাটি যে রুমে অবস্থিত তার জন্য একটি ঐচ্ছিক নাম৷ এই ক্ষেত্রটি বুকিং করা ব্যবহারকারীদের কাছে প্রদর্শিত হবে এবং একটি অস্বচ্ছ শনাক্তকারীর বিপরীতে মানুষের পাঠযোগ্য হওয়া উচিত৷ (ঐচ্ছিক কিন্তু রুমআইডি উপস্থিত থাকলে প্রয়োজনীয়) ডাইনিংয়ে একটি কক্ষের নাম শুধুমাত্র বার বা প্যাটিওর মতো বসার জায়গার জন্য ব্যবহার করা উচিত এবং নির্দিষ্ট মূল্যের মেনু, বিশেষ ক্রিয়াকলাপ বা অন্য কোনও অ-রুম মূল্যের জন্য ব্যবহার করা উচিত নয় (যেমন রিজার্ভেশন বা ডিনার)। এটি দৃঢ়ভাবে সুপারিশ করা হয় যে ডিফল্ট বসার জায়গাটি এর সাথে যুক্ত একটি ঘর না থাকে। |
partySize | শুধুমাত্র ডাইনিংয়ের জন্য প্রযোজ্য: পার্টির আকার যা এই সময়ের স্লটে মিটমাট করা যেতে পারে। একটি রেস্তোরাঁ একই সময়ের জন্য একাধিক স্লটের সাথে যুক্ত হতে পারে, প্রতিটি একটি আলাদা পার্টির আকার নির্দিষ্ট করে, যদি উদাহরণস্বরূপ 2, 3, বা 4 জন লোক একটি রিজার্ভেশনের সাথে বসতে পারে। |
পুনরাবৃত্তি
পুনরাবৃত্তি বার্তাগুলি ঐচ্ছিক, তবে ধারাবাহিকভাবে পুনরাবৃত্তি করা প্রাপ্যতা স্লটগুলির আরও কমপ্যাক্ট উপস্থাপনা করার অনুমতি দেয়৷ তারা সাধারণত একটি দিনের কাজের সময়সূচী উপস্থাপন করে। ScheduleException বার্তাগুলি তারপর কাজের দিনের মধ্যে বুক করা/অনুপলব্ধ সময়সীমার প্রতিনিধিত্ব করতে ব্যবহৃত হয়।
প্রয়োজনীয়তা:
- প্রাপ্যতা স্লট বা পুনরাবৃত্তির সম্প্রসারণ অবশ্যই অভিন্ন স্লট তৈরি করবে না। যদি আইডি, স্টার্টটাইম, সময়কাল, এবং সংস্থানগুলি মিলে যায়, স্লটগুলিকে অভিন্ন হিসাবে বিবেচনা করা হয়৷
- একটি একক পরিষেবার স্লটের মধ্যে মানক প্রাপ্যতা বিন্যাস এবং পুনরাবৃত্তি মিশ্রিত করবেন না। পুনরাবৃত্তি সুবিধা বণিক/পরিষেবা যা অ্যাপয়েন্টমেন্ট অফার করে। স্ট্যান্ডার্ড ফরম্যাটটি নিয়মিত নির্ধারিত ক্লাস সহ বণিক/পরিষেবাগুলির জন্য তৈরি।
- পুনরাবৃত্তি 24 ঘন্টার বেশি স্থায়ী হওয়া উচিত নয়।
JSON প্রতিনিধিত্ব |
---|
{ "repeatUntil": string, "repeatEvery": string } |
ক্ষেত্র | |
---|---|
repeatUntil | অন্তর্ভুক্ত সর্বাধিক UTC টাইমস্ট্যাম্প প্রাপ্যতা পর্যন্ত পুনরাবৃত্তি হয়. RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: |
repeatEvery | ক্রমাগত প্রাপ্যতা স্লটের মধ্যে সময় নির্ধারণ করে। উদাহরণ: 20 মিনিটের সময়কাল সহ একটি উপলব্ধতা, প্রতি 30 মিনিটে একটি পুনরাবৃত্তি, সকাল 9:00 এ একটি শুরুর সময় এবং 11:00 পর্যন্ত একটি পুনরাবৃত্তি সকাল 9-9:20am, 9:30-9:50am, 10 এ স্লট দেবে -10:20am, 10:30-10:50am, 11-11:20am। (প্রয়োজনীয়) নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' |
সময়সূচী ব্যতিক্রম
ScheduleException বার্তাগুলি কার্যদিবসের মধ্যে বুক করা/অনুপলব্ধ সময় সীমার প্রতিনিধিত্ব করে, যা উপরে বর্ণিত পুনরাবৃত্তির ব্যতিক্রম। টাইম স্লট বুক করা হলে, নতুন অনুপলব্ধ সময় সীমাগুলি প্রতিফলিত করতে ব্যতিক্রমগুলির তালিকা আপডেট করা উচিত। পুনরাবৃত্তি নিজেই সংশোধন করা উচিত নয়.
JSON প্রতিনিধিত্ব |
---|
{
"timeRange": {
object ( |
ক্ষেত্র | |
---|---|
timeRange | ব্যতিক্রমের সময়সীমা। পুনরাবৃত্তি দ্বারা বর্ণিত যেকোনো স্লট যা এই বন্ধ-খোলা সময়সীমাকে ওভারল্যাপ করে তা অনুপলব্ধ বলে বিবেচিত হবে। উদাহরণ: যদি পুনরাবৃত্তিটি 20 মিনিটের একটি সময়কাল নির্দিষ্ট করে, প্রতি 30 মিনিটে একটি পুনরাবৃত্তি, সকাল 9:00 এর একটি শুরুর সময় এবং 11:00am পর্যন্ত একটি পুনরাবৃত্তি হয়, তাহলে 9:45am-11:00am একটি সময়সীমা সহ একটি শিডিউল ব্যতিক্রম অনুপলব্ধ হবে 9:30-9:50am, 10-10:20am, এবং 10:30-10:50am এ স্লট। নোট করুন যে সময় পরিসীমা বন্ধ-খোলা, 11am স্লটে শুরু হওয়া স্লট প্রভাবিত হবে না। |
সময়কালের প্রয়োজনীয়তা
এই enum নির্দেশ করে যে ব্যবহারকারীর অনুরোধ করা স্লট সময়কাল/শেষ সময় স্বীকার করতে বা দেখার জন্য কী প্রয়োজনীয়তা বিদ্যমান।
Enums | |
---|---|
DURATION_REQUIREMENT_UNSPECIFIED | শেষ সময় হ্যান্ডলিং নির্দিষ্ট করা হয় না. এটি ডিফল্ট। |
DO_NOT_SHOW_DURATION | শেষ সময় ব্যবহারকারীকে দেখানো হয় না। |
MUST_SHOW_DURATION | অ্যাপয়েন্টমেন্ট নেওয়ার আগে ব্যবহারকারীকে শেষ সময় দেখাতে হবে। |
SchedulingRuleOverrides
প্রাপ্যতা স্তর সময়সূচী নিয়ম.
JSON প্রতিনিধিত্ব |
---|
{ "lastBookableSec": string, "firstBookableSec": string, "lastOnlineCancellableSec": string } |
ক্ষেত্র | |
---|---|
lastBookableSec | শেষবার (সেকেন্ডে) এই স্লটটি বুক করা যাবে। এই টাইমস্ট্যাম্পটি অবশ্যই স্লটের স্টার্টসেক এর আগে হতে হবে (যদি ব্যবহারকারীরা শুরুর সময়ের পরে বুক করতে সক্ষম হন তবে পরিষেবা স্তর SchedulingRules.min_booking_before_end_time ব্যবহার করুন)। উপস্থিত থাকলে, সংশ্লিষ্ট পরিষেবার সময়সূচী বিধিগুলির min_booking_buffer-এ নির্দিষ্ট করা যেকোনো কিছুকে ওভাররাইড করবে। |
firstBookableSec | প্রথমবার (সেকেন্ডে) এই স্লটটি বুক করা যাবে। এই টাইমস্ট্যাম্পটি অবশ্যই স্লটের startSec এর আগে হতে হবে, অথবা উল্লেখিত থাকলে lastBookableSec। |
lastOnlineCancellableSec | সেট করা থাকলে, শেষ বার (Unix যুগের পর থেকে কয়েক সেকেন্ডে) এই নির্দিষ্ট অ্যাপয়েন্টমেন্ট স্লটটি Google এর সাথে রিজার্ভের মাধ্যমে বাতিল করা যেতে পারে। এই ক্ষেত্রটি যেকোনও পরিষেবা-স্তরের বাতিলকরণ নিয়মকে ওভাররাইড করবে। (ঐচ্ছিক) |
নিশ্চিতকরণ মোড
উপলব্ধতা বুকিং করার সময় নিশ্চিতকরণ মোড ব্যবহার করা হয়।
Enums | |
---|---|
CONFIRMATION_MODE_UNSPECIFIED | নিশ্চিতকরণ মোড নির্দিষ্ট করা হয়নি. সিঙ্ক্রোনাস নিশ্চিতকরণ ধরে নেওয়া হবে। |
CONFIRMATION_MODE_SYNCHRONOUS | এই প্রাপ্যতা জন্য বুকিং সিঙ্ক্রোনাস নিশ্চিত করা হবে. |
CONFIRMATION_MODE_ASYNCHRONOUS | এই প্রাপ্যতা জন্য বুকিং অ্যাসিঙ্ক্রোনাস নিশ্চিত করা হবে. |
পদ্ধতি | |
---|---|
| নির্দিষ্ট সমষ্টিকারী দ্বারা পরিচালিত একটি ব্যবসায়ীর বিদ্যমান Service Availability প্রতিস্থাপন করে এবং এটি ফেরত দেয়। |