C++ के लिए Cloud Storage के साथ फ़ाइल मेटाडेटा का इस्तेमाल करना

Cloud Storage रेफ़रंस में फ़ाइल अपलोड करने के बाद, फ़ाइल का मेटाडेटा भी ऐक्सेस और अपडेट किया जा सकता है. उदाहरण के लिए, कॉन्टेंट टाइप अपडेट करने के लिए. Files में, पसंद के मुताबिक बनाए गए कुंजी/वैल्यू पेयर को भी फ़ाइल के अतिरिक्त मेटाडेटा के साथ सेव किया जा सकता है.

ध्यान दें: डिफ़ॉल्ट रूप से, Cloud Storage for Firebase बकेट के डेटा या फ़ाइलों पर कोई कार्रवाई करने के लिए, Firebase Authentication को अनुमति की ज़रूरत होती है. कुछ खास मामलों में पुष्टि किए बिना ऐक्सेस देने की अनुमति देने के लिए, Firebase Security Rules को Cloud Storage में बदला जा सकता है. हालांकि, ज़्यादातर मामलों में, हमारा सुझाव है कि आप ऐक्सेस पर पाबंदी लगाएं और सुरक्षा से जुड़े सख्त नियम सेट अप करें. ऐसा खास तौर पर, प्रोडक्शन ऐप्लिकेशन के लिए करें. ध्यान दें कि अगर Google App Engine का इस्तेमाल किया जाता है और आपके पास *.appspot.com नाम वाले फ़ॉर्मैट वाली डिफ़ॉल्ट Cloud Storage बकेट है, तो आपको यह देखना पड़ सकता है कि आपके सुरक्षा नियम, App Engine फ़ाइलों के ऐक्सेस पर कैसे असर डालते हैं.

फ़ाइल का मेटाडेटा पाना

फ़ाइल मेटाडेटा में name, size, और content_type (जिसे अक्सर MIME टाइप कहा जाता है) जैसी सामान्य प्रॉपर्टी के साथ-साथ, content_disposition और time_created जैसी कुछ कम सामान्य प्रॉपर्टी भी शामिल होती हैं. इस मेटाडेटा को GetMetadata तरीके का इस्तेमाल करके, Cloud Storage पहचान फ़ाइल से वापस लाया जा सकता है.

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

फ़ाइल का मेटाडेटा अपडेट करना

फ़ाइल अपलोड होने के बाद, UpdateMetadata तरीके का इस्तेमाल करके, फ़ाइल का मेटाडेटा कभी भी अपडेट किया जा सकता है. किन प्रॉपर्टी को अपडेट किया जा सकता है, इस बारे में ज़्यादा जानकारी के लिए पूरी सूची देखें. मेटाडेटा में बताई गई प्रॉपर्टी ही अपडेट की जाती हैं. बाकी सभी प्रॉपर्टी में कोई बदलाव नहीं किया जाता.

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

खाली स्ट्रिंग पास करके, लिखने लायक मेटाडेटा प्रॉपर्टी मिटाई जा सकती हैं:

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

गड़बड़ियां ठीक करना

मेटाडेटा पाने या अपडेट करने पर गड़बड़ियां होने की कई वजहें हो सकती हैं. जैसे, फ़ाइल मौजूद न होना या उपयोगकर्ता के पास, अपनी पसंद की फ़ाइल को ऐक्सेस करने की अनुमति न होना. गड़बड़ियों के बारे में ज़्यादा जानकारी पाने के लिए, दस्तावेज़ों के गड़बड़ियों को मैनेज करें सेक्शन पर जाएं.

कस्टम मेटाडेटा

कस्टम मेटाडेटा को std::string वाली std::map प्रॉपर्टी के तौर पर तय किया जा सकता है.

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");

कस्टम मेटाडेटा में, हर फ़ाइल के लिए ऐप्लिकेशन से जुड़ा डेटा सेव किया जा सकता है. हालांकि, हमारा सुझाव है कि इस तरह के डेटा को सेव और सिंक करने के लिए, किसी डेटाबेस (जैसे, Firebase Realtime Database) का इस्तेमाल करें.

फ़ाइल मेटाडेटा प्रॉपर्टी

किसी फ़ाइल में मौजूद मेटाडेटा प्रॉपर्टी की पूरी सूची यहां दी गई है:

प्रॉपर्टी	टाइप	लिखा जा सकता है
bucket	const char*	नहीं
generation	कॉन्स्ट वर्ण*	नहीं
metageneration	कॉन्स्ट वर्ण*	नहीं
full_path	कॉन्स्ट वर्ण*	नहीं
name	कॉन्स्ट वर्ण*	नहीं
size	int64_t	नहीं
time_created	int64_t	नहीं
updated	int64_t	नहीं
cache_control	const char*	YES
content_disposition	const char*	YES
content_encoding	const char*	YES
content_language	const char*	YES
content_type	const char*	YES
download_urls	std::वेक्टर<std::स्ट्रिंग>	नहीं
custom_metadata	std::map<std::string, std::string>	YES

अगले चरण

फ़ाइलों को अपलोड, डाउनलोड, और अपडेट करना ज़रूरी है, लेकिन इन्हें हटाने में मदद पाना भी ज़रूरी है. आइए, Cloud Storage से फ़ाइलें मिटाने का तरीका जानें.