Buka konsol

Menggunakan Metadata File di iOS

Setelah mengupload file ke referensi Cloud Storage, Anda juga dapat mengambil dan mengupdate metadata file, misalnya untuk mengupdate jenis konten. File juga dapat menyimpan key-value pair khusus dengan metadata file tambahan.

Mengambil Metadata File

Metadata file berisi properti umum, seperti name, size, dan contentType (sering disebut jenis MIME), serta beberapa properti yang jarang digunakan, seperti contentDisposition dan timeCreated. Metadata ini dapat diambil dari referensi Cloud Storage menggunakan metode metadataWithCompletion:.

Swift

// Create reference to the file whose metadata we want to retrieve
let forestRef = storageRef.child("images/forest.jpg")

// Get metadata properties
forestRef.getMetadata { metadata, error in
  if let error = error {
    // Uh-oh, an error occurred!
  } else {
    // Metadata now contains the metadata for 'images/forest.jpg'
  }
}    

Objective-C

// Create reference to the file whose metadata we want to retrieve
FIRStorageReference *forestRef = [storageRef child:@"images/forest.jpg"];

// Get metadata properties
[forestRef metadataWithCompletion:^(FIRStorageMetadata *metadata, NSError *error) {
  if (error != nil) {
    // Uh-oh, an error occurred!
  } else {
    // Metadata now contains the metadata for 'images/forest.jpg'
  }
}];  

Mengupdate Metadata File

Anda dapat mengupdate metadata file kapan saja setelah upload file selesai menggunakan metode updateMetadata:withCompletion:. Lihat daftar lengkap untuk mengetahui informasi lebih lanjut mengenai properti yang dapat diupdate. Hanya properti yang ditetapkan dalam metadata yang akan diupdate, sedangkan yang lainnya tidak berubah.

Swift

// Create reference to the file whose metadata we want to change
let forestRef = storageRef.child("images/forest.jpg")

// Create file metadata to update
let newMetadata = StorageMetadata()
newMetadata.cacheControl = "public,max-age=300";
newMetadata.contentType = "image/jpeg";

// Update metadata properties
forestRef.updateMetadata(newMetadata) { metadata, error in
  if let error = error {
    // Uh-oh, an error occurred!
  } else {
    // Updated metadata for 'images/forest.jpg' is returned
  }
}    

Objective-C

// Create reference to the file whose metadata we want to change
FIRStorageReference *forestRef = [storageRef child:@"images/forest.jpg"];

// Create file metadata to update
FIRStorageMetadata *newMetadata = [[FIRStorageMetadata alloc] init];
newMetadata.cacheControl = @"public,max-age=300";
newMetadata.contentType = @"image/jpeg";

// Update metadata properties
[forestRef updateMetadata:newMetadata completion:^(FIRStorageMetadata *metadata, NSError *error){
  if (error != nil) {
    // Uh-oh, an error occurred!
  } else {
    // Updated metadata for 'images/forest.jpg' is returned
  }
}];  

Anda dapat menghapus properti metadata yang dapat ditulis dengan meneruskan string kosong:

Objective-C

FIRStorageMetadata *newMetadata = [[FIRStorageMetadata alloc] init];
newMetadata.contentType = @"";

// Delete the metadata property
[forestRef updateMetadata:newMetadata completion:^(FIRStorageMetadata *metadata, NSError *error){
  if (error != nil) {
    // Uh-oh, an error occurred!
  } else {
    // metadata.contentType should be nil
  }
}];

Swift

let newMetadata = StorageMetadata()
newMetadata.contentType = "";

// Delete the metadata property
forestRef.updateMetadata(newMetadata) { metadata, error in
  if let error = error {
    // Uh-oh, an error occurred!
  } else {
    // metadata.contentType should be nil
  }
}

Menangani Error

Ada sejumlah alasan mengapa error dapat terjadi saat mengambil atau mengupdate metadata, termasuk tidak adanya file atau pengguna tidak memiliki izin untuk mengakses file yang diinginkan. Informasi lebih lanjut mengenai error bisa dilihat di bagian Menangani Error pada dokumen.

Metadata Khusus

Anda dapat menetapkan metadata khusus sebagai NSDictionary yang berisi properti NSString.

Swift

let metadata = [
  "customMetadata": [
    "location": "Yosemite, CA, USA",
    "activity": "Hiking"
  ]
]    

Objective-C

NSDictionary *metadata = @{
  @"customMetadata": @{
    @"location": @"Yosemite, CA, USA",
    @"activity": @"Hiking"
  }
};

Anda dapat menyimpan data khusus aplikasi untuk setiap file dalam metadata khusus, tetapi kami sangat menyarankan penggunaan database (seperti Firebase Realtime Database) untuk menyimpan dan menyinkronkan jenis data ini.

Properti Metadata File

Daftar lengkap properti metadata pada file tercantum di bawah ini:

Properti Jenis Dapat Ditulis
bucket NSString TIDAK
generation NSString TIDAK
metageneration NSString TIDAK
fullPath NSString TIDAK
name NSString TIDAK
size int64_t TIDAK
timeCreated NSDate TIDAK
updated NSDate TIDAK
md5Hash NSString YA
cacheControl NSString YA
contentDisposition NSString YA
contentEncoding NSString YA
contentLanguage NSString YA
contentType NSString YA
downloadURLs NSArray<NSString> TIDAK
customMetadata NSDictionary<NSString, NSString> YA

Mengupload, mendownload, dan memperbarui file adalah hal penting, namun file juga harus bisa dihapus. Mari pelajari cara menghapus file dari Cloud Storage.