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

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

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

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

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

बकेट के नाम में gs:// या प्रोटोकॉल के अन्य प्रीफ़िक्स नहीं होने चाहिए. उदाहरण के लिए, अगर Firebase कंसोल में दिखाया गया बकेट यूआरएल 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.

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