Utilizza i metadati dei file con Cloud Storage for C++

Dopo aver caricato un file nel riferimento Cloud Storage, puoi anche recuperare e aggiornare i metadati del file, ad esempio per aggiornare il tipo di contenuto. I file possono anche archiviare coppie chiave/valore personalizzate con metadati di file aggiuntivi.

Nota: per impostazione predefinita, un bucket Cloud Storage for Firebase richiede Firebase Authentication per eseguire qualsiasi azione sui dati o sui file del bucket. Puoi modificare le tue Firebase Security Rules per Cloud Storage per consentire l'accesso non autenticato in situazioni specifiche. Tuttavia, nella maggior parte dei casi, ti consigliamo vivamente di limitare l'accesso e configurare regole di sicurezza solide (soprattutto per le app di produzione). Tieni presente che se utilizzi Google App Engine e hai un bucket Cloud Storage predefinito con un formato del nome *.appspot.com, potresti dover valutare l'impatto delle regole di sicurezza sull'accesso ai file App Engine.

Recuperare i metadati dei file

I metadati dei file contengono proprietà comuni come name, size e content_type (spesso indicato come tipo MIME), oltre ad alcune meno comuni come content_disposition e time_created. Questi metadati possono essere recuperati da un Cloud Storage riferimento utilizzando il GetMetadata metodo.

// 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();
}

Aggiornare i metadati dei file

Puoi aggiornare i metadati dei file in qualsiasi momento dopo il completamento del caricamento del file utilizzando il metodo UpdateMetadata. Per ulteriori informazioni sulle proprietà che possono essere aggiornate, consulta l' elenco completo. Vengono aggiornate solo le proprietà specificate nei metadati, tutte le altre rimangono invariate.

// 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();
}

Puoi eliminare le proprietà dei metadati scrivibili passando la stringa vuota:

// 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();
}

Gestire gli errori

Esistono diversi motivi per cui potrebbero verificarsi errori durante il recupero o l'aggiornamento dei metadati, tra cui il file non esistente o l'utente che non dispone dell'autorizzazione per accedere al file desiderato. Per ulteriori informazioni sugli errori, consulta la sezione Gestire gli errori della documentazione.

Metadati personalizzati

Puoi specificare i metadati personalizzati come std::map contenente proprietà std::string.

std::map<std::string, std::string>* custom_metadata = metadata.custom_metadata();
custom_metadata->insert(std::make_pair("location", "Yosemite, CA, USA");
custom_metadata->insert(std::make_pair("activity", "Hiking");

Puoi archiviare i dati specifici dell'app per ogni file nei metadati personalizzati, ma ti consigliamo vivamente di utilizzare un database (ad esempio Firebase Realtime Database) per archiviare e sincronizzare questo tipo di dati.

Proprietà dei metadati dei file

Di seguito è riportato un elenco completo delle proprietà dei metadati di un file:

Proprietà	Tipo	Scrivibile
bucket	const char*	NO
generation	const char*	NO
metageneration	const char*	NO
full_path	const char*	NO
name	const char*	NO
size	int64_t	NO
time_created	int64_t	NO
updated	int64_t	NO
cache_control	const char*	SÌ
content_disposition	const char*	SÌ
content_encoding	const char*	SÌ
content_language	const char*	SÌ
content_type	const char*	SÌ
download_urls	std::vector<std::string>	NO
custom_metadata	std::map<std::string, std::string>	SÌ

Passaggi successivi

Il caricamento, il download e l'aggiornamento dei file sono importanti, ma lo è anche la possibilità di rimuoverli. Scopriamo come eliminare i file da Cloud Storage.