Write

किसी दस्तावेज़ पर एक लेख.

JSON प्रतिनिधित्व
{
  "updateMask": {
    object (DocumentMask)
  },
  "updateTransforms": [
    {
      object (FieldTransform)
    }
  ],
  "currentDocument": {
    object (Precondition)
  },

  // Union field operation can be only one of the following:
  "update": {
    object (Document)
  },
  "delete": string,
  "transform": {
    object (DocumentTransform)
  }
  // End of list of possible types for union field operation.
}
खेत
updateMask

object ( DocumentMask )

इस लेखन में अद्यतन करने योग्य फ़ील्ड.

यह फ़ील्ड केवल तभी सेट की जा सकती है जब ऑपरेशन update हो। यदि मास्क update के लिए सेट नहीं है और दस्तावेज़ मौजूद है, तो कोई भी मौजूदा डेटा अधिलेखित कर दिया जाएगा। यदि मास्क सेट है और सर्वर पर दस्तावेज़ में मास्क द्वारा कवर नहीं किए गए फ़ील्ड हैं, तो उन्हें अपरिवर्तित छोड़ दिया जाता है। मास्क में संदर्भित फ़ील्ड, लेकिन इनपुट दस्तावेज़ में मौजूद नहीं हैं, सर्वर पर दस्तावेज़ से हटा दिए जाते हैं। इस मास्क में फ़ील्ड पथ में आरक्षित फ़ील्ड नाम नहीं होना चाहिए।

updateTransforms[]

object ( FieldTransform )

अद्यतन के बाद किए जाने वाले परिवर्तन।

यह फ़ील्ड केवल तभी सेट की जा सकती है जब ऑपरेशन update हो। यदि मौजूद है, तो यह लेखन परमाणु रूप से और क्रम में एक ही दस्तावेज़ में update और transform करने के बराबर है।

currentDocument

object ( Precondition )

दस्तावेज़ पर एक वैकल्पिक पूर्व शर्त.

यदि यह सेट है और लक्ष्य दस्तावेज़ द्वारा पूरा नहीं किया गया तो लेखन विफल हो जाएगा।

संघ क्षेत्र operation . निष्पादित करने के लिए ऑपरेशन. operation निम्नलिखित में से केवल एक ही हो सकता है:
update

object ( Document )

लिखने के लिए एक दस्तावेज़.

delete

string

हटाने के लिए दस्तावेज़ का नाम. प्रारूप में: projects/{projectId}/databases/{databaseId}/documents/{document_path}

transform

object ( DocumentTransform )

किसी दस्तावेज़ में परिवर्तन लागू करता है।

दस्तावेज़परिवर्तन

किसी दस्तावेज़ का रूपांतरण.

JSON प्रतिनिधित्व
{
  "document": string,
  "fieldTransforms": [
    {
      object (FieldTransform)
    }
  ]
}
खेत
document

string

रूपांतरित किए जाने वाले दस्तावेज़ का नाम.

fieldTransforms[]

object ( FieldTransform )

दस्तावेज़ के फ़ील्ड में क्रमानुसार लागू किए जाने वाले परिवर्तनों की सूची। यह खाली नहीं होना चाहिए.

फ़ील्डट्रांसफ़ॉर्म

दस्तावेज़ के किसी फ़ील्ड का रूपांतरण.

JSON प्रतिनिधित्व
{
  "fieldPath": string,

  // Union field transform_type can be only one of the following:
  "setToServerValue": enum (ServerValue),
  "increment": {
    object (Value)
  },
  "maximum": {
    object (Value)
  },
  "minimum": {
    object (Value)
  },
  "appendMissingElements": {
    object (ArrayValue)
  },
  "removeAllFromArray": {
    object (ArrayValue)
  }
  // End of list of possible types for union field transform_type.
}
खेत
fieldPath

string

मैदान का रास्ता. फ़ील्ड पथ सिंटैक्स संदर्भ के लिए Document.fields देखें।

यूनियन फ़ील्ड transform_type । क्षेत्र पर लागू करने के लिए परिवर्तन. transform_type निम्नलिखित में से केवल एक हो सकता है:
setToServerValue

enum ( ServerValue )

फ़ील्ड को दिए गए सर्वर मान पर सेट करता है।

increment

object ( Value )

दिए गए मान को फ़ील्ड के वर्तमान मान में जोड़ता है.

यह पूर्णांक या दोहरा मान होना चाहिए. यदि फ़ील्ड पूर्णांक या दोहरा नहीं है, या यदि फ़ील्ड अभी तक मौजूद नहीं है, तो परिवर्तन फ़ील्ड को दिए गए मान पर सेट कर देगा। यदि दिए गए मान या वर्तमान फ़ील्ड मान में से कोई भी दोगुना है, तो दोनों मानों को दोगुना माना जाएगा। दोहरा अंकगणित और दोहरे मानों का प्रतिनिधित्व IEEE 754 शब्दार्थ का अनुसरण करता है। यदि धनात्मक/नकारात्मक पूर्णांक अतिप्रवाह है, तो फ़ील्ड को सबसे बड़े परिमाण वाले धनात्मक/नकारात्मक पूर्णांक में हल किया जाता है।

maximum

object ( Value )

फ़ील्ड को उसके वर्तमान मान और दिए गए मान के अधिकतम पर सेट करता है।

यह पूर्णांक या दोहरा मान होना चाहिए. यदि फ़ील्ड पूर्णांक या दोहरा नहीं है, या यदि फ़ील्ड अभी तक मौजूद नहीं है, तो परिवर्तन फ़ील्ड को दिए गए मान पर सेट कर देगा। यदि एक अधिकतम ऑपरेशन लागू किया जाता है जहां फ़ील्ड और इनपुट मान मिश्रित प्रकार के होते हैं (अर्थात - एक पूर्णांक है और एक डबल है) तो फ़ील्ड बड़े ऑपरेंड का प्रकार ले लेता है। यदि ऑपरेंड समतुल्य हैं (जैसे 3 और 3.0), तो फ़ील्ड नहीं बदलती है। 0, 0.0, और -0.0 सभी शून्य हैं। शून्य संग्रहीत मान और शून्य इनपुट मान की अधिकतम सीमा हमेशा संग्रहीत मान होती है। किसी भी संख्यात्मक मान x और NaN का अधिकतम मान NaN है।

minimum

object ( Value )

फ़ील्ड को उसके वर्तमान मान और दिए गए मान के न्यूनतम पर सेट करता है।

यह पूर्णांक या दोहरा मान होना चाहिए. यदि फ़ील्ड पूर्णांक या डबल नहीं है, या यदि फ़ील्ड अभी तक मौजूद नहीं है, तो परिवर्तन फ़ील्ड को इनपुट मान पर सेट कर देगा। यदि न्यूनतम ऑपरेशन लागू किया जाता है जहां फ़ील्ड और इनपुट मान मिश्रित प्रकार के होते हैं (अर्थात - एक पूर्णांक है और एक डबल है) तो फ़ील्ड छोटे ऑपरेंड का प्रकार ले लेता है। यदि ऑपरेंड समतुल्य हैं (जैसे 3 और 3.0), तो फ़ील्ड नहीं बदलती है। 0, 0.0, और -0.0 सभी शून्य हैं। शून्य संग्रहीत मान और शून्य इनपुट मान का न्यूनतम हमेशा संग्रहीत मान होता है। किसी भी संख्यात्मक मान x और NaN का न्यूनतम NaN है।

appendMissingElements

object ( ArrayValue )

दिए गए तत्वों को क्रम में जोड़ें यदि वे वर्तमान फ़ील्ड मान में पहले से मौजूद नहीं हैं। यदि फ़ील्ड एक सरणी नहीं है, या यदि फ़ील्ड अभी तक मौजूद नहीं है, तो इसे पहले खाली सरणी पर सेट किया जाता है।

यदि कोई मान गुम है तो जाँच करते समय विभिन्न प्रकार की समतुल्य संख्याएँ (जैसे 3L और 3.0) समान मानी जाती हैं। NaN, NaN के बराबर है और Null, Null के बराबर है। यदि इनपुट में एकाधिक समकक्ष मान हैं, तो केवल पहले पर विचार किया जाएगा।

संबंधित परिवर्तन_परिणाम शून्य मान होगा।

removeAllFromArray

object ( ArrayValue )

फ़ील्ड में दिए गए सभी तत्वों को सरणी से हटा दें। यदि फ़ील्ड एक सरणी नहीं है, या यदि फ़ील्ड अभी तक मौजूद नहीं है, तो इसे खाली सरणी पर सेट किया जाता है।

किसी तत्व को हटाया जाना चाहिए या नहीं, यह तय करते समय विभिन्न प्रकारों (जैसे 3L और 3.0) की समतुल्य संख्याओं को समान माना जाता है। NaN, NaN के बराबर है और Null, Null के बराबर है। यदि डुप्लिकेट हैं तो यह सभी समतुल्य मानों को हटा देगा।

संबंधित परिवर्तन_परिणाम शून्य मान होगा।

सर्वरवैल्यू

एक मान जिसकी गणना सर्वर द्वारा की जाती है।

एनम्स
SERVER_VALUE_UNSPECIFIED अनिर्दिष्ट। इस मान का उपयोग नहीं किया जाना चाहिए.
REQUEST_TIME वह समय जब सर्वर ने अनुरोध को मिलीसेकंड परिशुद्धता के साथ संसाधित किया। यदि किसी लेन-देन में एकाधिक फ़ील्ड (समान या भिन्न दस्तावेज़) पर उपयोग किया जाता है, तो सभी फ़ील्ड को समान सर्वर टाइमस्टैम्प मिलेगा।