Method: projects.databases.documents.commit

वैकल्पिक तौर पर दस्तावेज़ों को अपडेट करते समय, लेन-देन करता है.

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

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

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

पाथ के पैरामीटर

पैरामीटर
database

string

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

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

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

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

object (Write)

लागू करने के लिए लेख.

इसे हमेशा एटॉमिक तरीके से और क्रम में लागू किया जाता है.
transaction

string (bytes format)

अगर यह नीति सेट है, तो इस ट्रांज़ैक्शन में शामिल सभी टेक्स्ट लागू करता है और इसे प्रोसेस कर देता है.

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

जवाब का मुख्य भाग

Firestore.Commit के लिए रिस्पॉन्स.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

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

object (WriteResult)

लेख लागू करने का नतीजा.

i-वां लिखने का यह नतीजा, अनुरोध में मौजूद i-th राइट के हिसाब से होता है.
commitTime

string (Timestamp format)

वह समय जब कार्रवाई हुई. readTime के बराबर या उससे ज़्यादा वैल्यू वाले टेक्स्ट को पढ़ने से, अनुबंध के असर की जानकारी मिलती है.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड का रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक हो सकते हैं. उदाहरण: "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

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