Utilice metadatos de archivos con Cloud Storage en plataformas Apple

Después de cargar un archivo en la referencia de Cloud Storage, también puede obtener y actualizar los metadatos del archivo, por ejemplo, para actualizar el tipo de contenido. Los archivos también pueden almacenar pares clave/valor personalizados con metadatos de archivo adicionales.

Obtener metadatos de archivos

Los metadatos de archivos contienen propiedades comunes como name , size y contentType (a menudo denominado tipo MIME), además de algunas menos comunes como contentDisposition y timeCreated . Estos metadatos se pueden recuperar de una referencia de Cloud Storage mediante el método metadataWithCompletion:

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

// Get metadata properties
do {
  let metadata = try await forestRef.getMetadata()
} catch {
  // ...
}
    

// 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'
  }
}];
  

Actualizar metadatos del archivo

Puede actualizar los metadatos del archivo en cualquier momento después de que se complete la carga del archivo mediante el método updateMetadata:withCompletion: Consulte la lista completa para obtener más información sobre qué propiedades se pueden actualizar. Sólo se actualizan las propiedades especificadas en los metadatos, todas las demás no se modifican.

// 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
do {
  let updatedMetadata = try await forestRef.updateMetadata(newMetadata)
} catch {
  // ...
}
    

// 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
  }
}];
  

Puede eliminar propiedades de metadatos grabables configurándolas en nil :

FIRStorageMetadata *newMetadata = [[FIRStorageMetadata alloc] init];
newMetadata.contentType = nil;

// 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
  }
}];

let newMetadata = StorageMetadata()
newMetadata.contentType = nil

do {
  // Delete the metadata property
  let updatedMetadata = try await forestRef.updateMetadata(newMetadata)
} catch {
  // ...
}

Manejar errores

Hay varias razones por las que pueden ocurrir errores al obtener o actualizar metadatos, incluido el archivo que no existe o que el usuario no tiene permiso para acceder al archivo deseado. Puede encontrar más información sobre errores en la sección Manejar errores de los documentos.

Metadatos personalizados

Puede especificar metadatos personalizados como un NSDictionary que contiene propiedades NSString .

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

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

Puede almacenar datos específicos de la aplicación para cada archivo en metadatos personalizados, pero recomendamos encarecidamente utilizar una base de datos (como Firebase Realtime Database ) para almacenar y sincronizar este tipo de datos.

Propiedades de metadatos de archivo

A continuación se encuentra disponible una lista completa de las propiedades de metadatos de un archivo:

Cargar, descargar y actualizar archivos es importante, pero también lo es poder eliminarlos. Aprendamos cómo eliminar archivos de Cloud Storage.