Usar metadatos de archivos con Cloud Storage para C++

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 content_type (a menudo denominado tipo MIME), además de algunas menos comunes como content_disposition y time_created . Estos metadatos se pueden recuperar de una referencia de Cloud Storage mediante el método GetMetadata .

// Create reference to the file whose metadata we want to retrieve
StorageReference forest_ref = storage_ref.Child("images/forest.jpg");

// Get metadata properties
Future future = forest_ref.GetMetadata();

// Wait for Future to complete...

if (future.Error() != firebase::storage::kErrorNone) {
  // Uh-oh, an error occurred!
} else {
  // We can now retrieve the metadata for 'images/forest.jpg'
  Metadata* metadata = future.Result();
}

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 . 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
firebase::storage::StorageReference forest_ref = storage_ref.child("images/forest.jpg");

// Create file metadata to update
Metadata new_metadata;
newMetadata.set_cache_control("public,max-age=300");
newMetadata.set_content_type("image/jpeg");

// Update metadata properties
Future future = forest_ref.UpdateMetadata(new_metadata);

// Wait for Future to complete...

if (future.Error() != firebase::storage::kErrorNone) {
  // Uh-oh, an error occurred!
} else {
  // We can now retrieve the updated metadata for 'images/forest.jpg'
  Metadata* metadata = future.Result();
}

Puede eliminar propiedades de metadatos grabables pasando la cadena vacía:

// Create file metadata with property to delete
StorageMetadata new_metadata;
new_metadata.set_content_type("");

// Delete the metadata property
Future future = forest_ref.UpdateMetadata(new_metadata);

// Wait for Future to complete...

if (future.Error() != 0) {
  // Uh-oh, an error occurred!
} else {
  // metadata.content_type() should be an empty string
  Metadata* metadata = future.Result();
}

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 std::map que contiene propiedades std::string .

std::map* custom_metadata = metadata.custom_metadata();
custom_metadata->insert(std::make_pair("location", "Yosemite, CA, USA");
custom_metadata->insert(std::make_pair("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:

Propiedad	Tipo	grabable
bucket	carácter constante*	NO
generation	carácter constante*	NO
metageneration	carácter constante*	NO
full_path	carácter constante*	NO
name	carácter constante*	NO
size	int64_t	NO
time_created	int64_t	NO
updated	int64_t	NO
cache_control	carácter constante*	SÍ
content_disposition	carácter constante*	SÍ
content_encoding	carácter constante*	SÍ
content_language	carácter constante*	SÍ
content_type	carácter constante*	SÍ
download_urls	std::vector<std::cadena>	NO
custom_metadata	std::map<std::cadena, std::cadena>	SÍ

Próximos pasos

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