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 है, तो एडमिन 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 http://googlecloudplatform.github.io/google-cloud-java/latest/apidocs/com/google/cloud/storage/Bucket.html
// 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 टूल से मिले बकेट रेफ़रंस का इस्तेमाल, अपने Firebase प्रोजेक्ट से जुड़ी बकेट में कॉन्टेंट अपलोड करने, डाउनलोड करने, और उसमें बदलाव करने के लिए किया जा सकता है. इसके लिए, आपको आधिकारिक Google Cloud Storage क्लाइंट लाइब्रेरी का इस्तेमाल करना होगा. ध्यान दें कि 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 क्लाइंट लाइब्रेरी

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