REST Resource: inventory.partners.merchants.services.availability

সম্পদ: প্রাপ্যতা

বণিকের পরিষেবার একটি প্রাপ্যতা স্লট, সময় এবং দাগের সংখ্যা নির্দেশ করে।

JSON প্রতিনিধিত্ব
{
  "startTime": string,
  "duration": string,
  "spotsTotal": string,
  "spotsOpen": string,
  "availabilityTag": string,
  "resources": {
    object (Resources)
  },
  "paymentOptionId": [
    string
  ],
  "recurrence": {
    object (Recurrence)
  },
  "scheduleException": [
    {
      object (ScheduleException)
    }
  ],
  "deposit": {
    object (Deposit)
  },
  "noShowFee": {
    object (NoShowFee)
  },
  "requireCreditCard": enum (RequireCreditCard),
  "ticketTypeId": [
    string
  ],
  "durationRequirement": enum (DurationRequirement),
  "schedulingRuleOverrides": {
    object (SchedulingRuleOverrides)
  },
  "confirmationMode": enum (ConfirmationMode)
}
ক্ষেত্র
startTime

string ( Timestamp format)

অ্যাপয়েন্টমেন্ট স্লটের শুরুর সময়।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

duration

string ( Duration format)

অ্যাপয়েন্টমেন্ট স্লটের সময়কাল

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

spotsTotal

string ( int64 format)

এই প্রাপ্যতার মোট স্পট এবং খোলা দাগের সংখ্যা। উদাহরণ:

  • 3টি বুক করা সহ 10টি স্পটের যোগ ক্লাস: availability {spotsTotal: 10, spotsOpen: 7 ...}
  • চেয়ার ম্যাসেজ সেশন যা ইতিমধ্যেই সম্পূর্ণ বুক করা হয়েছে: availability {spotsTotal: 1, spotsOpen: 0 ...}

দ্রষ্টব্য: নীচে সংজ্ঞায়িত উপলব্ধতা কম্প্রেশন বিন্যাস ব্যবহার করে অনুরোধ পাঠানো হলে, এই দুটি ক্ষেত্র অনুমান করা হবে।

  • একটি পুনরাবৃত্তি বোঝায় spotsTotal=1 এবং spotsOpen=1 ।
  • একটি ScheduleException বোঝায় spotsTotal=1 এবং spotsOpen=0 ।
spotsOpen

string ( int64 format)

খোলা জায়গার সংখ্যা।

availabilityTag

string

এই প্রাপ্যতা স্লট সনাক্ত করতে একটি ঐচ্ছিক অস্বচ্ছ স্ট্রিং। সেট করা থাকলে, অ্যাপয়েন্টমেন্ট বুক/আপডেট/বাতিল করার অনুরোধে এটি অন্তর্ভুক্ত করা হবে।

resources

object ( Resources )

বিভিন্ন স্টাফ সদস্য বা রুম পরিষেবার অংশ হলে অন্যদের থেকে এই প্রাপ্যতা স্লটটিকে দ্ব্যর্থিত করতে ব্যবহৃত ঐচ্ছিক সংস্থানগুলি।

যেমন দুইজন প্রশিক্ষকের সাথে একই যোগ ক্লাস:

availability { resources { staffId: "1" staffName: "Amy" }
               spotsTotal: 10 spotsOpen: 7 }
availability { resources { staffId: "2" staffName: "John" }
               spotsTotal: 5 spotsOpen: 2 }
paymentOptionId[]

string

এই স্লটের জন্য অর্থ প্রদানের জন্য ব্যবহার করা যেতে পারে এমন অর্থপ্রদানের বিকল্পগুলি উল্লেখ করে আইডিগুলির একটি তালিকা৷ প্রকৃত অর্থপ্রদানের বিকল্পগুলি বণিক স্তরে সংজ্ঞায়িত করা হয় এবং একাধিক বণিকদের মধ্যেও শেয়ার করা যেতে পারে৷

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

recurrence

object ( Recurrence )

প্রাপ্যতার জন্য পুনরাবৃত্তি তথ্য, একাধিক শুরুর সময় প্রতিনিধিত্ব করে। একটি পুনরাবৃত্তিতে একটি কার্যদিবসের জন্য অ্যাপয়েন্টমেন্ট থাকা উচিত।

scheduleException[]

object ( ScheduleException )

সময় যখন এই পরিষেবা নির্ধারিত করা যাবে না. সময়সূচী ব্যতিক্রম বার্তার সংখ্যা সীমিত করতে, সন্নিহিত ব্যতিক্রমগুলিতে যোগদান বিবেচনা করুন।

deposit

object ( Deposit )

এই প্রাপ্যতার জন্য ঐচ্ছিক আমানত। একটি নির্দিষ্ট করা হলে পরিষেবা আমানত ওভাররাইড করে।

noShowFee

object ( NoShowFee )

এই প্রাপ্যতা জন্য ঐচ্ছিক কোন শো ফি. পরিষেবাটি ওভাররাইড করে যদি একটি নির্দিষ্ট করা হয় তবে কোনও শো ফি নেই৷

requireCreditCard

enum ( RequireCreditCard )

এই প্রাপ্যতা স্লট বুক করার জন্য ব্যবহারকারীকে একটি ক্রেডিট কার্ড প্রদান করতে হবে কিনা তা নির্দেশ করে৷ যদি মান সেট করা না থাকে, তবে এটি সেখানে সেট করা থাকলে পরিষেবা স্তর থেকে উত্তরাধিকারসূত্রে প্রাপ্ত হয়। (ঐচ্ছিক)

ticketTypeId[]

string

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

  • চার ধরনের টিকিট সহ পরিষেবা: TicketType {ticketTypeId: "adult_1" shortDescription: "Adult weekdays"} TicketType {ticketTypeId: "adult_2" shortDescription: "Adult weekends"} TicketType {ticketTypeId: "Youth_1 weeks" {ticketType" shortDescription: "TicketType"} টিকিট টাইপআইডি: "Youth_2" সংক্ষিপ্ত বিবরণ: "ইয়ুথ উইকএন্ড"}

সপ্তাহের দিনগুলিতে ইনভেন্টরি প্রতিনিধিত্ব করতে: availability {ticketTypeId: "adult_1" ticketTypeId: "youth_1"...} । ছুটির দিনে ইনভেন্টরি প্রতিনিধিত্ব করতে: availability {ticketTypeId: "adult_2" ticketTypeId: "youth_2"...} ।

  • তিন ধরনের টিকিট সহ পরিষেবা: টিকিট টাইপ {টিকিট টাইপআইডি: "প্রাপ্তবয়স্ক" সংক্ষিপ্ত বিবরণ: "বয়স্ক"} টিকিট টাইপ {টিকিট টাইপআইডি: "যুব" সংক্ষিপ্ত বিবরণ: "যুব"} টিকেট টাইপ {টিকিট টাইপআইডি: "সিনিয়র" সংক্ষিপ্ত বিবরণ: "সিনিয়র"}

এই সময়ের স্লটের জন্য তিনটি টিকিটের ধরন উপলব্ধ রয়েছে তা নির্দেশ করতে, হয় availability {ticketTypeId: "adult" ticketTypeId: "youth" ticketTypeId: "senior" ...} অথবা `উপলভ্যতা {...}' ব্যবহার করুন (সেট করবেন না এই স্লটে ticketTypeId)।

(ঐচ্ছিক)

durationRequirement

enum ( DurationRequirement )

স্লটের সময়কাল এবং/অথবা শেষ সময় দেখানোর প্রয়োজনীয়তা। স্লট অনুপলব্ধ হলে এই ক্ষেত্রটি উপেক্ষা করা হবে৷ থিংস-টু-ডু উল্লম্ব ব্যবহার করা হয় না। (ঐচ্ছিক)

schedulingRuleOverrides

object ( SchedulingRuleOverrides )

প্রাপ্যতা সময়সূচী নিয়ম. যদি ক্ষেত্রগুলি জনবহুল হয়, তবে সেগুলি পরিষেবা-স্তরের সময়সূচী বিধিগুলির সাথে সম্পর্কিত যে কোনও সময়সূচী নিয়মগুলিকে ওভাররাইড করবে৷

confirmationMode

enum ( ConfirmationMode )

এই উপলব্ধতা বুক করার সময় নিশ্চিতকরণ মোড ব্যবহার করা হবে। CONFIRMATION_MODE_SYNCHRONOUS এর নিশ্চিতকরণ মোড সহ উপলব্ধতার জন্য বুকিং তৈরি করার প্রচেষ্টা অবিলম্বে নিশ্চিত বা অস্বীকার করতে হবে৷ CONFIRMATION_MODE_ASYNCHRONOUS এর নিশ্চিতকরণ মোড সহ উপলব্ধতার জন্য বুকিং তৈরি করার প্রচেষ্টা অবশ্যই অবিলম্বে অস্বীকার করতে হবে বা মুলতুবি স্থিতি সহ তৈরি করতে হবে৷

সম্পদ

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

JSON প্রতিনিধিত্ব
{
  "staffId": string,
  "staffName": string,
  "roomId": string,
  "roomName": string,
  "partySize": integer
}
ক্ষেত্র
staffId

string

পরিষেবা প্রদানকারী একজন কর্মী সদস্যের জন্য ঐচ্ছিক আইডি। এই ক্ষেত্রটি সমস্ত বণিক, পরিষেবা এবং প্রাপ্যতা রেকর্ড জুড়ে কর্মী সদস্যকে সনাক্ত করে৷ অতীতের বুকিংগুলির সাথে পারস্পরিক সম্পর্ককে অনুমতি দেওয়ার জন্য এটি সময়ের সাথে স্থিতিশীল হতে হবে। এই ক্ষেত্রটি অবশ্যই উপস্থিত থাকতে হবে যদি staffName উপস্থিত থাকে।

staffName

string

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

roomId

string

পরিষেবাটি যে রুমে অবস্থিত তার জন্য একটি ঐচ্ছিক আইডি৷ এই ক্ষেত্রটি সমস্ত বণিক, পরিষেবা এবং উপলব্ধতার রেকর্ড জুড়ে রুমটিকে চিহ্নিত করে৷ অতীতের বুকিংগুলির সাথে পারস্পরিক সম্পর্ককে অনুমতি দেওয়ার জন্য এটি সময়ের সাথে স্থিতিশীল হতে হবে। roomName উপস্থিত থাকলে এই ক্ষেত্রটি অবশ্যই উপস্থিত থাকতে হবে৷

roomName

string

পরিষেবাটি যে রুমে অবস্থিত তার জন্য একটি ঐচ্ছিক নাম৷ এই ক্ষেত্রটি বুকিং করা ব্যবহারকারীদের কাছে প্রদর্শিত হবে এবং একটি অস্বচ্ছ শনাক্তকারীর বিপরীতে মানুষের পাঠযোগ্য হওয়া উচিত৷ (ঐচ্ছিক কিন্তু রুমআইডি উপস্থিত থাকলে প্রয়োজনীয়) ডাইনিংয়ে একটি কক্ষের নাম শুধুমাত্র বার বা প্যাটিওর মতো বসার জায়গার জন্য ব্যবহার করা উচিত এবং নির্দিষ্ট মূল্যের মেনু, বিশেষ ক্রিয়াকলাপ বা অন্য কোনও অ-রুম মূল্যের জন্য ব্যবহার করা উচিত নয় (যেমন রিজার্ভেশন বা ডিনার)। এটি দৃঢ়ভাবে সুপারিশ করা হয় যে ডিফল্ট বসার জায়গাটি এর সাথে যুক্ত একটি ঘর না থাকে।

partySize

integer

শুধুমাত্র ডাইনিংয়ের জন্য প্রযোজ্য: পার্টির আকার যা এই সময়ের স্লটে মিটমাট করা যেতে পারে। একটি রেস্তোরাঁ একই সময়ের জন্য একাধিক স্লটের সাথে যুক্ত হতে পারে, প্রতিটি একটি আলাদা পার্টির আকার নির্দিষ্ট করে, যদি উদাহরণস্বরূপ 2, 3, বা 4 জন লোক একটি রিজার্ভেশনের সাথে বসতে পারে।

পুনরাবৃত্তি

পুনরাবৃত্তি বার্তাগুলি ঐচ্ছিক, তবে ধারাবাহিকভাবে পুনরাবৃত্তি করা প্রাপ্যতা স্লটগুলির আরও কমপ্যাক্ট উপস্থাপনা করার অনুমতি দেয়৷ তারা সাধারণত একটি দিনের কাজের সময়সূচী উপস্থাপন করে। ScheduleException বার্তাগুলি তারপর কাজের দিনের মধ্যে বুক করা/অনুপলব্ধ সময়সীমার প্রতিনিধিত্ব করতে ব্যবহৃত হয়।

প্রয়োজনীয়তা:

  1. প্রাপ্যতা স্লট বা পুনরাবৃত্তির সম্প্রসারণ অবশ্যই অভিন্ন স্লট তৈরি করবে না। যদি আইডি, স্টার্টটাইম, সময়কাল, এবং সংস্থানগুলি মিলে যায়, স্লটগুলিকে অভিন্ন হিসাবে বিবেচনা করা হয়৷
  2. একটি একক পরিষেবার স্লটের মধ্যে মানক প্রাপ্যতা বিন্যাস এবং পুনরাবৃত্তি মিশ্রিত করবেন না। পুনরাবৃত্তি সুবিধা বণিক/পরিষেবা যা অ্যাপয়েন্টমেন্ট অফার করে। স্ট্যান্ডার্ড ফরম্যাটটি নিয়মিত নির্ধারিত ক্লাস সহ বণিক/পরিষেবাগুলির জন্য তৈরি।
  3. পুনরাবৃত্তি 24 ঘন্টার বেশি স্থায়ী হওয়া উচিত নয়।
JSON প্রতিনিধিত্ব
{
  "repeatUntil": string,
  "repeatEvery": string
}
ক্ষেত্র
repeatUntil

string ( Timestamp format)

অন্তর্ভুক্ত সর্বাধিক UTC টাইমস্ট্যাম্প প্রাপ্যতা পর্যন্ত পুনরাবৃত্তি হয়.

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

repeatEvery

string ( Duration format)

ক্রমাগত প্রাপ্যতা স্লটের মধ্যে সময় নির্ধারণ করে।

উদাহরণ: 20 মিনিটের সময়কাল সহ একটি উপলব্ধতা, প্রতি 30 মিনিটে একটি পুনরাবৃত্তি, সকাল 9:00 এ একটি শুরুর সময় এবং 11:00 পর্যন্ত একটি পুনরাবৃত্তি সকাল 9-9:20am, 9:30-9:50am, 10 এ স্লট দেবে -10:20am, 10:30-10:50am, 11-11:20am। (প্রয়োজনীয়)

নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা সহ সেকেন্ডে একটি সময়কাল, ' s ' দিয়ে শেষ হয়৷ উদাহরণ: "3.5s" ।

সময়সূচী ব্যতিক্রম

ScheduleException বার্তাগুলি কার্যদিবসের মধ্যে বুক করা/অনুপলব্ধ সময় সীমার প্রতিনিধিত্ব করে, যা উপরে বর্ণিত পুনরাবৃত্তির ব্যতিক্রম। টাইম স্লট বুক করা হলে, নতুন অনুপলব্ধ সময় সীমাগুলি প্রতিফলিত করতে ব্যতিক্রমগুলির তালিকা আপডেট করা উচিত। পুনরাবৃত্তি নিজেই সংশোধন করা উচিত নয়.

JSON প্রতিনিধিত্ব
{
  "timeRange": {
    object (TimeRange)
  }
}
ক্ষেত্র
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 নির্দেশ করে যে ব্যবহারকারীর অনুরোধ করা স্লট সময়কাল/শেষ সময় স্বীকার করতে বা দেখার জন্য কী প্রয়োজনীয়তা বিদ্যমান।

এনামস
DURATION_REQUIREMENT_UNSPECIFIED শেষ সময় হ্যান্ডলিং নির্দিষ্ট করা হয় না. এটি ডিফল্ট।
DO_NOT_SHOW_DURATION শেষ সময় ব্যবহারকারীকে দেখানো হয় না।
MUST_SHOW_DURATION অ্যাপয়েন্টমেন্ট নেওয়ার আগে ব্যবহারকারীকে শেষ সময় দেখাতে হবে।

SchedulingRuleOverrides

প্রাপ্যতা স্তর সময়সূচী নিয়ম.

JSON প্রতিনিধিত্ব
{
  "lastBookableSec": string,
  "firstBookableSec": string,
  "lastOnlineCancellableSec": string
}
ক্ষেত্র
lastBookableSec

string ( int64 format)

শেষবার (সেকেন্ডে) এই স্লটটি বুক করা যাবে। এই টাইমস্ট্যাম্পটি অবশ্যই স্লটের স্টার্টসেক এর আগে হতে হবে (যদি ব্যবহারকারীরা শুরুর সময়ের পরে বুক করতে সক্ষম হন তবে পরিষেবা স্তর SchedulingRules.min_booking_before_end_time ব্যবহার করুন)। উপস্থিত থাকলে, সংশ্লিষ্ট পরিষেবার সময়সূচী বিধিগুলির min_booking_buffer-এ নির্দিষ্ট করা যেকোনো কিছুকে ওভাররাইড করবে।

firstBookableSec

string ( int64 format)

প্রথমবার (সেকেন্ডে) এই স্লটটি বুক করা যাবে। এই টাইমস্ট্যাম্পটি অবশ্যই স্লটের startSec এর আগে হতে হবে, অথবা উল্লেখিত থাকলে lastBookableSec।

lastOnlineCancellableSec

string ( int64 format)

সেট করা থাকলে, শেষ বার (Unix যুগের পর থেকে কয়েক সেকেন্ডে) এই নির্দিষ্ট অ্যাপয়েন্টমেন্ট স্লটটি Google এর সাথে রিজার্ভের মাধ্যমে বাতিল করা যেতে পারে। এই ক্ষেত্রটি যেকোনও পরিষেবা-স্তরের বাতিলকরণ নিয়মকে ওভাররাইড করবে। (ঐচ্ছিক)

নিশ্চিতকরণ মোড

উপলব্ধতা বুকিং করার সময় নিশ্চিতকরণ মোড ব্যবহার করা হয়।

এনামস
CONFIRMATION_MODE_UNSPECIFIED নিশ্চিতকরণ মোড নির্দিষ্ট করা হয়নি. সিঙ্ক্রোনাস নিশ্চিতকরণ ধরে নেওয়া হবে।
CONFIRMATION_MODE_SYNCHRONOUS এই প্রাপ্যতা জন্য বুকিং সিঙ্ক্রোনাস নিশ্চিত করা হবে.
CONFIRMATION_MODE_ASYNCHRONOUS এই প্রাপ্যতা জন্য বুকিং অ্যাসিঙ্ক্রোনাস নিশ্চিত করা হবে.

পদ্ধতি

replace

 নির্দিষ্ট এগ্রিগেটর দ্বারা পরিচালিত একটি বণিকের বিদ্যমান Service Availability প্রতিস্থাপন করে এবং এটি ফেরত দেয়।