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 هذه مع الكتابة 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
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على المصادقة.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-04-12 (حسب التوقيت العالمي المتفَّق عليه)
[{
"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":"غير ذلك"
}]