ملخّص النوع والتنسيق
ويمكن استخدام السمتَين type وformat في المعلّمات والمخططات لتحديد نوع بيانات الموقع. تشير السمة type إلى نوع الموقع عند إرساله في طلبات واستجابات JSON (يتوافق JSON مع مجموعة صغيرة من أنواع البيانات، ويمكنك الاطّلاع على json.org لمعرفة التفاصيل). تقدّم السمة format معلومات إضافية عن النوع الأساسي. وستتضمّن المواقع دائمًا السمة type، ولكن قد يكون لبعض المواقع أيضًا السمة format.
على سبيل المثال، لا يمكن تمثيل عدد صحيح 64 بت في JSON (بما أن JavaScript وJSON يدعمان الأرقام الصحيحة التي تصل إلى 2^53). لذلك، يجب تمثيل عدد صحيح 64 بت كسلسلة في طلبات/استجابات JSON. لذلك سيتم ضبط السمة type على ""string" ولكن سيتم ضبط السمة format على "int64" للإشارة إلى أنّها عدد صحيح 64 بت.
تحدّد مواصفات مخطط JSON مجموعة من القيم الشائعة للسمة format. وتتوافق "خدمة Google APIs أثناء التصفّح" مع بعض هذه القيم، وتحدّد القيم الأخرى أيضًا. في ما يلي قائمة كاملة بقيم type وformat المتوافقة مع "خدمة Google APIs أثناء التصفّح".
| قيمة النوع | قيمة التنسيق | المعنى |
|---|---|---|
any |
|
قد يكون للموقع أي نوع. يتم تحديدها بواسطة مواصفات مخطط JSON. |
array |
|
مصفوفة JavaScript من القيم. تشير السمة items إلى المخطط لقيم المصفوفة. يتم تحديده من خلال مواصفات مخطط JSON. |
boolean |
|
قيمة منطقية، إما "true" أو "false". يتم تحديده من خلال مواصفات مخطط JSON. |
integer |
int32 |
عدد صحيح موقَّع 32 بت. وتحتوي على حد أدنى للقيمة وهو -2,147,483,648 وحد أقصى للقيمة يبلغ 2,147,483,647 (شاملة). |
integer |
uint32 |
عدد صحيح 32 بت غير موقَّع. وتحتوي على حد أدنى للقيمة يبلغ 0 والحد الأقصى للقيمة هو 4,294,967,295 (شاملة). |
number |
double |
نقطة عائمة بدقة 64 بت في IEEE 754. |
number |
float |
نقطة عائمة بدقة 32 بت لمعيار IEEE 754. |
object |
|
عنصر JavaScript. يتم تحديده من خلال مواصفات مخطط JSON. |
string |
|
سلسلة عشوائية. يتم تحديده من خلال مواصفات مخطط JSON. |
string |
byte |
سلسلة من وحدات البايت المضغوطة والمُشفّرة باستخدام الترميز 64، والتي تم ترميزها باستخدام عنوان URL وأمان أحرف أبجدية آمنة لاسم الملف الشخصي (يُشار إليها أحيانًا باسم "web-safe" أو "base64url"). يتم تحديدها من خلال RFC4648. |
string |
date |
تاريخ RFC3339 بالتنسيق YYYY-MM-DD. تم تحديدها في مواصفات مخطط JSON. |
string |
date-time |
الطابع الزمني RFC3339 بالتوقيت العالمي المُنسّق (UTC). وتكون بالصيغة التالية: yyyy-MM-ddTHH:mm:ss.SSSZ. الجزء بالملي ثانية ("SSS") اختياري. تم تحديدها في مواصفات مخطط JSON. |
string |
google-datetime |
الطابع الزمني RFC3339 بالتوقيت العالمي المُنسّق (UTC). وتكون بالصيغة التالية: yyyy-MM-ddTHH:mm:ss.SSSZ. الجزء بالملي ثانية ("SSS") اختياري. |
string |
google-duration |
تنتهي السلسلة في اللاحقة "&;;;;; (تشير إلى ثوانٍ) ويسبقها عدد الثواني، مع التعبير نانو ثوانٍ ككسور بالثواني. يتم دائمًا استخدام النقطة كعلامة عشرية، وليست فاصلة. |
string |
google-fieldmask |
سلسلة يتم فيها فصل أسماء الحقول بفاصلة. يتم تمثيل أسماء الحقول باصطلاحات تسمية الجمل المنخفضة. |
string |
int64 |
عدد صحيح موقَّع 64 بت. وتتضمن هذه السياسة حدًا أدنى للقيمة يبلغ -9,223,372,036,854,775,808 والحد الأقصى للقيمة هو 9,223,372,036,854,775,807 (شاملة). |
string |
uint64 |
عدد صحيح 64 بت بدون توقيع. وتحتوي على الحد الأدنى للقيمة وهي 0 (2^64)-1 (شاملة). |