Açıklama
Google Drive'da veri 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 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 başlıklı makaleyi 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'
olduğunda geçerlidir. -
direction
SyncDirection isteğe bağlı
onFileStatusChanged
etkinliği için yol tarifini senkronize edin. Senkronizasyon yönü değeri'local_to_remote'
veya'remote_to_local'
olabilir. Yalnızca durum'synced'
olduğunda geçerlidir. -
fileEntry
Giriş
Durumu değişen hedef dosya için
fileEntry
. Senkronize edilmiş dosyanın adını ve yol bilgilerini içerir. Dosya silme işleminden sonrafileEntry
bilgileri kullanılabilir olmaya devam eder ancak dosya artık mevcut olmaz. -
durum
onFileStatusChanged
etkinliğinden sonra ortaya çıkan dosya durumu. Durum değeri'synced'
,'pending'
veya'conflicting'
olabilir.
FileStatus
Enum
"synced"
Çakışan değil ve bekleyen yerel değişikliği yok.
"pending"
Senkronize edilmemiş bir veya daha fazla beklemede yerel değişikliği var.
"conflicting"
Dosya, uzak sürümle çakışıyor ve manuel olarak çözülmesi gerekiyor.
FileStatusInfo
Özellikler
-
hata
dize isteğe bağlı
Yalnızca ilgili dosyanın FileStatus (Dosya Durumu) alınırken bir sorun oluştuğunda döndürülen isteğe bağlı hata.
-
fileEntry
Giriş
İlk olarak getFileStatuses'a bir giriş verilmiştir.
-
durum
Durum değeri
'synced'
,'pending'
veya'conflicting'
olabilir.
ServiceInfo
Özellikler
-
açıklama
dize
-
durum
ServiceStatus
Enum
"Başlatılıyor"
Senkronizasyon hizmeti başlatılıyor (ör. verileri veritabanından geri yükleme, bağlantıyı kontrol etme ve hizmet için kimlik doğrulaması yapma).
" running"
Senkronizasyon hizmeti etkin ve çalışır durumdadır.
"authentication_required"
Uzak hizmetin devam edebilmesi için kullanıcı kimliğinin doğrulanması gerektiğinden senkronizasyon hizmeti dosyaları senkronize etmiyor.
"temporary_unavailable"
Uzak hizmet, bazı kurtarılabilir hatalardan dolayı (geçici olarak) kullanılamadığından senkronizasyon hizmeti dosyaları senkronize etmiyor. Örneğin, ağ çevrimdışı, uzak hizmet kapalı veya erişilemez vb. OnServiceInfoUpdated sayfasındaki description
parametresiyle (hizmete özgü ayrıntılar içerebilir) daha fazla ayrıntı verilmelidir.
" disabled"
Senkronizasyon hizmeti devre dışıdır ve içerik hiçbir zaman senkronize edilmeyecektir. (Örneğin, kullanıcının uzak hizmette hesabı yoksa veya senkronizasyon hizmetinde düzeltilemeyen bir hata oluştuysa bu durum ortaya çıkabilir.)
StorageInfo
Özellikler
-
quotaBytes
sayı
-
usageBytes
sayı
SyncAction
Enum
"eklendi"
"güncellendi"
"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
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(policy: ConflictResolutionPolicy) => void
-
policy
-
İadeler
-
Promise<ConflictResolutionPolicy>
Chrome 117 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getFileStatus()
chrome.syncFileSystem.getFileStatus(
fileEntry: Entry,
callback?: function,
)
Belirtilen 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 ayarlandığında geçerli olduğunu unutmayın.
Parametreler
-
fileEntry
Giriş
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(status: FileStatus) => void
-
durum
-
İadeler
-
Promise<FileStatus>
Chrome 117 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getFileStatuses()
chrome.syncFileSystem.getFileStatuses(
fileEntries: object[],
callback?: function,
)
Belirli bir fileEntry
dizisi için her bir FileStatus
değerini döndürür. Genellikle dirReader.readEntries() sonucuyla çağrılır.
Parametreler
-
fileEntries
object[]
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(status: FileStatusInfo[]) => void
-
durum
-
İadeler
-
Promise<FileStatusInfo[]>
Chrome 117 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getServiceStatus()
chrome.syncFileSystem.getServiceStatus(
callback?: function,
)
Mevcut senkronizasyon arka uç durumunu döndürür.
Parametreler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(status: ServiceStatus) => void
-
durum
-
İadeler
-
Promise<ServiceStatus>
Chrome 117 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
getUsageAndQuota()
chrome.syncFileSystem.getUsageAndQuota(
fileSystem: DOMFileSystem,
callback?: function,
)
Uygulamanın 'syncable'
dosya depolama alanı için mevcut kullanımı ve kotayı bayt cinsinden döndürür.
Parametreler
-
fileSystem
DOMFileSystem
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(info: StorageInfo) => void
-
bilgi
-
İadeler
-
Promise<StorageInfo>
Chrome 117 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
requestFileSystem()
chrome.syncFileSystem.requestFileSystem(
callback?: function,
)
Google Drive tarafından desteklenen senkronize edilebilir bir dosya sistemini 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 herkese açık kullanıcı adı, aynı uygulamadan birden fazla kez çağrıldığında aynı herkese açık kullanıcı adı aynı dosya sistemine döndürülür.
Bu aramanın başarısız olabileceğini unutmayın. Örneğin, kullanıcı Chrome'da oturum açmamışsa veya ağ işlemi yoksa. Bu hataları işlemek için geri çağırmada chrome.runtime.lastError öğesinin kontrol edilmesi önemlidir.
Parametreler
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:(fileSystem: DOMFileSystem) => void
-
fileSystem
DOMFileSystem
-
İadeler
-
Promise<DOMFileSystem>
Chrome 117 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması gerekir.
setConflictResolutionPolicy()
chrome.syncFileSystem.setConflictResolutionPolicy(
policy: ConflictResolutionPolicy,
callback?: function,
)
Uygulamanın 'syncable'
dosya depolamasına ilişkin varsayılan çakışma çözümü politikasını ayarlar. Varsayılan olarak 'last_write_win'
değerine ayarlıdır. Çakışma çözümleme politikası 'last_write_win'
olarak ayarlandığında, mevcut dosyalar için çakışmalar dosya tekrar güncellendiğinde otomatik olarak çözülür. İsteğin başarılı olup olmadığını öğrenmek için isteğe bağlı olarak callback
verilebilir.
Parametreler
-
policy
-
geri çağırma
işlev isteğe bağlı
callback
parametresi şu şekilde görünür:() => void
İadeler
-
Taahhüt<void>
Chrome 117 ve sonraki sürümler 'nı inceleyin.Vaatler yalnızca Manifest V3 ve sonraki sürümler için desteklenir. Diğer platformların geri çağırma yapması 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 olduğunda (ö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
-