إتمام معاملة، مع تعديل المستندات اختياريًا
طلب HTTP
POST https://firestore.googleapis.com/v1beta1/{database=projects/*/databases/*}/documents:commit
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
database |
يجب ملء الحقل. اسم قاعدة البيانات. بالتنسيق: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"writes": [
{
object ( |
الحقول | |
---|---|
writes[] |
العبارات التي سيتم تطبيقها. يتم تنفيذها دائمًا بشكل كامل وبالترتيب. |
transaction |
في حال ضبط هذه السياسة، يتم تطبيق جميع عمليات الشراء في هذه المعاملة والالتزام بها. سلسلة بترميز base64. |
نص الاستجابة
تمثّل هذه السمة الردّ على Firestore.Commit
.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"writeResults": [
{
object ( |
الحقول | |
---|---|
writeResults[] |
هي نتيجة تطبيق عمليات الكتابة. تتوافق نتيجة i-th write هذه مع الكتابة i-th في الطلب. |
commitTime |
وقت حدوث الالتزام. يمكن ضمان ظهور تأثيرات إتمام عملية الشراء عند قراءة قيمة مساوية لقيمة طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: |
نطاقات الأذونات
يتطلب هذا الإعداد أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/datastore
https://www.googleapis.com/auth/cloud-platform
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة.