إرسال ملاحظات
Method: projects.databases.documents.commit
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
إتمام معاملة، مع تعديل المستندات اختياريًا
طلب HTTP
POST https://firestore.googleapis.com/v1/{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-th write هذه مع الكتابة 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
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة حول المصادقة .
إرسال ملاحظات
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0 . للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers . إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-07-15 (حسب التوقيت العالمي المتفَّق عليه)
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"لا يحتوي على المعلومات التي أحتاج إليها."
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"الخطوات معقدة للغاية / كثيرة جدًا."
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"المحتوى قديم."
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"ثمة مشكلة في الترجمة."
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"مشكلة في العيّنات / التعليمات البرمجية"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"غير ذلك"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"يسهُل فهم المحتوى."
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"ساعَدني المحتوى في حلّ مشكلتي."
},{
"type": "thumb-up",
"id": "otherUp",
"label":"غير ذلك"
}]
هل تريد مشاركة ملاحظاتك معنا؟