ملخّص النوع والتنسيق

ويمكن استخدام السمتَين 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 أثناء التصفّح".

ملاحظة: تستخدم مكتبات العملاء التي ننشئها تلقائيًا من مستند اكتشاف واجهة برمجة التطبيقات (API) في بعض الأحيان أنواعًا لغويات لهذه الأنواع والتنسيقات. على سبيل المثال: يتم تمثيل العدد الصحيح 64 بت كنوع string في طلبات واستجابات JSON، ولكن تستخدم مكتبة برامج Java التي تم إنشاؤها النوع long.

قيمة النوع	قيمة التنسيق	المعنى
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 (شاملة).