Method: projects.databases.documents.commit

إتمام معاملة وتعديل المستندات اختياريًا

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز 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)

نتيجة تطبيق عمليات الكتابة.

تتجاوب نتيجة الكتابة i هذه مع الكتابة i-th في الطلب.
commitTime

string (Timestamp format)

وقت حدوث الاشتراك. من خلال أيّ قراءة تتضمّن قيمة readTime مساوية أو أكبر، يتم ضمان ظهور تأثيرات عملية الالتزام.

طابع زمني بتنسيق RFC3339 UTC "Zulu" ، مع دقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.