ウェブで使ってみる

Cloud Storage for Firebase を使用して画像や動画などのユーザー作成コンテンツをアップロードして共有し、リッチメディアコンテンツをアプリに組み込むことができます。データは Google Cloud Storage バケットに格納されます。これはエクサバイトスケールのオブジェクトストレージソリューションで、高い可用性とグローバルな冗長性を備えています。Cloud Storage を使うと、モバイルデバイスやウェブブラウザから直接ファイルを安全にアップロードでき、不安定なネットワークも簡単に扱うことができます。

前提条件

アプリに Firebase SDK を追加して構成します。

デフォルトの Storage バケットを作成する

Firebase コンソールのナビゲーションパネルで [Storage] を選択し、[スタートガイド] をクリックします。
セキュリティルールを使用した Storage データの保護に関するメッセージを確認します。開発時に公開アクセスルールの設定を考慮してください。
デフォルトの Storage バケットのロケーションを選択します。
- このロケーション設定が、プロジェクトのデフォルトの Google Cloud Platform（GCP）リソースロケーションになります。このロケーションは、プロジェクト内のロケーション設定が必要な GCP サービスで使用されます。具体例としては、Cloud Firestore データベースや App Engine アプリ（Cloud Scheduler を使用する場合に必要）などがあります。
- ロケーションを選択できない場合は、プロジェクトにデフォルトの GCP リソースロケーションがすでに設定されています。このロケーションは、プロジェクトの作成時か、ロケーション設定を必要とする別のサービスの設定時に設定されたものです。
Blaze プランをご利用の場合は、それぞれ独自のロケーションを使用する複数のバケットを作成できます。

警告: プロジェクトのデフォルトの GCP リソースロケーションをいったん設定すると、変更することはできません。
[完了] をクリックします。

公開アクセスの設定

Cloud Storage for Firebase には宣言型のルール言語が用意されているため、データの構造化、インデックスの作成方法、データの書き込みと読み取りのタイミングを定義できます。認証ユーザーのみがデータの読み取りと書き込みを行えるように、Storage への読み書きアクセスはデフォルトで制限されています。Authentication を設定せずに開始するには、公開アクセスルールを構成します。

この場合、アプリを使用しない人を含むあらゆる人々に Storage が公開されるため、認証を設定するときに必ず Storage へのアクセス制限を再設定してください。

Cloud Storage を設定する

バケットを Firebase SDK の構成に追加する必要があります。

そのためには Storage バケット URL が必要です。これは、Firebase コンソールの [Storage] ページの [ファイル] タブにあるファイルビューアに見出しとして表示されています。この URL を確認したら、config オブジェクトに storageBucket 属性を追加します。

  // Set the configuration for your app
  // TODO: Replace with your project's config object
  var config = {
    apiKey: '<your-api-key>',
    authDomain: '<your-auth-domain>',
    databaseURL: '<your-database-url>',
    storageBucket: '<your-storage-bucket>'
  };
  firebase.initializeApp(config);

  // Get a reference to the storage service, which is used to create references in your storage bucket
  var storage = firebase.storage();

これで Cloud Storage が使えるようになりました。

まず、Cloud Storage 参照を作成する方法を学びましょう。

高度な設定

次のようないくつかの使用例では、追加の設定が必要です。

複数のリージョンでストレージバケットを使用する
さまざまなストレージクラスでストレージバケットを使用する
複数の認証ユーザーが同一アプリ内でストレージバケットを使用する

最初の使用例は、ユーザーが世界中に存在し、それぞれのユーザーの近くにデータを保存したい場合に最適です。たとえば、レイテンシを短縮するため、米国、ヨーロッパ、アジアの各リージョンでバケットを作成して、各リージョンのユーザーのデータをそこに保存するといったことができます。

2 番目の使用例は、アクセスパターンの異なるデータがある場合に役立ちます。たとえば、写真など、頻繁にアクセスされるコンテンツを格納するためにはマルチリージョンまたはリージョンバケットを、ユーザーバックアップなど、アクセス頻度の低いコンテンツを格納するためには Nearline または Coldline バケットをそれぞれ設定できます。

上記のどちらの場合も、複数のストレージバケットを使用します。

3 番目の使用例は、Google ドライブのような、ユーザーが複数のログインアカウント（個人用アカウントや仕事用アカウントなど）を持つことができるアプリを作成する場合に役立ちます。カスタムの Firebase アプリインスタンスを使用して、追加の各アカウントを認証できます。

複数のストレージバケットを使用する

上記で提供されているデフォルト以外のストレージバケットを使用する場合、または単一のアプリで複数のストレージバケットを使用する場合は、カスタムバケットを参照する firebase.storage のインスタンスを作成できます。

// Get a non-default Storage bucket
var storage = firebase.app().storage("gs://my-custom-bucket");

インポートされたバケットの操作

既存の Cloud Storage バケットを Firebase にインポートする場合は、Google Cloud SDK に含まれている gsutil ツールを使用して、Firebase からファイルにアクセスできるようにする必要があります。

gsutil -m acl ch -r -u firebase-storage@system.gserviceaccount.com:O gs://<your-cloud-storage-bucket>

これは、新しく作成されるバケットには影響しません。新しく作成されるバケットには、Firebase を許可するデフォルトのアクセス制御が設定されます。これは一時的な措置であり、将来は自動的に行われるようになります。

カスタムの Firebase App を使用する

カスタムの firebase.app.App を使用して複雑なアプリを作成する場合は、そのアプリで初期化された firebase.storage.Storage のインスタンスを作成できます。

// Get the default bucket from a custom firebase.app.App
var storage = customApp.storage();

// Get a non-default bucket from a custom firebase.app.App
var storage = customApp.storage("gs://my-custom-bucket");