Package google.type

সূচক

তারিখ

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

  • একটি সম্পূর্ণ তারিখ, অ-শূন্য বছর, মাস এবং দিনের মান সহ।
  • একটি মাস এবং দিন, একটি শূন্য বছর সহ (উদাহরণস্বরূপ, একটি বার্ষিকী)।
  • একটি শূন্য মাস এবং একটি শূন্য দিন সহ একটি বছর নিজেই।
  • একটি বছর এবং মাস, একটি শূন্য দিন সহ (উদাহরণস্বরূপ, একটি ক্রেডিট কার্ডের মেয়াদ শেষ হওয়ার তারিখ)।

সম্পর্কিত প্রকার:

ক্ষেত্র
year

int32

তারিখের বছর। একটি বছর ছাড়া একটি তারিখ নির্দিষ্ট করতে 1 থেকে 9999, বা 0 হতে হবে।

month

int32

এক বছরের মাস। একটি মাস এবং দিন ছাড়া একটি বছর নির্দিষ্ট করতে 1 থেকে 12, বা 0 হতে হবে৷

day

int32

এক মাসের দিন। 1 থেকে 31 পর্যন্ত হতে হবে এবং বছর এবং মাসের জন্য বৈধ হতে হবে, অথবা 0 নিজে থেকে একটি বছর বা একটি বছর এবং মাস উল্লেখ করতে হবে যেখানে দিনটি তাৎপর্যপূর্ণ নয়৷

সপ্তাহের দিন

সপ্তাহের একটি দিন প্রতিনিধিত্ব করে।

Enums
DAY_OF_WEEK_UNSPECIFIED সপ্তাহের দিন অনির্দিষ্ট।
MONDAY সোমবার
TUESDAY মঙ্গলবার
WEDNESDAY বুধবার
THURSDAY বৃহস্পতিবার
FRIDAY শুক্রবার
SATURDAY শনিবার
SUNDAY রবিবার

ব্যবধান

একটি টাইমস্ট্যাম্প শুরু (অন্তর্ভুক্ত) এবং একটি টাইমস্ট্যাম্প শেষ (একচেটিয়া) হিসাবে এনকোড করা একটি সময়ের ব্যবধানের প্রতিনিধিত্ব করে।

শুরু অবশ্যই শেষের চেয়ে কম বা সমান হতে হবে। যখন শুরু শেষের সমান হয়, তখন ব্যবধান খালি থাকে (সময়ের সাথে মেলে না)। যখন শুরু এবং শেষ উভয়ই অনির্দিষ্ট থাকে, তখন ব্যবধান যেকোনো সময় মেলে।

ক্ষেত্র
start_ time

Timestamp

ঐচ্ছিক। ব্যবধানের অন্তর্ভুক্তিমূলক শুরু।

নির্দিষ্ট করা হলে, এই ব্যবধানের সাথে মিলে যাওয়া একটি টাইমস্ট্যাম্প একই হতে হবে বা শুরু হওয়ার পরে।

end_ time

Timestamp

ঐচ্ছিক। ব্যবধানের একচেটিয়া শেষ।

নির্দিষ্ট করা থাকলে, এই ব্যবধানের সাথে মিলে যাওয়া একটি টাইমস্ট্যাম্প শেষ হওয়ার আগে হতে হবে।

ফোন নম্বর

একটি ফোন নম্বর প্রতিনিধিত্বকারী একটি বস্তু, একটি API ওয়্যার বিন্যাস হিসাবে উপযুক্ত।

এই প্রতিনিধিত্ব:

  • একটি ফোন নম্বরের লোকেল-নির্দিষ্ট বিন্যাসের জন্য ব্যবহার করা উচিত নয়, যেমন "+1 (650) 253-0000 ext. 123"

  • দক্ষ স্টোরেজ জন্য ডিজাইন করা হয় না

  • ডায়াল করার জন্য উপযুক্ত নাও হতে পারে - বিশেষ লাইব্রেরিগুলি (রেফারেন্স দেখুন) সেই উদ্দেশ্যে নম্বর পার্স করতে ব্যবহার করা উচিত

এই নম্বর দিয়ে অর্থপূর্ণ কিছু করতে, যেমন বিভিন্ন ব্যবহারের ক্ষেত্রে এটিকে ফর্ম্যাট করতে, প্রথমে এটিকে একটি i18n.phonenumbers.PhoneNumber অবজেক্টে রূপান্তর করুন।

উদাহরণস্বরূপ, জাভাতে এটি হবে:

com.google.type.PhoneNumber wireProto =
    com.google.type.PhoneNumber.newBuilder().build();
com.google.i18n.phonenumbers.Phonenumber.PhoneNumber phoneNumber =
    PhoneNumberUtil.getInstance().parse(wireProto.getE164Number(), "ZZ");
if (!wireProto.getExtension().isEmpty()) {
  phoneNumber.setExtension(wireProto.getExtension());
}

তথ্যসূত্র(গুলি):- https://github.com/google/libphonenumber

ক্ষেত্র
extension

string

ফোন নম্বরের এক্সটেনশন। আইটিইউ সুপারিশগুলিতে এক্সটেনশনটি মানসম্মত নয়, সর্বাধিক 40 সংখ্যার দৈর্ঘ্য সহ সংখ্যার একটি সিরিজ হিসাবে সংজ্ঞায়িত করা ছাড়া। অঙ্কগুলি ছাড়া, কিছু অন্যান্য ডায়ালিং অক্ষর যেমন ',' (একটি অপেক্ষার ইঙ্গিত করে) বা '#' এখানে সংরক্ষিত হতে পারে।

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

ইউনিয়ন ক্ষেত্র kind . প্রয়োজন। হয় একটি নিয়মিত নম্বর, বা একটি সংক্ষিপ্ত কোড৷ ভবিষ্যতে নীচের একটিতে নতুন ক্ষেত্র যোগ করা হতে পারে, তাই ক্লায়েন্টদের ফোন নম্বর উপেক্ষা করা উচিত যার জন্য তাদের কোড করা ক্ষেত্রগুলির কোনওটি সেট করা নেই৷ kind নিম্নলিখিতগুলির মধ্যে একটি হতে পারে:
e164_ number

string

ফোন নম্বর, একটি লিডিং প্লাস সাইন ('+') হিসাবে উপস্থাপিত, তারপরে একটি ফোন নম্বর যা একটি স্বস্তিদায়ক ITU E.164 ফর্ম্যাট ব্যবহার করে যার মধ্যে দেশ কলিং কোড (1 থেকে 3 সংখ্যা) এবং গ্রাহক নম্বর রয়েছে, কোনো অতিরিক্ত ছাড়াই স্পেস বা বিন্যাস। উদাহরণস্বরূপ: - সঠিক: "+15552220123" - ভুল: "+1 (555) 222-01234 x123"।

ITU E.164 ফরম্যাট পরবর্তীটিকে 12 সংখ্যার মধ্যে সীমাবদ্ধ করে, কিন্তু বাস্তবে সমস্ত দেশ এটিকে সম্মান করে না, তাই আমরা এখানে সেই সীমাবদ্ধতা শিথিল করি। শুধুমাত্র জাতীয় সংখ্যা অনুমোদিত নয়।

তথ্যসূত্র: - https://www.itu.int/rec/T-REC-E.164-201011-I - https://en.wikipedia.org/wiki/E.164 । - https://en.wikipedia.org/wiki/List_of_country_calling_codes

short_ code

ShortCode

একটি সংক্ষিপ্ত কোড।

তথ্যসূত্র(গুলি): - https://en.wikipedia.org/wiki/Short_code

শর্টকোড

একটি সংক্ষিপ্ত কোডের প্রতিনিধিত্বকারী একটি বস্তু, যা একটি ফোন নম্বর যা সাধারণত নিয়মিত ফোন নম্বরগুলির চেয়ে অনেক ছোট এবং MMS এবং SMS সিস্টেমে বার্তাগুলিকে সম্বোধন করতে, সেইসাথে সংক্ষিপ্ত ডায়ালিংয়ের জন্য ব্যবহার করা যেতে পারে (উদাহরণস্বরূপ "টেক্সট 611 কতগুলি দেখতে আপনার পরিকল্পনায় মিনিট বাকি আছে।")

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

ক্ষেত্র
region_ code

string

প্রয়োজন। BCP-47 অঞ্চলের কোড যেখানে এই শর্ট কোডে কল করা যেতে পারে, যেমন "US" এবং "BB"।

তথ্যসূত্র(গুলি):- http://www.unicode.org/reports/tr35/#unicode_region_subtag

number

string

প্রয়োজন। সংক্ষিপ্ত কোড সংখ্যা, একটি অগ্রণী প্লাস ('+') বা দেশের কলিং কোড ছাড়া। উদাহরণস্বরূপ "611"।

ডাক ঠিকানা

একটি ডাক ঠিকানা প্রতিনিধিত্ব করে। যেমন পোস্টাল ডেলিভারি বা পেমেন্ট ঠিকানার জন্য। একটি ডাক ঠিকানা দেওয়া হলে, একটি ডাক পরিষেবা একটি প্রিমাইজ, PO বক্স বা অনুরূপ আইটেমগুলি সরবরাহ করতে পারে। এটি ভৌগলিক অবস্থান (রাস্তা, শহর, পাহাড়) মডেল করার উদ্দেশ্যে নয়।

সাধারণ ব্যবহারে একটি ঠিকানা ব্যবহারকারীর ইনপুট বা বিদ্যমান ডেটা আমদানির মাধ্যমে তৈরি করা হবে, প্রক্রিয়ার ধরনের উপর নির্ভর করে।

ঠিকানা ইনপুট / সম্পাদনা সংক্রান্ত পরামর্শ: - একটি আন্তর্জাতিকীকরণ-প্রস্তুত ঠিকানা উইজেট ব্যবহার করুন যেমন https://github.com/google/libaddressinput ) - ব্যবহারকারীদের UI উপাদানগুলি ইনপুট বা ক্ষেত্রগুলির সম্পাদনার জন্য উপস্থাপন করা উচিত নয় যেখানে সেই ক্ষেত্রটি রয়েছে ব্যবহৃত

এই স্কিমাটি কীভাবে ব্যবহার করবেন সে সম্পর্কে আরও নির্দেশনার জন্য, দেখুন: https://support.google.com/business/answer/6397478

ক্ষেত্র
revision

int32

PostalAddress স্কিমা সংশোধন। এটি অবশ্যই 0 এ সেট করা উচিত, যা সর্বশেষ সংশোধন।

সমস্ত নতুন পুনর্বিবেচনা অবশ্যই পুরানো সংশোধনগুলির সাথে সামঞ্জস্যপূর্ণ হতে হবে৷

region_ code

string

প্রয়োজন। ঠিকানার দেশ/অঞ্চলের CLDR অঞ্চল কোড। এটি কখনই অনুমান করা যায় না এবং মানটি সঠিক কিনা তা নিশ্চিত করা ব্যবহারকারীর উপর নির্ভর করে। বিস্তারিত জানার জন্য https://cldr.unicode.org/ এবং https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html দেখুন। উদাহরণ: সুইজারল্যান্ডের জন্য "CH"।

language_ code

string

ঐচ্ছিক। এই ঠিকানার বিষয়বস্তুর BCP-47 ভাষার কোড (যদি জানা থাকে)। এটি প্রায়শই ইনপুট ফর্মের UI ভাষা বা ঠিকানার দেশ/অঞ্চলে ব্যবহৃত ভাষাগুলির মধ্যে একটি বা তাদের প্রতিলিপিকৃত সমতুল্য ভাষার সাথে মিলবে বলে আশা করা হয়। এটি নির্দিষ্ট কিছু দেশে বিন্যাসকে প্রভাবিত করতে পারে, কিন্তু ডেটার সঠিকতার জন্য গুরুত্বপূর্ণ নয় এবং এটি কখনই কোনো বৈধতা বা অন্য ফরম্যাটিং সংক্রান্ত ক্রিয়াকলাপকে প্রভাবিত করবে না।

যদি এই মানটি জানা না থাকে তবে এটি বাদ দেওয়া উচিত (সম্ভবত ভুল ডিফল্ট নির্দিষ্ট করার পরিবর্তে)।

উদাহরণ: "zh-Hant", "ja", "ja-Latn", "en"।

postal_ code

string

ঐচ্ছিক। ঠিকানার পোস্টাল কোড। সমস্ত দেশে পোস্টাল কোড ব্যবহার করা হয় না বা উপস্থিত থাকার প্রয়োজন হয় না, তবে যেখানে সেগুলি ব্যবহার করা হয়, তারা ঠিকানার অন্যান্য অংশগুলির সাথে অতিরিক্ত বৈধতা ট্রিগার করতে পারে (উদাহরণস্বরূপ মার্কিন যুক্তরাষ্ট্রে রাজ্য/জিপ বৈধতা)।

sorting_ code

string

ঐচ্ছিক। অতিরিক্ত, দেশ-নির্দিষ্ট, সাজানোর কোড। এটি বেশিরভাগ অঞ্চলে ব্যবহৃত হয় না। যেখানে এটি ব্যবহার করা হয়, মানটি হয় "CEDEX" এর মতো একটি স্ট্রিং, ঐচ্ছিকভাবে একটি সংখ্যা (উদাহরণস্বরূপ "CEDEX 7"), অথবা শুধুমাত্র একটি সংখ্যা, যা "সেক্টর কোড" (জ্যামাইকা), "ডেলিভারি এলাকা নির্দেশক" প্রতিনিধিত্ব করে " (মালাউই) বা "পোস্ট অফিস সূচক" (উদাহরণস্বরূপ কোট ডি'আইভরি)।

administrative_ area

string

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

locality

string

ঐচ্ছিক। সাধারণত ঠিকানার শহর/শহরের অংশকে বোঝায়। উদাহরণ: ইউএস সিটি, আইটি কমিউন, ইউকে পোস্ট টাউন। বিশ্বের এমন অঞ্চলে যেখানে লোকালয়টি ভালভাবে সংজ্ঞায়িত করা হয় না বা এই কাঠামোর সাথে ভালভাবে ফিট করে না, লোকালয়টি খালি রাখুন এবং ঠিকানা_লাইন ব্যবহার করুন।

sublocality

string

ঐচ্ছিক। ঠিকানার উপ-অবস্থান। উদাহরণস্বরূপ, এটি পাড়া, বরো, জেলা হতে পারে।

address_ lines[]

string

একটি ঠিকানার নিম্ন স্তরের বর্ণনা করে অসংগঠিত ঠিকানা লাইন।

কারণ ঠিকানা_লাইনের মানগুলির টাইপ তথ্য নেই এবং কখনও কখনও একটি একক ক্ষেত্রে একাধিক মান থাকতে পারে (উদাহরণস্বরূপ "অস্টিন, TX"), এটি গুরুত্বপূর্ণ যে লাইনের ক্রমটি পরিষ্কার। ঠিকানার লাইনের ক্রম ঠিকানার দেশ/অঞ্চলের জন্য "খামের আদেশ" হওয়া উচিত। যেখানে এটি পরিবর্তিত হতে পারে (উদাহরণস্বরূপ জাপান), ঠিকানা_ভাষাটি এটিকে স্পষ্ট করার জন্য ব্যবহার করা হয় (উদাহরণস্বরূপ বড় থেকে ছোট অর্ডারের জন্য "ja" এবং ছোট থেকে বড়ের জন্য "ja-Latn" বা "en")। এইভাবে, ভাষার উপর ভিত্তি করে একটি ঠিকানার সবচেয়ে নির্দিষ্ট লাইন নির্বাচন করা যেতে পারে।

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

শুধুমাত্র একটি অঞ্চল_কোড এবং ঠিকানা_লাইন সমন্বিত একটি ঠিকানা তৈরি করা, এবং তারপরে জিওকোডিং হল সম্পূর্ণ অসংগঠিত ঠিকানাগুলি পরিচালনা করার প্রস্তাবিত উপায় (ঠিকানার কোন অংশগুলি স্থানীয় বা প্রশাসনিক এলাকা হওয়া উচিত তা অনুমান করার বিপরীতে)।

recipients[]

string

ঐচ্ছিক। ঠিকানায় প্রাপক। এই ক্ষেত্রটিতে, নির্দিষ্ট পরিস্থিতিতে, বহুরেখার তথ্য থাকতে পারে। উদাহরণস্বরূপ, এতে "যত্ন" তথ্য থাকতে পারে।

organization

string

ঐচ্ছিক। ঠিকানায় প্রতিষ্ঠানের নাম।

TimeOfDay

দিনের একটি সময় প্রতিনিধিত্ব করে। তারিখ এবং সময় অঞ্চল হয় উল্লেখযোগ্য নয় বা অন্য কোথাও নির্দিষ্ট করা হয়েছে৷ একটি API লিপ সেকেন্ডের অনুমতি দিতে বেছে নিতে পারে। সম্পর্কিত প্রকারগুলি হল google.type.Date এবং google.protobuf.Timestamp ।

ক্ষেত্র
hours

int32

24 ঘন্টা ফরম্যাটে দিনের ঘন্টা। 0-এর থেকে বড় বা সমান হতে হবে এবং সাধারণত 23-এর থেকে কম বা সমান হতে হবে৷ ব্যবসা বন্ধ হওয়ার সময় মতো পরিস্থিতিগুলির জন্য একটি API "24:00:00" মানকে অনুমতি দিতে বেছে নিতে পারে৷

minutes

int32

এক ঘণ্টার মিনিট। 0 এর থেকে বড় বা সমান এবং 59 এর থেকে কম বা সমান হতে হবে।

seconds

int32

এক মিনিটের সেকেন্ড। 0 এর থেকে বড় বা সমান হতে হবে এবং সাধারণত 59 এর থেকে কম বা সমান হতে হবে। একটি API 60 মান অনুমোদন করতে পারে যদি এটি লিপ-সেকেন্ডের অনুমতি দেয়।

nanos

int32

সেকেন্ডের ভগ্নাংশ, ন্যানোসেকেন্ডে। 0 এর থেকে বড় বা সমান এবং 999,999,999 এর থেকে কম বা সমান হতে হবে।

টাইমজোন

IANA টাইম জোন ডেটাবেস থেকে একটি সময় অঞ্চল প্রতিনিধিত্ব করে৷

ক্ষেত্র
id

string

IANA টাইম জোন ডাটাবেস টাইম জোন। যেমন "America/New_York"।

version

string

ঐচ্ছিক। IANA টাইম জোন ডাটাবেস সংস্করণ নম্বর। যেমন "2019a"।