Cloud Storage रेफ़रंस में फ़ाइल अपलोड करने के बाद, फ़ाइल का मेटाडेटा भी पाया और अपडेट किया जा सकता है. उदाहरण के लिए, contentType प्रॉपर्टी को देखने या अपडेट करने के लिए. फ़ाइलों में, कस्टम की-वैल्यू पेयर भी सेव किए जा सकते हैं. इनमें फ़ाइल का अतिरिक्त मेटाडेटा भी शामिल होता है.
फ़ाइल का मेटाडेटा पाना
फ़ाइल के मेटाडेटा में name, size, और contentType (इसे अक्सर एमआईएमई टाइप कहा जाता है) जैसी सामान्य प्रॉपर्टी के साथ-साथ, contentDisposition और timeCreated जैसी कुछ कम सामान्य प्रॉपर्टी भी शामिल होती हैं. इस मेटाडेटा को getMetadata() तरीके का इस्तेमाल करके, Cloud Storage के रेफ़रंस से वापस पाया जा सकता है.
// Create reference to the file whose metadata you want to retrieve
final forestRef = storageRef.child("images/forest.jpg");
// Get metadata properties
final metadata = await forestRef.getMetadata();
// Metadata now contains the metadata for 'images/forest.jpg'
फ़ाइल का मेटाडेटा अपडेट करना
फ़ाइल अपलोड होने के बाद, updateMetadata() तरीके का इस्तेमाल करके, फ़ाइल के मेटाडेटा को कभी भी अपडेट किया जा सकता है. किन प्रॉपर्टी को अपडेट किया जा सकता है, इस बारे में ज़्यादा जानने के लिए पूरी सूची देखें. सिर्फ़ मेटाडेटा में बताई गई प्रॉपर्टी अपडेट की जाती हैं. बाकी सभी प्रॉपर्टी में कोई बदलाव नहीं किया जाता.
// Create reference to the file whose metadata you want to change
final forestRef = storageRef.child("images/forest.jpg");
// Create file metadata to update
final newMetadata = SettableMetadata(
cacheControl: "public,max-age=300",
contentType: "image/jpeg",
);
// Update metadata properties
final metadata = await forestRef.updateMetadata(newMetadata);
// Updated metadata for 'images/forest.jpg' is returned
null को पास करके, मेटाडेटा की ऐसी प्रॉपर्टी मिटाई जा सकती हैं जिनमें बदलाव किया जा सकता है:
// Delete the cacheControl property
final newMetadata = SettableMetadata(cacheControl: null);
final metadata = await forestRef.updateMetadata(newMetadata);
गड़बड़ी ठीक करना
मेटाडेटा पाने या अपडेट करने में गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल का मौजूद न होना या उपयोगकर्ता के पास फ़ाइल को ऐक्सेस करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानने के लिए, गड़बड़ियों को ठीक करना लेख पढ़ें.
कस्टम मेटाडेटा
SettableMetadata कंस्ट्रक्टर के customMetadata पैरामीटर का इस्तेमाल करके, कस्टम मेटाडेटा तय किया जा सकता है:
// Create reference to the file whose metadata you want to change
final forestRef = storageRef.child("images/forest.jpg");
// Create file metadata to update
final newCustomMetadata = SettableMetadata(
customMetadata: {
"location": "Yosemite, CA, USA",
"activity": "Hiking",
},
);
// Update metadata properties
final metadata = await forestRef.updateMetadata(newCustomMetadata);
// Updated metadata for 'images/forest.jpg' is returned
कस्टम मेटाडेटा में, हर फ़ाइल के लिए ऐप्लिकेशन से जुड़ा डेटा सेव किया जा सकता है. हालांकि, हमारा सुझाव है कि इस तरह के डेटा को सेव और सिंक करने के लिए, Firebase Realtime Database जैसे डेटाबेस का इस्तेमाल करें.
फ़ाइल के मेटाडेटा की प्रॉपर्टी
किसी फ़ाइल में मौजूद मेटाडेटा प्रॉपर्टी की पूरी सूची यहां दी गई है:
| प्रॉपर्टी | टाइप | क्या इसे सेट किया जा सकता है? |
|---|---|---|
bucket |
String |
नहीं |
generation |
String |
नहीं |
metageneration |
String |
नहीं |
metadataGeneration |
String |
नहीं |
fullPath |
String |
नहीं |
name |
String |
नहीं |
size |
int |
नहीं |
timeCreated |
DateTime |
नहीं |
updated |
DateTime |
नहीं |
md5Hash |
String |
नहीं |
cacheControl |
String |
हां |
contentDisposition |
String |
हां |
contentEncoding |
String |
हां |
contentLanguage |
String |
हां |
contentType |
String |
हां |
customMetadata |
Map<String, String> |
हां |
फ़ाइलों को अपलोड, डाउनलोड, और अपडेट करना ज़रूरी है. हालांकि, उन्हें मिटाना भी ज़रूरी है. इसके बाद, Cloud Storage से फ़ाइलें मिटाने का तरीका जानें.