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

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

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

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

एडमिन SDK टूल शुरू करते समय, डिफ़ॉल्ट बकेट का नाम तय किया जा सकता है. इसके बाद, इस बकेट के लिए पुष्टि किया गया रेफ़रंस वापस पाया जा सकता है. बकेट के नाम में gs:// या कोई दूसरा प्रोटोकॉल प्रीफ़िक्स नहीं होना चाहिए. उदाहरण के लिए, अगर Firebase कंसोल में दिखाया गया बकेट यूआरएल gs://bucket-name.appspot.com है, तो एडमिन SDK में स्ट्रिंग bucket-name.appspot.com को पास करें.

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.

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 http://googlecloudplatform.github.io/google-cloud-java/latest/apidocs/com/google/cloud/storage/Bucket.html
// for more details.

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': '<BUCKET_NAME>.appspot.com'
})

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.
storage.go

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

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

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

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

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

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

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

पसंद के मुताबिक Firebase ऐप्लिकेशन का इस्तेमाल करें

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

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

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

bucket = storage.bucket(app=custom_app)

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

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

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

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 एडमिन SDK टूल, Cloud Storage का ऐक्सेस देने के लिए Google Cloud Storage क्लाइंट लाइब्रेरी पर निर्भर होते हैं. एडमिन SDK से मिलने वाले बकेट रेफ़रंस, इन लाइब्रेरी में तय किए गए ऑब्जेक्ट होते हैं. फ़ाइल अपलोड और डाउनलोड जैसे इस्तेमाल के मामलों में, लौटाए गए बकेट रेफ़रंस के इस्तेमाल का तरीका जानने के लिए, Google Cloud Storage क्लाइंट लाइब्रेरी के दस्तावेज़ और एपीआई रेफ़रंस देखें.