Value

رسالة يمكن أن تحتوي على أي من أنواع القيم المسموح بها

تمثيل JSON
{

  // Union field value_type can be only one of the following:
  "nullValue": null,
  "booleanValue": boolean,
  "integerValue": string,
  "doubleValue": number,
  "timestampValue": string,
  "stringValue": string,
  "bytesValue": string,
  "referenceValue": string,
  "geoPointValue": {
    object (LatLng)
  },
  "arrayValue": {
    object (ArrayValue)
  },
  "mapValue": {
    object (MapValue)
  }
  // End of list of possible types for union field value_type.
}
الحقول
حقل الاتحاد value_type. يجب تحديد قيمة. يمكن أن يكون value_type واحدًا فقط مما يلي:
nullValue

null

قيمة فارغة.

booleanValue

boolean

قيمة منطقية.

integerValue

string (int64 format)

قيمة عدد صحيح.

doubleValue

number

قيمة مزدوجة.

timestampValue

string (Timestamp format)

قيمة طابع زمني.

الضبط بدقة تصل إلى ميكرو ثانية فقط. وعند تخزينها، يتم تقريب أي دقة إضافية إلى قيمة أقل.

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".

stringValue

string

قيمة سلسلة.

يجب ألا تتجاوز السلسلة، الممثلة بترميز UTF-8، بين 1 مبيبايت و89 بايت. تنظر طلبات البحث فقط في أول 1,500 بايت من تمثيل UTF-8.

bytesValue

string (bytes format)

قيمة بايت.

يجب ألا تتجاوز 1 مبيبايت إلى 89 بايت. تأخذ طلبات البحث أول 1,500 بايت فقط في الاعتبار.

سلسلة بترميز base64.

referenceValue

string

مرجع لمستند مثلاً: projects/{project_id}/databases/{databaseId}/documents/{document_path}

geoPointValue

object (LatLng)

يشير ذلك المصطلح إلى قيمة نقطة جغرافية تمثّل نقطة على سطح الأرض.

arrayValue

object (ArrayValue)

قيمة مصفوفة.

لا يمكن أن يحتوي على قيمة صفيف أخرى مباشرةً، ولكن يمكن أن يحتوي على خريطة تحتوي على صفيف آخر.

mapValue

object (MapValue)

قيمة الخريطة.

قيمة خريطة

قيمة الخريطة.

تمثيل JSON
{
  "fields": {
    string: {
      object (Value)
    },
    ...
  }
}
الحقول
fields

map (key: string, value: object (Value))

حقول الخريطة.

تمثل مفاتيح الخريطة أسماء الحقول. تم حجز أسماء الحقول التي تتطابق مع التعبير العادي __.*__. ويُحظر استخدام أسماء الحقول المحجوزة إلا في سياقات موثقة معينة. يجب ألا تتجاوز مفاتيح الخريطة، المُمثلة بترميز UTF-8، 1500 بايت ولا يمكن أن تكون فارغة.

عنصر يحتوي على قائمة بأزواج "key": value مثال: { "name": "wrench", "mass": "1.3kg", "count": "3" }