الوصف
استخدام واجهة برمجة التطبيقات chrome.syncFileSystem
لحفظ البيانات ومزامنتها في Google Drive ولا تُستخدم واجهة برمجة التطبيقات هذه للوصول إلى مستندات المستخدم العشوائية المخزنة في Google Drive. وتوفر مساحة تخزين قابلة للمزامنة وخاصة بالتطبيق للاستخدام في وضع عدم الاتصال والتخزين المؤقت حتى تتوفّر البيانات نفسها عبر برامج مختلفة. يُرجى الاطّلاع على إدارة البيانات لمعرفة المزيد عن استخدام واجهة برمجة التطبيقات هذه.
الأذونات
syncFileSystem
الأنواع
ConflictResolutionPolicy
التعداد
"last_write_win"
FileInfo
أماكن إقامة
-
إجراء
SyncAction اختيارية
إجراء المزامنة الذي تم اتّخاذه لتنشيط حدث
onFileStatusChanged
وقد تكون قيمة الإجراء'added'
أو'updated'
أو'deleted'
. ينطبق ذلك فقط إذا كانت الحالة هي "'synced'
". -
direction
SyncDirection اختيارية
يمكنك مزامنة اتجاه حدث
onFileStatusChanged
. قد تكون قيمة اتجاه المزامنة'local_to_remote'
أو'remote_to_local'
. ينطبق ذلك فقط إذا كانت الحالة هي "'synced'
". -
fileEntry
تذكرة الدخول
fileEntry
للملف الهدف الذي تغيّرت حالته. يحتوي على معلومات اسم ومسار الملف الذي تمت مزامنته. عند حذف الملف، ستظل معلوماتfileEntry
متاحة لكن الملف لن يعود متاحًا. -
status
حالة الملف الناتجة بعد الحدث
onFileStatusChanged
قد تكون قيمة الحالة'synced'
أو'pending'
أو'conflicting'
.
FileStatus
التعداد
"synced"
غير متعارض ولا توجد تغييرات محلية في انتظار المراجعة
"pending"
تتضمّن تغييرًا أو أكثر من التغييرات المحلية المعلّقة التي لم تتم مزامنتها.
"conflicting"
يتعارض الملف مع الإصدار البعيد، ويجب حلّ المشكلة يدويًا.
FileStatusInfo
أماكن إقامة
-
خطأ
سلسلة اختيارية
يشير هذا المصطلح إلى خطأ اختياري يتم عرضه فقط إذا حدثت مشكلة في استرداد FileStatus للملف المحدَّد.
-
fileEntry
تذكرة الدخول
تم منح أحد الإدخالات في الأصل إلى getFileStatuses.
-
status
قد تكون قيمة الحالة
'synced'
أو'pending'
أو'conflicting'
.
ServiceInfo
أماكن إقامة
-
الوصف
سلسلة
-
state
ServiceStatus
التعداد
"initializing"
يتم حاليًا إعداد خدمة المزامنة (على سبيل المثال، استعادة البيانات من قاعدة البيانات، والتحقّق من الاتصال، والمصادقة مع الخدمة، وما إلى ذلك).
"running"
خدمة المزامنة قيد التشغيل.
"authentication_required"
لا تجري خدمة المزامنة مزامنة للملفات لأنه يجب أن يصادق المستخدم على الخدمة البعيدة للمتابعة.
"temporary_unavailable"
لا تجري خدمة المزامنة مزامنة للملفات لأنّ الخدمة البعيدة غير متاحة (مؤقتًا) بسبب بعض الأخطاء التي يمكن استردادها، مثلاً الشبكة غير متصلة بالإنترنت أو الخدمة البعيدة متوقّفة أو لا يمكن الوصول إليها وما إلى ذلك. يجب تقديم المزيد من التفاصيل من خلال المَعلمة description
في OnServiceInfoUpdate (التي قد تحتوي على تفاصيل خاصة بالخدمة).
"غير مفعَّل"
تم إيقاف خدمة المزامنة ولن تتم مزامنة المحتوى مطلقًا. (على سبيل المثال، قد يحدث هذا عندما لا يكون للمستخدم حساب على الخدمة البعيدة أو حدث خطأ لا يمكن استرداده في خدمة المزامنة.)
StorageInfo
أماكن إقامة
-
quotaBytes
الرقم
-
usageBytes
الرقم
SyncAction
التعداد
SyncDirection
التعداد
"local_to_remote"
"remote_to_local"
الطُرق
getConflictResolutionPolicy()
chrome.syncFileSystem.getConflictResolutionPolicy(
callback?: function,
)
الحصول على السياسة الحالية لحل النزاعات
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(policy: ConflictResolutionPolicy) => void
-
سياسة
-
المرتجعات
-
Promise<ConflictResolutionPolicy>
Chrome 117 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getFileStatus()
chrome.syncFileSystem.getFileStatus(
fileEntry: Entry,
callback?: function,
)
عرض FileStatus
لـ fileEntry
المحددة. قد تكون قيمة الحالة 'synced'
أو 'pending'
أو 'conflicting'
. تجدر الإشارة إلى أنّ حالة 'conflicting'
لا تحدث إلا عند ضبط سياسة حل التعارضات في الخدمة على 'manual'
.
المَعلمات
-
fileEntry
تذكرة الدخول
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(status: FileStatus) => void
-
status
-
المرتجعات
-
Promise<FileStatus>
Chrome 117 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getFileStatuses()
chrome.syncFileSystem.getFileStatuses(
fileEntries: object[],
callback?: function,
)
تعرض كل FileStatus
لمصفوفة fileEntry
المحددة. عادةً ما يتم استدعائها بالنتيجة من dirReader.readEntries().
المَعلمات
-
fileEntries
الكائن[]
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(status: FileStatusInfo[]) => void
-
status
-
المرتجعات
-
Promise<FileStatusInfo[]>
Chrome 117 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getServiceStatus()
chrome.syncFileSystem.getServiceStatus(
callback?: function,
)
عرض الحالة الحالية لخلفية المزامنة
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(status: ServiceStatus) => void
-
status
-
المرتجعات
-
Promise<ServiceStatus>
Chrome 117 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
getUsageAndQuota()
chrome.syncFileSystem.getUsageAndQuota(
fileSystem: DOMFileSystem,
callback?: function,
)
عرض الاستخدام الحالي والحصة بالبايت من مساحة تخزين ملفات 'syncable'
للتطبيق.
المَعلمات
-
fileSystem
DOMFileSystem
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(info: StorageInfo) => void
-
معلومات
-
المرتجعات
-
Promise<StorageInfo>
Chrome 117 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
requestFileSystem()
chrome.syncFileSystem.requestFileSystem(
callback?: function,
)
لعرض نظام ملفات قابل للمزامنة ومتوافق مع Google Drive. يمكن تشغيل مثيل DOMFileSystem
الذي تم عرضه بالطريقة نفسها التي يتم بها تشغيل أنظمة الملفات المؤقتة والدائمة (يمكنك الاطّلاع على http://dev.w3.org/2009/dap/file-system/file-dir-sys.html).
سيؤدي طلب هذا العنوان عدة مرات من التطبيق نفسه إلى إرجاع الاسم المعرِّف نفسه إلى نظام الملفات نفسه.
لاحظ أن هذه المكالمة قد تفشل. على سبيل المثال، إذا لم يسجّل المستخدم الدخول إلى Chrome أو إذا لم تكن هناك عملية تشغيل على الشبكة. لمعالجة هذه الأخطاء، من المهم تحديد chrome.runtime.lastError في معاودة الاتصال.
المَعلمات
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:(fileSystem: DOMFileSystem) => void
-
fileSystem
DOMFileSystem
-
المرتجعات
-
Promise<DOMFileSystem>
Chrome 117 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
setConflictResolutionPolicy()
chrome.syncFileSystem.setConflictResolutionPolicy(
policy: ConflictResolutionPolicy,
callback?: function,
)
تعمل هذه السياسة على ضبط السياسة التلقائية لحلّ التعارضات في مساحة تخزين ملفات 'syncable'
الخاصة بالتطبيق. ويتم ضبطها تلقائيًا على 'last_write_win'
. عند ضبط سياسة حل التعارض على 'last_write_win'
من التعارضات بشأن الملفات الحالية، يتم تلقائيًا حلّها في المرة القادمة التي يتم فيها تعديل الملف. يمكن استخدام السمة callback
بشكل اختياري لمعرفة ما إذا تم تنفيذ الطلب بنجاح أم لا.
المَعلمات
-
سياسة
-
معاودة الاتصال
الدالة اختيارية
تبدو معلَمة
callback
على النحو التالي:() => void
المرتجعات
-
Promise<void>
Chrome 117 والإصدارات الأحدثلا تتوفّر الوعود إلا في الإصدار 3 من Manifest V3 والإصدارات الأحدث، وتحتاج الأنظمة الأساسية الأخرى إلى استخدام عمليات معاودة الاتصال.
فعاليات
onFileStatusChanged
chrome.syncFileSystem.onFileStatusChanged.addListener(
callback: function,
)
يتم تنشيطها عند تعديل ملف من خلال خدمة المزامنة في الخلفية.
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(detail: FileInfo) => void
-
التفاصيل
-
onServiceStatusChanged
chrome.syncFileSystem.onServiceStatusChanged.addListener(
callback: function,
)
يتم تنشيطها عند حدوث خطأ أو تغيير آخر في الحالة في الواجهة الخلفية للمزامنة (على سبيل المثال، عندما تكون المزامنة غير مفعّلة مؤقتًا بسبب خطأ في الشبكة أو في المصادقة).
المَعلمات
-
معاودة الاتصال
الوظيفة
تبدو معلَمة
callback
على النحو التالي:(detail: ServiceInfo) => void
-
التفاصيل
-