Package google.type

الفهرس

• Date (رسالة)
• DayOfWeek (تعداد)
• Interval (رسالة)
• PhoneNumber (رسالة)
• PhoneNumber.ShortCode (رسالة)
• PostalAddress (رسالة)
• TimeOfDay (رسالة)
• TimeZone (رسالة)

التاريخ

يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:

• تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
• شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
• سنة بمفردها، بشهر صفري ويوم صفري.
• سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).

الأنواع ذات الصلة:

• google.type.TimeOfDay
• google.type.DateTime
• google.protobuf.Timestamp

الحقول
year	int32 السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة.
month	int32 شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم.
day	int32 يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر عندما لا يكون اليوم مهمًا.

DayOfWeek

يمثل يومًا من الأسبوع.

عمليات التعداد
DAY_OF_WEEK_UNSPECIFIED	لم يتم تحديد اليوم من الأسبوع.
MONDAY	الاثنين
TUESDAY	الثلاثاء
WEDNESDAY	الأربعاء
THURSDAY	الخميس
FRIDAY	الجمعة
SATURDAY	السبت
SUNDAY	الأحد

الفاصل الزمني

ويمثل فاصلاً زمنيًا مشفّرًا كبداية طابع زمني (شامل) ونهاية طابع زمني (غير شاملة).

يجب أن تكون البداية أقل من أو تساوي النهاية. عندما تساوي البداية النهاية، يكون الفاصل الزمني فارغًا (لا يتطابق أي وقت). عندما تكون البداية والنهاية غير محددة، يتطابق الفاصل الزمني في أي وقت.

الحقول
start_time	Timestamp اختياريّ. بداية شاملة للفاصل الزمني. يجب أن يكون الطابع الزمني الذي يطابق هذا الفاصل الزمني هو نفسه أو بعد بدئه في حال تحديده.
end_time	Timestamp اختياريّ. نهاية حصرية للفاصل الزمني. ويجب أن يقع الطابع الزمني الذي يتطابق مع هذا الفاصل الزمني قبل النهاية، في حال تحديده.

PhoneNumber

كائن يمثّل رقم هاتف ومناسب لتنسيق سلك واجهة برمجة التطبيقات

هذا التمثيل:

• يجب عدم استخدامه لتنسيق رقم الهاتف الخاص بالمنطقة، مثلاً " [phone] ext. 123"

• غير مصمم لتوفير مساحة تخزين فعالة

• قد لا تكون مناسبة للاتصال - يجب استخدام المكتبات المتخصّصة (راجع المراجع) لتحليل الرقم لذلك الغرض

لتنفيذ إجراء مفيد بهذا الرقم، مثل تنسيقه لحالات استخدام مختلفة، عليك تحويله إلى عنصر i18n.phonenumbers.PhoneNumber أولاً.

على سبيل المثال، في Java يكون هذا كالتالي:

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 أرقام) ورقم المشترك، بدون مسافات أو تنسيق إضافي، على سبيل المثال: - صحيح: " [phone]" - غير صحيح: " [phone] 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

ShortCode

كائن يمثل رمزًا قصيرًا، وهو رقم هاتف عادةً ما يكون أقصر بكثير من أرقام الهواتف العادية ويمكن استخدامه لتوجيه الرسائل في أنظمة رسائل الوسائط المتعددة وأنظمة الرسائل القصيرة SMS، بالإضافة إلى الاتصال المختصَر (مثل "إرسال رسالة نصية إلى 611 لمعرفة عدد الدقائق المتبقية في خطتك").

الرموز القصيرة مقصورة على منطقة معيّنة ولا يمكن الاتصال بها دوليًا، ما يعني أنّه يمكن إنشاء الرمز القصير نفسه في مناطق مختلفة وبأسعار وأسعار مختلفة، حتى إذا كانت هذه المناطق تتشارك رمز الاتصال نفسه الخاص بالبلد (الولايات المتحدة وكندا).

الحقول
region_code	string مطلوبة. رمز المنطقة BCP-47 للموقع الجغرافي الذي يمكن فيه إجراء الطلبات لهذا الرمز القصير، مثل US وBB. المراجع: http://www.unicode.org/reports/tr35/#unicode_region_subtag
number	string مطلوبة. أرقام الرمز القصير، بدون علامة زائد ("+") أو رمز اتصال للبلد، مثال "611"

PostalAddress

إذا كان عنوانًا بريديًا، على سبيل المثال، عنوان التسليم البريدي أو عناوين الدفع استنادًا إلى العنوان البريدي، يمكن لخدمة البريد تسليم السلع إلى مبنى أو صندوق بريد أو ما شابه ذلك. حيث لم يُقصد به تصميم نماذج للمواقع الجغرافية (الطرق والمدن والجبال).

في الاستخدام النموذجي، يتم إنشاء عنوان من خلال البيانات التي يُدخلها المستخدم أو من استيراد البيانات الحالية، وذلك حسب نوع العملية.

نصائح بشأن إدخال العنوان أو تعديله: - استخدام تطبيق مصغّر بعنوان جاهز للاستخدام مع مختلف البلدان، مثل https://github.com/google/libaddressinput). يجب عدم تقديم عناصر واجهة المستخدم إلى المستخدمين لإدخال أو تعديل الحقول خارج البلدان التي يُستخدَم فيها هذا الحقل.

لمزيد من الإرشادات حول كيفية استخدام هذا المخطط، يُرجى الاطّلاع على: 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 (إذا كان معروفًا) وهي غالبًا لغة واجهة المستخدم في نموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في البلد أو المنطقة حيث يقع العنوان، أو اللغات المكافئة لها التي تم تحويلها صوتيًا. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لتصحيح البيانات، ولن يؤثر أبدًا في أي عملية تحقّق أو عمليات أخرى غير متعلّقة بالتنسيق. وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة). أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en".
postal_code	string اختياريّ. الرمز البريدي للعنوان. لا تستخدِم بعض البلدان الرموز البريدية أو تشترط توفّر هذه الرموز، ولكن عند استخدامها، قد تُجري عمليات تحقُّق إضافية من خلال أجزاء أخرى من العنوان (مثل التحقّق من صحة الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية).
sorting_code	string اختياريّ. رمز ترتيب إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. وعند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة اختياريًا برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا) أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (مثل ساحل العاج).
administrative_area	string اختياريّ. أعلى تقسيم فرعي إداري يتم استخدامه للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. على وجه التحديد، بالنسبة إلى إسبانيا، هذه هي الإقليم وليس المجتمع المستقلّ (على سبيل المثال، "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. على سبيل المثال، في سويسرا، يجب ترك هذا الحقل بدون تعبئة.
locality	string اختياريّ. يشير بوجه عام إلى الجزء من المدينة أو البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، بلدة بريد المملكة المتحدة. في مناطق العالم التي لم يتم فيها تحديد المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم address_lines.
sublocality	string اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق.
address_lines[]	string أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان. بما أنّ القيم في address_lines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "أوستن، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب أسطر العنوان هو "طلب على شكل غلاف" للبلد أو المنطقة التي يقع فيها العنوان. وفي الأماكن التي قد يختلف فيها هذا الاسم (مثل اليابان)، يتم استخدام address_language لجعله صريحًا (على سبيل المثال، "ja" لترتيب الحروف الكبيرة إلى الصغيرة وja-Latn أو "en" للصغير إلى الكبير). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا للعنوان بناءً على اللغة. يتكون الحد الأدنى المسموح به للتمثيل الهيكلي للعنوان من رمز location_code مع وضع جميع المعلومات المتبقية في address_lines. سيكون من الممكن تنسيق هذا العنوان تقريبًا بدون ترميز جغرافي، ولكن لا يمكن وضع أي تفسير دلالي حول أي من مكونات العنوان حتى يتم حله جزئيًا على الأقل. إنشاء عنوان يحتوي فقط على رمز المنطقة وعنوان_lines، ثم يكون الترميز الجغرافي الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون لمناطق محلية أو إدارية).
recipients[]	string اختياريّ. المستلم على العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على معلومات "العناية".
organization	string اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان.

TimeOfDay

يمثل وقتًا من اليوم. إما أن التاريخ والمنطقة الزمنية ليست مهمة أو تم تحديدها في مكان آخر. قد تختار واجهة برمجة التطبيقات السماح بالثواني. الأنواع ذات الصلة هي google.type.Date وgoogle.protobuf.Timestamp.

الحقول
hours	int32 ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" في سيناريوهات مثل موعد إغلاق النشاط التجاري.
minutes	int32 دقائق من ساعات اليوم. يجب أن تتراوح القيمة بين 0 و59.
seconds	int32 ثواني الدقائق من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. وقد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة.
nanos	int32 الكسور من الثواني بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999.

TimeZone

تمثل هذه السمة منطقة زمنية من قاعدة بيانات المنطقة الزمنية IANA.

الحقول
id	string المنطقة الزمنية لقاعدة بيانات المنطقة الزمنية الصادرة عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثل "America/New_York".
version	string اختياريّ. رقم إصدار قاعدة بيانات المنطقة الزمنية الصادر عن IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثلاً "2019a".