Method: projects.databases.documents.commit

दस्तावेज़ों को अपडेट करते समय, ट्रांज़ैक्शन की प्रोसेस पूरी करता है.

एचटीटीपी अनुरोध

POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:commit

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

पाथ पैरामीटर

पैरामीटर
database

string

ज़रूरी है. डेटाबेस का नाम. फ़ॉर्मैट: projects/{projectId}/databases/{databaseId}.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य हिस्से में, यहां दिए गए स्ट्रक्चर का डेटा शामिल होता है:

JSON के काेड में दिखाना 
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
फ़ील्ड
writes[]

object (Write)

लागू की जाने वाली जानकारी.

हमेशा अपने-आप और क्रम से लगाए जाते हैं.
transaction

string (bytes format)

अगर यह नीति सेट है, तो इस लेन-देन के सभी राइट को लागू करता है और इसे शेयर करता है.

base64 कोड में बदली गई स्ट्रिंग.

जवाब का लेख

Firestore.Commit का जवाब.

अगर इंडेक्सिंग सही से हाे जाती है, ताे जवाब के लेख में नीचे दिए गए स्ट्रक्चर का डेटा शामिल होता है.

JSON के काेड में दिखाना 
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
फ़ील्ड
writeResults[]

object (WriteResult)

लिखे गए शब्दों को लागू करने का नतीजा.

लिखने का यह नतीजा, अनुरोध में किए गए लिखने के नतीजे से मेल खाता है.
commitTime

string (Timestamp format)

गतिविधि तय करने का समय. readTime के बराबर या उससे ज़्यादा वैल्यू वाला टेक्स्ट पढ़ने पर, गारंटी के साथ कॉन्टेंट का असर दिखेगा.

आरएफ़सी3339 यूटीसी के "ज़ुलू" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंक हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

अनुमति के दायरे

इनमें से किसी एक OAuth स्कोप की ज़रूरत होती है:

  • https://www.googleapis.com/auth/datastore
  • https://www.googleapis.com/auth/cloud-platform

ज़्यादा जानकारी के लिए, पुष्टि करने से जुड़ी खास जानकारी देखें.