ArrayValue

تمثّل هذه السمة قيمة مصفوفة.

تمثيل JSON
{
  "values": [
    {
      object (Value)
    }
  ]
}
الحقول
values[]

object (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 "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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 بايت. لا تضع طلبات البحث سوى أول 1500 بايت.

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

referenceValue

string

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

geoPointValue

object (LatLng)

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

arrayValue

object (ArrayValue)

تمثّل هذه السمة قيمة مصفوفة.

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

mapValue

object (MapValue)

قيمة خريطة

MapValue

قيمة خريطة

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

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

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

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

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