Admin Cloud Storage API के बारे में जानकारी

Cloud Storage for Firebase आपके डेटा को Google Cloud Storage बकेट में सेव करता है. यह एक्साबाइट स्केल ऑब्जेक्ट स्टोरेज सलूशन है, जो ज़्यादा अपटाइम और ग्लोबल रिडंडंसी के साथ आता है. Firebase Admin SDK की मदद से, खास ऐक्सेस वाले एनवायरमेंट से सीधे Cloud Storage बकेट को ऐक्सेस किया जा सकता है. इसके बाद, बकेट में सेव किए गए ऑब्जेक्ट में बदलाव करने के लिए, Google Cloud Storage एपीआई का इस्तेमाल किया जा सकता है.

Admin SDK की मदद से, शेयर किए जा सकने वाले यूआरएल भी बनाए जा सकते हैं. इससे उपयोगकर्ता, आपकी बकेट में मौजूद ऑब्जेक्ट डाउनलोड कर सकते हैं.

पक्का करें कि आपका Firebase प्रोजेक्ट, इस्तेमाल के हिसाब से पैसे चुकाने वाले ब्लेज़ प्लान पर हो. Cloud Storage for Firebase का इस्तेमाल करने के लिए, यह ज़रूरी है. अगर आपने Firebase और Google Cloud का इस्तेमाल हाल ही में शुरू किया है, तो देखें कि आपको 300 डॉलर का मुफ़्त क्रेडिट मिल सकता है या नहीं.

डिफ़ॉल्ट बकेट का इस्तेमाल करना

Admin SDK टूल को शुरू करते समय, डिफ़ॉल्ट बकेट का नाम तय किया जा सकता है. इसके बाद, इस बकेट के लिए पुष्टि किया गया रेफ़रंस वापस पाया जा सकता है.

बकेट के नाम में gs:// या कोई अन्य प्रोटोकॉल प्रीफ़िक्स नहीं होना चाहिए. उदाहरण के लिए, अगर Firebase console में दिखाया गया बकेट यूआरएल gs://PROJECT_ID.firebasestorage.app है, तो Admin SDK को स्ट्रिंग PROJECT_ID.firebasestorage.app पास करें.

Node.js

const { initializeApp, cert } = require('firebase-admin/app');
const { getStorage } = require('firebase-admin/storage');

const serviceAccount = require('./path/to/serviceAccountKey.json');

initializeApp({
  credential: cert(serviceAccount),
  storageBucket: '<BUCKET_NAME>.appspot.com'
});

const bucket = getStorage().bucket();

// 'bucket' is an object defined in the @google-cloud/storage library.
// See https://googlecloudplatform.github.io/google-cloud-node/#/docs/storage/latest/storage/bucket
// for more details.

Java

FileInputStream serviceAccount = new FileInputStream("path/to/serviceAccountKey.json");

FirebaseOptions options = FirebaseOptions.builder()
    .setCredentials(GoogleCredentials.fromStream(serviceAccount))
    .setStorageBucket("<BUCKET_NAME>.appspot.com")
    .build();
FirebaseApp.initializeApp(options);

Bucket bucket = StorageClient.getInstance().bucket();

// 'bucket' is an object defined in the google-cloud-storage Java library.
// See https://cloud.google.com/java/docs/reference/google-cloud-storage/latest/com.google.cloud.storage.Bucket
// for more details.

Python

import firebase_admin
from firebase_admin import credentials
from firebase_admin import storage

cred = credentials.Certificate('path/to/serviceAccountKey.json')
firebase_admin.initialize_app(cred, {
    'storageBucket': 'PROJECT_ID.firebasestorage.app'
})

bucket = storage.bucket()

# 'bucket' is an object defined in the google-cloud-storage Python library.
# See https://googlecloudplatform.github.io/google-cloud-python/latest/storage/buckets.html
# for more details.

जाएं

import (
	"context"
	"log"

	firebase "firebase.google.com/go/v4"
	"firebase.google.com/go/v4/auth"
	"google.golang.org/api/option"
)

config := &firebase.Config{
	StorageBucket: "<BUCKET_NAME>.appspot.com",
}
opt := option.WithCredentialsFile("path/to/serviceAccountKey.json")
app, err := firebase.NewApp(context.Background(), config, opt)
if err != nil {
	log.Fatalln(err)
}

client, err := app.Storage(context.Background())
if err != nil {
	log.Fatalln(err)
}

bucket, err := client.DefaultBucket()
if err != nil {
	log.Fatalln(err)
}
// 'bucket' is an object defined in the cloud.google.com/go/storage package.
// See https://godoc.org/cloud.google.com/go/storage#BucketHandle
// for more details.

Admin SDK से मिले बकेट रेफ़रंस का इस्तेमाल, आधिकारिक Google Cloud Storage क्लाइंट लाइब्रेरी के साथ किया जा सकता है. इससे, आपके Firebase प्रोजेक्ट से जुड़ी बकेट में कॉन्टेंट अपलोड किया जा सकता है, डाउनलोड किया जा सकता है, और उसमें बदलाव किया जा सकता है. ध्यान दें कि Firebase Admin SDK का इस्तेमाल करते समय, आपको Google Cloud Storage लाइब्रेरी की पुष्टि करने की ज़रूरत नहीं है. Admin SDK से मिले बकेट रेफ़रंस की पुष्टि, आपके Firebase ऐप्लिकेशन को शुरू करने के लिए इस्तेमाल किए गए क्रेडेंशियल से पहले ही हो चुकी होती है.

कस्टम बकेट का इस्तेमाल करना

अगर आपको इस गाइड में पहले बताई गई डिफ़ॉल्ट बकेट के बजाय, किसी दूसरी Cloud Storage बकेट का इस्तेमाल करना है या एक ही ऐप्लिकेशन में कई Cloud Storage बकेट का इस्तेमाल करना है, तो कस्टम बकेट का रेफ़रंस वापस पाया जा सकता है:

Node.js

const bucket = getStorage().bucket('my-custom-bucket');

Java

Bucket bucket = StorageClient.getInstance().bucket("my-custom-bucket");

Python

bucket = storage.bucket('my-custom-bucket')

जाएं

 bucket, err := client.Bucket("my-custom-bucket")

कस्टम Firebase ऐप्लिकेशन का इस्तेमाल करना

अगर आपको कोई ऐसा जटिल ऐप्लिकेशन बनाना है जो एक से ज़्यादा Firebase ऐप्लिकेशन के साथ इंटरैक्ट करता है, तो किसी Firebase ऐप्लिकेशन से जुड़ी Cloud Storage बकेट को ऐक्सेस किया जा सकता है. इसके लिए, यह तरीका अपनाएं:

Node.js

const bucket = getStorage(customApp).bucket();

Java

Bucket bucket = StorageClient.getInstance(customApp).bucket();

Python

bucket = storage.bucket(app=custom_app)

जाएं

otherClient, err := otherApp.Storage(context.Background())
bucket, err := otherClient.Bucket("other-app-bucket")

शेयर किया जा सकने वाला डाउनलोड यूआरएल पाना

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

Node.js

const { getStorage, getDownloadURL } = require('firebase-admin/storage');

const fileRef = getStorage().bucket('my-bucket').file('my-file');
const downloadURL= await getDownloadURL(fileRef);

Google Cloud Storage क्लाइंट लाइब्रेरी

Firebase Admin SDK, Google Cloud Storage क्लाइंट लाइब्रेरी पर निर्भर करते हैं, ताकि Cloud Storage का ऐक्सेस दिया जा सके. Admin SDK से मिले बकेट रेफ़रंस, इन लाइब्रेरी में तय किए गए ऑब्जेक्ट होते हैं. Google Cloud Storage क्लाइंट लाइब्रेरी के दस्तावेज़ और एपीआई का संदर्भ देखें. इससे आपको यह जानने में मदद मिलेगी कि फ़ाइल अपलोड और डाउनलोड करने जैसे इस्तेमाल के उदाहरणों में, बकेट के रेफ़रंस का इस्तेमाल कैसे किया जाता है.