Method: projects.databases.documents.commit

दस्तावेज़ों को वैकल्पिक रूप से अद्यतन करते हुए, लेन-देन करता है।

HTTP अनुरोध

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

यूआरएल जीआरपीसी ट्रांसकोडिंग सिंटैक्स का उपयोग करता है।

पथ पैरामीटर

पैरामीटर
database

string

आवश्यक। डेटाबेस का नाम. प्रारूप में: projects/{projectId}/databases/{databaseId}

निकाय से अनुरोध करें

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

JSON प्रतिनिधित्व
{
  "writes": [
    {
      object (Write)
    }
  ],
  "transaction": string
}
खेत
writes[]

object ( Write )

आवेदन करने हेतु लिखता है।

हमेशा परमाणु रूप से और क्रम में निष्पादित किया जाता है।

transaction

string ( bytes format)

यदि सेट किया गया है, तो इस लेनदेन में सभी लेखन लागू करता है, और इसे प्रतिबद्ध करता है।

एक बेस64-एन्कोडेड स्ट्रिंग।

प्रतिक्रिया निकाय

Firestore.Commit के लिए प्रतिक्रिया।

सफल होने पर, प्रतिक्रिया निकाय में निम्नलिखित संरचना वाला डेटा शामिल होता है:

JSON प्रतिनिधित्व
{
  "writeResults": [
    {
      object (WriteResult)
    }
  ],
  "commitTime": string
}
खेत
writeResults[]

object ( WriteResult )

लेखन को लागू करने का परिणाम.

यह i-th लेखन परिणाम अनुरोध में i-th लेखन से मेल खाता है।

commitTime

string ( Timestamp format)

वह समय जिस पर प्रतिबद्धता घटित हुई. समान या अधिक readTime वाले किसी भी पाठ को प्रतिबद्धता के प्रभाव देखने की गारंटी है।

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

अधिक जानकारी के लिए, प्रमाणीकरण अवलोकन देखें।