ब्यौरा
Google Drive पर डेटा सेव और सिंक करने के लिए, chrome.syncFileSystem
API का इस्तेमाल करें. यह एपीआई, Google Drive में सेव किए गए, उपयोगकर्ता के आर्बिट्रेरी दस्तावेज़ों को ऐक्सेस करने के लिए नहीं है. यह ऑफ़लाइन और कैश मेमोरी में इस्तेमाल के लिए, ऐप्लिकेशन के लिए खास तौर पर सिंक किया जा सकने वाला स्टोरेज उपलब्ध कराता है, ताकि अलग-अलग क्लाइंट पर एक ही डेटा उपलब्ध हो सके. इस एपीआई के इस्तेमाल के बारे में ज़्यादा जानकारी के लिए, डेटा मैनेज करें लेख पढ़ें.
अनुमतियां
syncFileSystem
टाइप
ConflictResolutionPolicy
Enum
"last_write_win"
FileInfo
प्रॉपर्टी
-
किसी खास रूटीन से जुड़ी कार्रवाई
SyncAction ज़रूरी नहीं
onFileStatusChanged
इवेंट ट्रिगर करने के लिए सिंक की गई कार्रवाई की गई. कार्रवाई की वैल्यू'added'
,'updated'
या'deleted'
हो सकती है. सिर्फ़ तब लागू होता है, जब स्थिति'synced'
हो. -
direction
SyncDirection ज़रूरी नहीं
onFileStatusChanged
इवेंट के लिए सिंक करने की दिशा. सिंक करने के निर्देश की वैल्यू'local_to_remote'
या'remote_to_local'
हो सकती है. सिर्फ़ तब लागू होता है, जब स्थिति'synced'
हो. -
fileEntry
प्रवेश
टारगेट फ़ाइल के लिए
fileEntry
, जिसकी स्थिति बदल गई है. इसमें सिंक की गई फ़ाइल का नाम और पाथ की जानकारी होती है. फ़ाइल मिटने पर भीfileEntry
की जानकारी उपलब्ध रहेगी, लेकिन फ़ाइल मौजूद नहीं रहेगी. -
स्थिति
onFileStatusChanged
इवेंट के बाद मिलने वाली फ़ाइल की स्थिति. स्थिति की वैल्यू'synced'
,'pending'
या'conflicting'
हो सकती है.
FileStatus
Enum
"सिंक किया गया"
विरोधी नहीं है और इसका कोई स्थानीय बदलाव बाकी नहीं है.
"pending"
इसमें एक या एक से ज़्यादा ऐसे स्थानीय बदलाव हैं जो सिंक नहीं हुए हैं.
"conflicting"
फ़ाइल, रिमोट वर्शन में नहीं है. इसलिए, इसे मैन्युअल तरीके से हल करना होगा.
FileStatusInfo
प्रॉपर्टी
-
गड़बड़ी
स्ट्रिंग ज़रूरी नहीं
वैकल्पिक गड़बड़ी, जो सिर्फ़ तब दिखाई जाती है, जब दी गई फ़ाइल के लिए FileStatus पाने में कोई समस्या हुई हो.
-
fileEntry
प्रवेश
getFileStatuses को मूल रूप से दिए गए एंट्री में से एक.
-
स्थिति
स्थिति की वैल्यू
'synced'
,'pending'
या'conflicting'
हो सकती है.
ServiceInfo
प्रॉपर्टी
-
ब्यौरा
स्ट्रिंग
-
state
ServiceStatus
Enum
"initializing"
सिंक सेवा शुरू की जा रही है. उदाहरण के लिए, डेटाबेस से डेटा वापस लाया जा रहा है, कनेक्टिविटी की जांच की जा रही है, और सेवा की पुष्टि की जा रही है वगैरह.
"running"
सिंक करने की सेवा चालू है.
"authentication_required"
सिंक करने की सेवा, फ़ाइलें सिंक नहीं कर रही है. ऐसा इसलिए, क्योंकि आगे बढ़ने के लिए रिमोट सेवा की पुष्टि करना ज़रूरी है.
"temporary_unavailable"
सिंक सेवा, फ़ाइलों को सिंक नहीं कर रही है.ऐसा इसलिए, क्योंकि रिकवरी की जा सकने वाली गड़बड़ियों की वजह से, रिमोट सेवा (कुछ समय के लिए) उपलब्ध नहीं है. जैसे, नेटवर्क ऑफ़लाइन है, रिमोट सेवा काम नहीं कर रही है या पहुंच से बाहर है वगैरह. ज़्यादा जानकारी के लिए, OnServiceInfoUpdated (इसमें सेवा से जुड़ी खास जानकारी शामिल हो सकती है) में description
पैरामीटर दें.
"बंद है"
सिंक करने की सेवा बंद है और कॉन्टेंट कभी भी सिंक नहीं होगा. उदाहरण के लिए, ऐसा तब हो सकता है, जब उपयोगकर्ता के पास रिमोट सेवा पर कोई खाता न हो या सिंक सेवा में कोई ऐसी गड़बड़ी हुई हो जिसे ठीक न किया जा सके.
StorageInfo
प्रॉपर्टी
-
quotaBytes
नंबर
-
usageBytes
नंबर
SyncAction
Enum
SyncDirection
Enum
"local_to_remote"
"remote_to_local"
तरीके
getConflictResolutionPolicy()
chrome.syncFileSystem.getConflictResolutionPolicy(
callback?: function,
)
विवाद सुलझाने की मौजूदा नीति की जानकारी मिलती है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(policy: ConflictResolutionPolicy) => void
-
policy
-
रिटर्न
-
Promise<ConflictResolutionPolicy>
Chrome 117 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
getFileStatus()
chrome.syncFileSystem.getFileStatus(
fileEntry: Entry,
callback?: function,
)
दिए गए fileEntry
के लिए FileStatus
दिखाता है. स्थिति की वैल्यू 'synced'
, 'pending'
या 'conflicting'
हो सकती है. ध्यान दें कि 'conflicting'
स्थिति सिर्फ़ तब होती है, जब सेवा से जुड़े विवाद सुलझाने की नीति 'manual'
पर सेट की गई हो.
पैरामीटर
-
fileEntry
प्रवेश
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(status: FileStatus) => void
-
स्थिति
-
रिटर्न
-
Promise<FileStatus>
Chrome 117 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
getFileStatuses()
chrome.syncFileSystem.getFileStatuses(
fileEntries: object[],
callback?: function,
)
दी गई fileEntry
कलेक्शन के लिए, हर FileStatus
दिखाता है. आम तौर पर, directReader.readEntries() के नतीजे के साथ कॉल किया जाता है.
पैरामीटर
-
fileEntries
ऑब्जेक्ट[]
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(status: FileStatusInfo[]) => void
-
स्थिति
-
रिटर्न
-
Promise<FileStatusInfo[]>
Chrome 117 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
getServiceStatus()
chrome.syncFileSystem.getServiceStatus(
callback?: function,
)
सिंक की मौजूदा बैकएंड स्थिति दिखाता है.
पैरामीटर
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(status: ServiceStatus) => void
-
स्थिति
-
रिटर्न
-
Promise<ServiceStatus>
Chrome 117 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
getUsageAndQuota()
chrome.syncFileSystem.getUsageAndQuota(
fileSystem: DOMFileSystem,
callback?: function,
)
ऐप्लिकेशन के 'syncable'
फ़ाइल स्टोरेज के लिए, मौजूदा इस्तेमाल और बाइट में कोटा दिखाता है.
पैरामीटर
-
fileSystem
DOMFileSystem
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:(info: StorageInfo) => void
-
जानकारी
-
रिटर्न
-
Promise<StorageInfo>
Chrome 117 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट 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 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
setConflictResolutionPolicy()
chrome.syncFileSystem.setConflictResolutionPolicy(
policy: ConflictResolutionPolicy,
callback?: function,
)
यह ऐप्लिकेशन के 'syncable'
फ़ाइल स्टोरेज के लिए, डिफ़ॉल्ट तौर पर तय किए गए विरोधाभास के समाधान की नीति सेट करता है. डिफ़ॉल्ट रूप से यह 'last_write_win'
पर सेट होती है. जब मौजूदा फ़ाइलों के लिए विवाद समाधान की नीति 'last_write_win'
पर सेट होती है, तो अगली बार फ़ाइल अपडेट होने पर, विवादों का समाधान अपने-आप हो जाता है. अनुरोध पूरा हुआ या नहीं, यह जानने के लिए callback
का विकल्प दिया जा सकता है.
पैरामीटर
-
policy
-
कॉलबैक
फ़ंक्शन ज़रूरी नहीं
callback
पैरामीटर ऐसा दिखता है:() => void
रिटर्न
-
Promise<void>
Chrome 117 और उसके बाद के वर्शनप्रॉमिस सिर्फ़ मेनिफ़ेस्ट V3 और उसके बाद के वर्शन पर काम करता है. अन्य प्लैटफ़ॉर्म के लिए कॉलबैक का इस्तेमाल करना ज़रूरी है.
इवेंट
onFileStatusChanged
chrome.syncFileSystem.onFileStatusChanged.addListener(
callback: function,
)
बैकग्राउंड सिंक सेवा से किसी फ़ाइल को अपडेट किए जाने पर सक्रिय होता है.
onServiceStatusChanged
chrome.syncFileSystem.onServiceStatusChanged.addListener(
callback: function,
)
सिंक बैकएंड में कोई गड़बड़ी या स्थिति में कोई अन्य बदलाव होने पर सक्रिय होता है (उदाहरण के लिए, जब नेटवर्क या पुष्टि करने की गड़बड़ी की वजह से सिंक कुछ समय के लिए बंद हो जाता है).
पैरामीटर
-
कॉलबैक
फ़ंक्शन
callback
पैरामीटर ऐसा दिखता है:(detail: ServiceInfo) => void
-
विवरण
-