Google is committed to advancing racial equity for Black communities. See how.
ترجمت واجهة Cloud Translation API‏ هذه الصفحة.
Switch to English

مقدمة إلى Admin Cloud Storage API

يخزن Cloud Storage for Firebase بياناتك في Google Cloud Storage ، وهو حل تخزين كائنات بحجم إكسابايت مع توفر عالٍ وتكرار عالمي. يسمح لك Firebase Admin SDK بالوصول مباشرة إلى حاويات Google Cloud Storage من بيئات مميزة. بعد ذلك يمكنك استخدام Google Cloud Storage APIs لمعالجة الكائنات المخزنة في الحاويات.

استخدم دلوًا افتراضيًا

يمكنك تحديد اسم مجموعة افتراضي عند تهيئة Admin SDK. ثم يمكنك استرداد مرجع مصدق عليه لهذه المجموعة. يجب ألا يحتوي اسم الحاوية على gs:// أو أي بادئات بروتوكول أخرى. على سبيل المثال ، إذا كان عنوان URL gs://bucket-name.appspot.com المعروض في Firebase Console هو gs://bucket-name.appspot.com ، bucket-name.appspot.com سلسلة bucket-name.appspot.com إلى Admin SDK.

Node.js

var admin = require("firebase-admin");

var serviceAccount = require("path/to/serviceAccountKey.json");

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

var bucket = admin.storage().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.

يمكنك استخدام مراجع الحاوية التي تم إرجاعها بواسطة Admin SDK جنبًا إلى جنب مع مكتبات عميل Google Cloud Storage الرسمية لتحميل وتنزيل وتعديل المحتوى في الحاويات المرتبطة بمشاريع Firebase الخاصة بك. لاحظ أنه ليس عليك مصادقة مكتبات Google Cloud Storage عند استخدام Firebase Admin SDK. تمت مصادقة مراجع الحاوية التي تم إرجاعها بواسطة Admin SDK بالفعل باستخدام بيانات الاعتماد المستخدمة لتهيئة تطبيق Firebase.

استخدم دلاء مخصصة

إذا كنت تريد استخدام حاوية تخزين غير الافتراضية المذكورة أعلاه ، أو استخدام مجموعات تخزين متعددة في تطبيق واحد ، يمكنك استرداد مرجع إلى حاوية مخصصة كما هو موضح أدناه:

Node.js

var bucket = admin.storage().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")

استخدم تطبيق Firebase المخصص

إذا كنت تقوم بإنشاء تطبيق أكثر تعقيدًا يتفاعل مع العديد من تطبيقات Firebase ، فيمكنك الوصول إلى حاويات التخزين المرتبطة بتطبيق Firebase معين على النحو التالي:

Node.js

var bucket = customApp.storage().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")

مكتبات عميل Google Cloud Storage

تعتمد Firebase Admin SDK على مكتبات عميل Google Cloud Storage لتوفير الوصول إلى Cloud Storage. مراجع الحاوية التي تم إرجاعها بواسطة Admin SDK هي كائنات محددة في هذه المكتبات. يرجى الرجوع إلى الوثائق ومراجع API الخاصة بمكتبات عميل Google Cloud Storage لمعرفة كيفية استخدام مراجع الحاوية التي تم إرجاعها في حالات الاستخدام مثل تحميل الملفات وتنزيلها .