Method: projects.databases.documents.commit

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

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

POST https://firestore.googleapis.com/v1/{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

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