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)

फ़ील्ड की मौजूदा वैल्यू में, दी गई वैल्यू जोड़ता है.

यह एक पूर्णांक या डबल वैल्यू होनी चाहिए. अगर फ़ील्ड, कोई पूर्णांक या डबल नहीं है या फ़ील्ड मौजूद नहीं है, तो ट्रांसफ़ॉर्मेशन ऐक्शन फ़ील्ड को दी गई वैल्यू पर सेट कर देगा. अगर दी गई वैल्यू या मौजूदा फ़ील्ड की वैल्यू में से कोई एक है, तो दोनों वैल्यू को डबल माना जाएगा. डबल अंकगणित और दोहरी वैल्यू को दिखाने के लिए, आईईईई 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 के बराबर है और शून्य, शून्य के बराबर है. अगर इनपुट में एक से ज़्यादा एक जैसी वैल्यू हैं, तो सिर्फ़ सबसे पहले वाली वैल्यू पर विचार किया जाएगा.

इससे जुड़ा transform_result शून्य मान होगा.

removeAllFromArray

object (ArrayValue)

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

यह तय करते समय कि किसी एलिमेंट को हटाना है या नहीं, अलग-अलग टाइप (जैसे कि 3L और 3.0) की बराबर की संख्याओं को बराबर माना जाता है. NaN, NaN के बराबर है और शून्य, शून्य के बराबर है. ऐसा करने पर, डुप्लीकेट वैल्यू मिलने पर, मिलती-जुलती सभी वैल्यू हट जाएंगी.

इससे जुड़ा transform_result शून्य मान होगा.

सर्वर वैल्यू

वह वैल्यू जिसे सर्वर कैलकुलेट करता है.

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