الفهرس
Date
(رسالة)DayOfWeek
(تعداد)Interval
(رسالة)PhoneNumber
(رسالة)PhoneNumber.ShortCode
(رسالة)PostalAddress
(رسالة)TimeOfDay
(رسالة)TimeZone
(رسالة)
التاريخ
يمثل تاريخ تقويم كاملاً أو جزئيًا، مثل عيد الميلاد. تم تحديد الوقت من اليوم والمنطقة الزمنية في مكان آخر أو غير مهمين. يرتبط التاريخ بالتقويم الميلادي. يمكن أن يمثل ذلك أيًا مما يلي:
- تاريخ كامل، بقيم غير صفرية للسنة والشهر واليوم.
- شهر ويوم، بسنة صفرية (على سبيل المثال، ذكرى سنوية).
- سنة بمفردها، بشهر صفري ويوم صفري.
- سنة وشهر بيوم صفري (على سبيل المثال، تاريخ انتهاء صلاحية بطاقة الائتمان).
الأنواع ذات الصلة:
google.type.TimeOfDay
google.type.DateTime
google.protobuf.Timestamp
الحقول | |
---|---|
year |
السنة من التاريخ. يجب أن تتراوح القيمة من 1 إلى 9999، أو 0 لتحديد تاريخ بدون سنة. |
month |
شهر من السنة. يجب أن تتراوح القيمة من 1 إلى 12، أو 0 لتحديد سنة بدون شهر ويوم. |
day |
يوم من الشهر. يجب أن تتراوح القيمة من 1 إلى 31 وأن تكون صالحة للسنة والشهر، أو 0 لتحديد عام في حد ذاته أو تحديد سنة وشهر عندما لا يكون اليوم مهمًا. |
DayOfWeek
يمثل يومًا من الأسبوع.
عمليات التعداد | |
---|---|
DAY_OF_WEEK_UNSPECIFIED |
لم يتم تحديد اليوم من الأسبوع. |
MONDAY |
الاثنين |
TUESDAY |
الثلاثاء |
WEDNESDAY |
الأربعاء |
THURSDAY |
الخميس |
FRIDAY |
الجمعة |
SATURDAY |
السبت |
SUNDAY |
الأحد |
الفاصل الزمني
ويمثل فاصلاً زمنيًا مشفّرًا كبداية طابع زمني (شامل) ونهاية طابع زمني (غير شاملة).
يجب أن تكون البداية أقل من أو تساوي النهاية. عندما تساوي البداية النهاية، يكون الفاصل الزمني فارغًا (لا يتطابق أي وقت). عندما تكون البداية والنهاية غير محددة، يتطابق الفاصل الزمني في أي وقت.
الحقول | |
---|---|
start_time |
اختياريّ. بداية شاملة للفاصل الزمني. يجب أن يكون الطابع الزمني الذي يطابق هذا الفاصل الزمني هو نفسه أو بعد بدئه في حال تحديده. |
end_time |
اختياريّ. نهاية حصرية للفاصل الزمني. ويجب أن يقع الطابع الزمني الذي يتطابق مع هذا الفاصل الزمني قبل النهاية، في حال تحديده. |
PhoneNumber
كائن يمثّل رقم هاتف ومناسب لتنسيق سلك واجهة برمجة التطبيقات
هذا التمثيل:
يجب عدم استخدامه لتنسيق رقم الهاتف الخاص بالمنطقة، مثلاً " +1 (650) 253-0000 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 |
امتداد رقم الهاتف. لم يتم توحيد الامتداد في اقتراحات الاتحاد الدولي للاتصالات، باستثناء ما يتم تعريفه كسلسلة من الأرقام التي يصل طولها إلى 40 رقمًا كحد أقصى. ما عدا الأرقام، قد يتم تخزين بعض رموز الاتصال الأخرى، مثل ',' (التي تشير إلى الانتظار) أو "#" هنا. تجدر الإشارة إلى أنّه ما مِن مناطق تستخدم حاليًا إضافات ذات رموز قصيرة، لذلك يتم ضبط هذا الحقل عادةً بالاقتران مع رقم E.164 فقط. ويتم الاحتفاظ بها بشكل منفصل عن رقم E.164 للسماح بامتدادات الرموز القصيرة في المستقبل. |
حقل الاتحاد kind . مطلوبة. تكون إما رقمًا عاديًا أو رمزًا قصيرًا. يمكن إضافة حقول جديدة إلى الحقل التالي في المستقبل، لذلك يجب على العملاء تجاهل أرقام الهواتف التي لم يتم تعيين أي من الحقول التي تم الترميز وفقًا لها. يمكن أن يكون kind واحدًا فقط مما يلي: |
|
e164_number |
رقم الهاتف الممثَّل بعلامة زائد بادئة ("+")، متبوعًا برقم هاتف يستخدم تنسيق 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
كائن يمثل رمزًا قصيرًا، وهو رقم هاتف عادةً ما يكون أقصر بكثير من أرقام الهواتف العادية ويمكن استخدامه لتوجيه الرسائل في أنظمة رسائل الوسائط المتعددة وأنظمة الرسائل القصيرة SMS، بالإضافة إلى الاتصال المختصَر (مثل "إرسال رسالة نصية إلى 611 لمعرفة عدد الدقائق المتبقية في خطتك").
الرموز القصيرة مقصورة على منطقة معيّنة ولا يمكن الاتصال بها دوليًا، ما يعني أنّه يمكن إنشاء الرمز القصير نفسه في مناطق مختلفة وبأسعار وأسعار مختلفة، حتى إذا كانت هذه المناطق تتشارك رمز الاتصال نفسه الخاص بالبلد (الولايات المتحدة وكندا).
الحقول | |
---|---|
region_code |
مطلوبة. رمز المنطقة BCP-47 للموقع الجغرافي الذي يمكن فيه إجراء الطلبات لهذا الرمز القصير، مثل US وBB. المراجع: http://www.unicode.org/reports/tr35/#unicode_region_subtag |
number |
مطلوبة. أرقام الرمز القصير، بدون علامة زائد ("+") أو رمز اتصال للبلد، مثال "611" |
PostalAddress
إذا كان عنوانًا بريديًا، على سبيل المثال، عنوان التسليم البريدي أو عناوين الدفع استنادًا إلى العنوان البريدي، يمكن لخدمة البريد تسليم السلع إلى مبنى أو صندوق بريد أو ما شابه ذلك. حيث لم يُقصد به تصميم نماذج للمواقع الجغرافية (الطرق والمدن والجبال).
في الاستخدام النموذجي، يتم إنشاء عنوان من خلال البيانات التي يُدخلها المستخدم أو من استيراد البيانات الحالية، وذلك حسب نوع العملية.
نصائح بشأن إدخال العنوان أو تعديله: - استخدام تطبيق مصغّر بعنوان جاهز للاستخدام مع مختلف البلدان، مثل https://github.com/google/libaddressinput). يجب عدم تقديم عناصر واجهة المستخدم إلى المستخدمين لإدخال أو تعديل الحقول خارج البلدان التي يُستخدَم فيها هذا الحقل.
لمزيد من الإرشادات حول كيفية استخدام هذا المخطط، يُرجى الاطّلاع على: https://support.google.com/business/answer/6397478
الحقول | |
---|---|
revision |
تمثّل هذه السمة مراجعة المخطط لـ يجب أن تكون جميع النُسخ السابقة متوافقة مع الإصدارات القديمة. |
region_code |
مطلوبة. رمز CLDR للبلد أو المنطقة التي يقع فيها العنوان. لا يتم استنتاج ذلك أبدًا، وتقع على عاتق المستخدم مسؤولية التأكّد من صحة القيمة. يمكنك الانتقال إلى https://cldr.unicode.org/ وhttps://www.unicode.org/cldr/charts/30/supplemental/territory_information.html لمعرفة التفاصيل. مثال: "CH" بالنسبة إلى الإمارات. |
language_code |
اختياريّ. رمز لغة محتوى هذا العنوان BCP-47 (إذا كان معروفًا) وهي غالبًا لغة واجهة المستخدم في نموذج الإدخال أو من المتوقّع أن تتطابق مع إحدى اللغات المستخدَمة في البلد أو المنطقة حيث يقع العنوان، أو اللغات المكافئة لها التي تم تحويلها صوتيًا. ويمكن أن يؤثر ذلك في التنسيق في بلدان معيّنة، ولكنه ليس ضروريًا لتصحيح البيانات، ولن يؤثر أبدًا في أي عملية تحقّق أو عمليات أخرى غير متعلّقة بالتنسيق. وإذا كانت هذه القيمة غير معروفة، يجب حذفها (بدلاً من تحديد قيمة تلقائية قد تكون غير صحيحة). أمثلة: "zh-Hant" و"ja" و"ja-Latn" و"en". |
postal_code |
اختياريّ. الرمز البريدي للعنوان. لا تستخدِم بعض البلدان الرموز البريدية أو تشترط توفّر هذه الرموز، ولكن عند استخدامها، قد تُجري عمليات تحقُّق إضافية من خلال أجزاء أخرى من العنوان (مثل التحقّق من صحة الولاية أو الرمز البريدي في الولايات المتحدة الأمريكية). |
sorting_code |
اختياريّ. رمز ترتيب إضافي خاص بالبلد. لا تُستخدم هذه الميزة في معظم المناطق. وعند استخدامها، تكون القيمة إما سلسلة مثل "CEDEX"، متبوعة اختياريًا برقم (مثل "CEDEX 7")، أو مجرد رقم وحده، يمثّل "رمز القطاع" (جامايكا) أو "مؤشر منطقة التسليم" (مالاوي) أو "مؤشر مكتب البريد" (مثل ساحل العاج). |
administrative_area |
اختياريّ. أعلى تقسيم فرعي إداري يتم استخدامه للعناوين البريدية لبلد أو منطقة. على سبيل المثال، يمكن أن تكون ولاية أو مقاطعة أو مقاطعة أو محافظة. على وجه التحديد، بالنسبة إلى إسبانيا، هذه هي الإقليم وليس المجتمع المستقلّ (على سبيل المثال، "برشلونة" وليس "كاتالونيا"). لا يستخدم العديد من البلدان منطقة إدارية في العناوين البريدية. على سبيل المثال، في سويسرا، يجب ترك هذا الحقل بدون تعبئة. |
locality |
اختياريّ. يشير بوجه عام إلى الجزء من المدينة أو البلدة من العنوان. أمثلة: مدينة في الولايات المتحدة، بلدية تكنولوجيا المعلومات، بلدة بريد المملكة المتحدة. في مناطق العالم التي لم يتم فيها تحديد المناطق المحلية بشكل جيد أو لا تتناسب مع هذا الهيكل جيدًا، اترك المنطقة المحلية فارغة واستخدم address_lines. |
sublocality |
اختياريّ. المنطقة المحلية الفرعية للعنوان. على سبيل المثال، يمكن أن تكون الأحياء أو المناطق الإدارية أو المناطق. |
address_lines[] |
أسطر عنوان غير منظمة تصف المستويات الأدنى من العنوان. بما أنّ القيم في address_lines لا تحتوي على معلومات النوع وقد تحتوي أحيانًا على قيم متعددة في حقل واحد (على سبيل المثال، "أوستن، تكساس")، من المهم أن يكون ترتيب الأسطر واضحًا. يجب أن يكون ترتيب أسطر العنوان هو "طلب على شكل غلاف" للبلد أو المنطقة التي يقع فيها العنوان. وفي الأماكن التي قد يختلف فيها هذا الاسم (مثل اليابان)، يتم استخدام address_language لجعله صريحًا (على سبيل المثال، "ja" لترتيب الحروف الكبيرة إلى الصغيرة وja-Latn أو "en" للصغير إلى الكبير). وبهذه الطريقة، يمكن تحديد السطر الأكثر تحديدًا للعنوان بناءً على اللغة. يتكون الحد الأدنى المسموح به للتمثيل الهيكلي للعنوان من رمز location_code مع وضع جميع المعلومات المتبقية في address_lines. سيكون من الممكن تنسيق هذا العنوان تقريبًا بدون ترميز جغرافي، ولكن لا يمكن وضع أي تفسير دلالي حول أي من مكونات العنوان حتى يتم حله جزئيًا على الأقل. إنشاء عنوان يحتوي فقط على رمز المنطقة وعنوان_lines، ثم يكون الترميز الجغرافي الطريقة الموصى بها للتعامل مع العناوين غير المنظَّمة تمامًا (بدلاً من تخمين أجزاء العنوان التي يجب أن تكون لمناطق محلية أو إدارية). |
recipients[] |
اختياريّ. المستلم على العنوان. في حالات معيّنة، قد يحتوي هذا الحقل على معلومات متعددة الأسطر. على سبيل المثال، قد يحتوي على معلومات "العناية". |
organization |
اختياريّ. تمثّل هذه السمة اسم المؤسسة في العنوان. |
TimeOfDay
يمثل وقتًا من اليوم. إما أن التاريخ والمنطقة الزمنية ليست مهمة أو تم تحديدها في مكان آخر. قد تختار واجهة برمجة التطبيقات السماح بالثواني. الأنواع ذات الصلة هي google.type.Date
وgoogle.protobuf.Timestamp
.
الحقول | |
---|---|
hours |
ساعات اليوم بتنسيق 24 ساعة. يجب أن تتراوح القيمة بين 0 و23. قد تختار واجهة برمجة التطبيقات السماح بالقيمة "24:00:00" في سيناريوهات مثل موعد إغلاق النشاط التجاري. |
minutes |
دقائق من ساعات اليوم. يجب أن تتراوح القيمة بين 0 و59. |
seconds |
ثواني الدقائق من الوقت. يجب أن تتراوح القيمة عادةً بين 0 و59. وقد تسمح واجهة برمجة التطبيقات بالقيمة 60 إذا كانت تسمح بالثواني الكبيسة. |
nanos |
الكسور من الثواني بالنانو ثانية. يجب أن تتراوح القيمة بين 0 و999,999,999. |
TimeZone
تمثل هذه السمة منطقة زمنية من قاعدة بيانات المنطقة الزمنية IANA.
الحقول | |
---|---|
id |
المنطقة الزمنية لقاعدة بيانات المنطقة الزمنية الصادرة عن منظمة IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثل "America/New_York". |
version |
اختياريّ. رقم إصدار قاعدة بيانات المنطقة الزمنية الصادر عن IANA (المنظمة المعنية بأرقام الإنترنت المخصصة)، مثلاً "2019a". |