Confira as novidades do Firebase anunciadas no Google I/O 2022. Saiba mais

Configurar e gerenciar um projeto do Firebase usando a API Management REST

A API Firebase Management REST permite configurar e gerenciar projetos do Firebase de maneira programática, incluindo os recursos e apps de um projeto.

Nesta visão geral, descrevemos o fluxo de trabalho geral para adicionar recursos e apps do Firebase a um projeto do Google Cloud existente que ainda não usa serviços do Firebase.

Pule para seções específicas desta página se você quiser apenas:

adicionar serviços do Firebase ao seu projeto;
adicionar apps do Firebase ao projeto;
vincular o projeto do Firebase a uma conta do Google Analytics;

Antes de seguir qualquer etapa nesta página, verifique se você ativou a API.

Para ver informações sobre o gerenciamento de acesso da API Firebase Management, confira a documentação da API Cloud Identity Access Management (IAM).

Antes de começar

Primeiro, você precisa ativar a API Management no projeto do Google Cloud e gerar seu token de acesso.

Ative a API Management REST no seu projeto Google Cloud

Caso você ainda não tenha ativado a API Firebase Management no seu projeto do Google Cloud, será necessário fazer isso.

Abra a página da API Firebase Management no Console de APIs do Google.
Quando solicitado, selecione o projeto do Google Cloud.
Clique em Ativar na página da API Firebase Management.

Gerar seu token de acesso à API

Veja abaixo um exemplo para Node.js sobre como recuperar seu token de acesso.

Primeiro, se você não estiver usando um ambiente do Google Cloud, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS como o caminho para sua chave da conta de serviço.

Linux ou macOS

export GOOGLE_APPLICATION_CREDENTIALS="/path/to/your/service-account-file.json"

Windows

Com o PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\path\to\your\service-account-file.json"

Em seguida, use o SDK Admin do Firebase para receber um token de acesso das credenciais da sua conta de serviço:

const admin = require('firebase-admin');

function getAccessToken() {
  return admin.credential.applicationDefault().getAccessToken()
      .then(accessToken => {
        return accessToken.access_token;
      })
      .catch(err => {
        console.error('Unable to get access token');
        console.error(err);
      });
}

Encontrar o nome de recurso do seu projeto

É possível identificar os projetos Google Cloud que podem receber serviços do Firebase.

SOLICITAÇÃO

Chame availableProjects.list. O corpo da solicitação dessa chamada precisa estar vazio.

Confira um exemplo para Node.js sobre como solicitar uma lista de projetos Google Cloud disponíveis:

const fetch = require('node-fetch');

async function listProjects() {
  const accessToken = getAccessToken();
  const uri = 'https://firebase.googleapis.com/v1beta1/availableProjects';
  const options = {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer ' + accessToken,
    },
  };

  try {
    const rawResponse = await fetch(uri, options);
    const resp = await rawResponse.json();
    const projects = resp['projectInfo'];
    console.log('Project total: ' + projects.length);
    console.log('');
    for (let i in projects) {
      const project = projects[i];
      console.log('Project ' + i);
      console.log('ID: ' + project['project']);
      console.log('Display Name: ' + project['displayName']);
      console.log('');
    }
  } catch(err) {
    console.error(err);
  }
}

RESULTADO

O corpo da resposta de uma chamada para availableProjects.list contém uma lista de objetos ProjectInfo. Se a lista de projetos for muito longa, o corpo da resposta também conterá um nextPageToken que pode ser usado como um parâmetro de consulta para conseguir a próxima página de projetos.

Veja um exemplo de corpo de resposta de uma chamada para availableProjects.list:

{
  "projectInfo": [
    {
      "project": "projects/first-cloud-project",
      "displayName": "First Cloud Project"
    },
    {
      "project": "projects/second-cloud-project",
      "displayName": "Second Cloud Project"
    }
  ]
}

Essa resposta de exemplo tem dois projetos Google Cloud que podem receber serviços do Firebase. O campo project fornece o nome de recurso globalmente exclusivo de um projeto.

Use qualquer valor de project listado na resposta de availableProjects.list para adicionar serviços ou apps do Firebase ao projeto.

Na próxima seção, adicionaremos serviços do Firebase ao First Cloud Project usando o nome de recurso projects/first-gcp-project.

Adicionar serviços do Firebase ao seu projeto

Os projetos do Google Cloud podem aproveitar os serviços oferecidos pelo Firebase. Nesta seção, você vai aprender a adicionar serviços do Firebase ao seu projeto Google Cloud de maneira programática. Também é possível adicionar os serviços do Firebase ao projeto Google Cloud atual no console do Firebase.

SOLICITAÇÃO

Chame projects.addFirebase. O corpo da solicitação dessa chamada precisa estar vazio.

Confira um exemplo para Node.js sobre como adicionar serviços do Firebase ao seu projeto Google Cloud:

const fetch = require('node-fetch');

async function addFirebase(projectId) {
  const accessToken = getAccessToken();
  const uri = 'https://firebase.googleapis.com/v1beta1/projects/' + projectId + ':addFirebase';
  const options = {
    method: 'POST',
    // Use a manual access token here since explicit user access token is required.
    headers: {
      'Authorization': 'Bearer ' + accessToken,
    },
  };

  try {
    const rawResponse = await fetch(uri, options);
    const resp = await rawResponse.json();
    console.log(resp);
  } catch(err) {
    console.error(err['message']);
  }
}

RESULTADO

O resultado de uma chamada para projects.addFirebase é uma Operation. Antes de chamar para seu projeto outros endpoints relacionados ao Firebase, a operação precisa ser concluída com sucesso.

Para verificar se isso aconteceu, chame operations.get na operação até que o valor de done seja true e a response seja do tipo FirebaseProject. Se a operação falhar, o error dela será definido como google.rpc.Status.

Este é o corpo da resposta de uma chamada para operations.get:

{
  "name": "operations/...",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.firebase.service.v1beta1.FirebaseProject",
    "projectId": "first-cloud-project",
    "projectNumber": "...",
    "displayName": "First Cloud Project",
    "name": "projects/first-cloud-project",
    "resources": {
      "hostingSite": "first-cloud-project",
      "realtimeDatabaseInstance": "first-cloud-project"
    }
  }
}

Como done é true e o tipo de response é um FirebaseProject, o projeto do Google Cloud agora tem serviços do Firebase. A resposta também contém outras informações úteis sobre o FirebaseProject recém-criado, como o projectNumber e o resources padrão. A Operation será excluída automaticamente após a conclusão.

Adicionar apps do Firebase ao seu projeto

Muitos aplicativos diferentes podem usar um FirebaseProject, incluindo os para iOS, Android ou Web. Nesta seção, você aprenderá como adicionar apps do Firebase ao seu FirebaseProject de maneira programática. Também é possível fazer isso usando o Console do Firebase.

Selecione um tipo de app do Firebase para adicionar ao seu projeto.

Vincular seu projeto do Firebase a uma conta do Google Analytics (opcional)

É possível vincular uma conta do Google Analytics ao seu FirebaseProject de forma programática. Também é possível fazer isso na guia Integrações das Configurações do projeto.

A chamada para projects.addGoogleAnalytics requer um analytics_resource, que pode ser um analyticsAccountId ou um analyticsPropertyId:

Especifique um analyticsAccountId para provisionar uma nova propriedade do Google Analytics na conta especificada e associar a nova propriedade ao seu projeto do Firebase.
Especifique um analyticsPropertyId para associar a propriedade do Google Analytics ao projeto do Firebase.

É possível encontrar seu analyticsAccountId e qualquer analyticsPropertyId existente no site do Google Analytics.

Quando você chama projects.addGoogleAnalytics, isto acontece:

A primeira verificação determina se algum fluxo de dados na propriedade do Google Analytics corresponde a um app do Firebase no seu FirebaseProject (com base no packageName ou no bundleId associado ao fluxo de dados). Em seguida, os fluxos de dados e os apps são vinculados, conforme aplicável. Esse processo automático só é feito em apps Android e iOS.
Se nenhum fluxo de dados correspondente for encontrado para seus apps do Firebase, novos fluxos de dados serão provisionados na propriedade do Google Analytics para cada um dos aplicativos. Saiba que um novo fluxo de dados é sempre provisionado para um app da Web, mesmo que ele tenha sido associado anteriormente a um fluxo de dados na sua propriedade do Analytics.

Para saber mais sobre a hierarquia e a estrutura das contas do Google Analytics, acesse a documentação desse produto.

SOLICITAÇÃO

Chame projects.addGoogleAnalytics.

No corpo da solicitação da chamada de exemplo para project.addGoogleAnalytics, especificamos o analyticsAccountId da conta do Google Analytics. Essa chamada provisiona uma nova propriedade do Google Analytics e associa esse item ao FirebaseProject.

{
  "analyticsAccountId": "<your-google-analytics-account-id>"
}

Veja abaixo um exemplo para Node.js sobre como vincular um projeto do Firebase a uma conta do Google Analytics:

const fetch = require('node-fetch');

async function addGoogleAnalytics(projectId, analyticsAccountId) {
  const accessToken = getAccessToken();
  const uri = 'https://firebase.googleapis.com/v1beta1/projects/' + projectId + ':addGoogleAnalytics';
  const options = {
    method: 'POST',
    headers: {
      'Authorization': 'Bearer ' + accessToken,
    },
    body: JSON.stringify({
      'analyticsAccountId': analyticsAccountId
    }),
  };

  try {
    const rawResponse = await fetch(uri, options);
    const resp = await rawResponse.json();
    console.log(resp);
  } catch(err) {
    console.error(err['message']);
  }
}

RESULTADO

O resultado de uma chamada para projects.addGoogleAnalytics é uma Operation. Antes de chamar para seu projeto outros endpoints relacionados ao Firebase, a operação precisa ser concluída com sucesso.

Para verificar se isso aconteceu, chame operations.get na operação até que o valor de done seja true e a response seja do tipo analyticsDetails. Se a operação falhar, o error dela será definido como google.rpc.Status.

Este é o corpo da resposta de uma chamada para operations.get:

{
  "name": "operations/...",
  "none": true,
  "response": {
    "@type": "type.googleapis.com/google.firebase.service.v1beta1.AnalyticsDetails",
    "analyticsProperty": [
      {
        "id": "...",
        "displayName": "..."
      }
    ],
    "streamMappings": [
      {
        "app": "...",
        "streamId": "...",
        "measurementId": "..."
      }
    ]
  }
}

Como done é "true" e o tipo de response é analyticsDetails, o FirebaseProject agora está vinculado à conta especificada do Google Analytics. A Operation será excluída automaticamente após a conclusão.