Açıklama
Verileri Google Drive'a kaydetmek ve senkronize etmek için chrome.syncFileSystem
API'yi kullanın. Bu API, Google Drive'da depolanan rastgele kullanıcı dokümanlarına erişmek için DEĞİLDİR. Çevrimdışı ve önbelleğe alma kullanımı için uygulamaya özel senkronize edilebilir bir depolama alanı sağlar. Böylece aynı veriler farklı istemcilerde kullanılabilir. Bu API'yi kullanma hakkında daha fazla bilgi için Verileri Yönetme bölümünü okuyun.
İzinler
syncFileSystem
Türler
ConflictResolutionPolicy
Enum
"last_write_win"
"manual"
FileInfo
Özellikler
-
işlem
SyncAction isteğe bağlı
onFileStatusChanged
etkinliğini tetiklemek için senkronizasyon işlemi yapıldı. İşlem değeri'added'
,'updated'
veya'deleted'
olabilir. Yalnızca durum'synced'
ise geçerlidir. -
direction
SyncDirection isteğe bağlı
onFileStatusChanged
etkinliğinin yönünü senkronize edin. Senkronizasyon yön değeri'local_to_remote'
veya'remote_to_local'
olabilir. Yalnızca durum'synced'
ise geçerlidir. -
fileEntry
Giriş
Durumu değişen hedef dosya için
fileEntry
. Senkronize edilen dosyanın adını ve yol bilgilerini içerir. Dosya silindiğinde,fileEntry
bilgileri kullanılabilir olmaya devam eder ancak dosya artık mevcut olmaz. -
status
onFileStatusChanged
etkinliğinden sonra elde edilen dosya durumu. Durum değeri'synced'
,'pending'
veya'conflicting'
olabilir.
FileStatus
Enum
"synced"
Çakışan değil ve bekleyen yerel değişiklik yok.
"pending"
Senkronize edilmemiş bir veya daha fazla bekleyen yerel değişiklik içeriyor.
"conflicting"
Dosya, uzak sürümle çakışıyor ve manuel olarak çözülmesi gerekiyor.
FileStatusInfo
Özellikler
-
hata
string isteğe bağlı
Yalnızca ilgili dosyanın FileStatus bilgisi alınırken bir sorun oluştuğunda döndürülen isteğe bağlı hata.
-
fileEntry
Giriş
Girişlerden biri başlangıçta getFileStatuses için verilir.
-
status
Durum değeri
'synced'
,'pending'
veya'conflicting'
olabilir.
ServiceInfo
Özellikler
-
açıklama
dize
-
state
ServiceStatus
Enum
"initializing"
Senkronizasyon hizmeti başlatılıyor (ör. veritabanından verileri geri yükleme, bağlantıyı kontrol etme ve hizmette kimlik doğrulama).
"running"
Senkronizasyon hizmeti çalışır durumda.
"authentication_required"
Uzak hizmetin devam edebilmesi için kullanıcının kimliğinin doğrulanması gerektiğinden senkronizasyon hizmeti dosyaları senkronize etmiyor.
"temporary_unavailable"
Uzak hizmet bazı kurtarılabilir hatalar (ör. ağ çevrimdışı, uzak hizmet kapalı veya erişilemez) nedeniyle (geçici olarak) kullanılamadığından senkronizasyon hizmeti dosyaları senkronize etmiyor. OnServiceInfoUpdated parametresinde description
parametresi tarafından (hizmete özgü ayrıntılar yer alabilir) daha fazla ayrıntı verilmesi gerekir.
"disabled"
Senkronizasyon hizmeti devre dışı ve içerik hiçbir zaman senkronize edilmeyecek. (Örneğin, kullanıcının uzak hizmette hesabı olmadığında veya senkronizasyon hizmetinde kurtarılamayan bir hata oluştuğunda bu durumla karşılaşılabilir.)
StorageInfo
Özellikler
-
quotaBytes
sayı
-
usageBytes
sayı
SyncAction
Enum
"eklendi"
"delete" (silindi)
SyncDirection
Enum
"local_to_remote"
"remote_to_local"
Yöntemler
getConflictResolutionPolicy()
chrome.syncFileSystem.getConflictResolutionPolicy(
callback?: function,
)
Geçerli anlaşmazlık çözümü politikasını alır.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(policy: ConflictResolutionPolicy) => void
-
policy
-
İlerlemeler
-
Promise<ConflictResolutionPolicy>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getFileStatus()
chrome.syncFileSystem.getFileStatus(
fileEntry: Entry,
callback?: function,
)
Verilen fileEntry
için FileStatus
değerini döndürür. Durum değeri 'synced'
, 'pending'
veya 'conflicting'
olabilir. 'conflicting'
durumunun yalnızca hizmetin çakışma çözümü politikası 'manual'
olarak ayarlanması durumunda gerçekleştiğini unutmayın.
Parametreler
-
fileEntry
Giriş
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(status: FileStatus) => void
-
status
-
İlerlemeler
-
Promise<FileStatus>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getFileStatuses()
chrome.syncFileSystem.getFileStatuses(
fileEntries: object[],
callback?: function,
)
Belirli fileEntry
dizisi için her bir FileStatus
değerini döndürür. Genellikle dirReader.readEntries() işlevinden alınan sonuçla çağrılır.
Parametreler
-
fileEntries
nesne[]
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(status: FileStatusInfo[]) => void
-
status
-
İlerlemeler
-
Promise<FileStatusInfo[]>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getServiceStatus()
chrome.syncFileSystem.getServiceStatus(
callback?: function,
)
Geçerli senkronizasyon arka uç durumunu döndürür.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(status: ServiceStatus) => void
-
status
-
İlerlemeler
-
Promise<ServiceStatus>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
getUsageAndQuota()
chrome.syncFileSystem.getUsageAndQuota(
fileSystem: DOMFileSystem,
callback?: function,
)
Uygulamanın 'syncable'
dosya depolama alanına ilişkin geçerli kullanımı ve kotayı bayt cinsinden döndürür.
Parametreler
-
fileSystem
DOMFileSystem
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(info: StorageInfo) => void
-
bilgi
-
İlerlemeler
-
Promise<StorageInfo>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
requestFileSystem()
chrome.syncFileSystem.requestFileSystem(
callback?: function,
)
Google Drive tarafından desteklenen senkronize edilebilir bir dosya sistemi döndürür. Döndürülen DOMFileSystem
örneği, Geçici ve Kalıcı dosya sistemleriyle aynı şekilde çalıştırılabilir (bkz. http://dev.w3.org/2009/dap/file-system/file-dir-sys.html).
Bu adın aynı uygulamadan birden çok kez çağrılması, aynı herkese açık kullanıcı adının aynı dosya sistemine döndürülmesini sağlar.
Bu aramanın başarısız olabileceğini unutmayın. Örneğin, kullanıcı Chrome'da oturum açmamışsa veya herhangi bir ağ işlemi yoksa. Bu hataları işlemek için geri çağırmada chrome.runtime.lastError'un işaretli olması önemlidir.
Parametreler
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:(fileSystem: DOMFileSystem) => void
-
fileSystem
DOMFileSystem
-
İlerlemeler
-
Promise<DOMFileSystem>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
setConflictResolutionPolicy()
chrome.syncFileSystem.setConflictResolutionPolicy(
policy: ConflictResolutionPolicy,
callback?: function,
)
Uygulamanın 'syncable'
dosya depolama alanına ilişkin varsayılan çakışma çözümleme politikasını belirler. Varsayılan olarak 'last_write_win'
olarak ayarlanmıştır. Çakışma çözümü politikası 'last_write_win'
olarak ayarlandığında, mevcut dosyalardaki çakışmalar bir sonraki güncellemede otomatik olarak çözümlenir. İsteğin başarılı olup olmadığını anlamak için isteğe bağlı olarak callback
verilebilir.
Parametreler
-
policy
-
geri çağırma
Functions (isteğe bağlı)
callback
parametresi şu şekilde görünür:() => void
İlerlemeler
-
Promise<void>
Chrome 117 ve sonraki sürümlerVaatler yalnızca Manifest V3 ve sonraki sürümlerde desteklenir. Diğer platformların geri çağırmaları kullanması gerekir.
Etkinlikler
onFileStatusChanged
chrome.syncFileSystem.onFileStatusChanged.addListener(
callback: function,
)
Bir dosya, arka plan senkronizasyon hizmeti tarafından güncellendiğinde tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(detail: FileInfo) => void
-
detail
-
onServiceStatusChanged
chrome.syncFileSystem.onServiceStatusChanged.addListener(
callback: function,
)
Senkronizasyon arka ucunda bir hata veya başka bir durum değişikliği meydana geldiğinde (örneğin, ağ veya kimlik doğrulama hatası nedeniyle senkronizasyon geçici olarak devre dışı bırakıldığında) tetiklenir.
Parametreler
-
geri çağırma
işlev
callback
parametresi şu şekilde görünür:(detail: ServiceInfo) => void
-
detail
-