Method: projects.addGoogleAnalytics

Vincula o FirebaseProject especificado a uma conta existente do Google Analytics .

Usando esta chamada, você pode:

  • Especifique um analyticsAccountId para provisionar uma nova propriedade do Google Analytics na conta especificada e associe a nova propriedade ao FirebaseProject .
  • Especifique um analyticsPropertyId existente para associar a propriedade ao FirebaseProject .

Observe que quando você chama projects.addGoogleAnalytics :

  1. A primeira verificação determina se algum fluxo de dados existente na propriedade do Google Analytics corresponde a algum aplicativo Firebase existente no FirebaseProject (com base no packageName ou bundleId associado ao fluxo de dados). Então, conforme aplicável, os fluxos de dados e aplicativos são vinculados. Observe que essa vinculação automática se aplica apenas a AndroidApps e IosApps .
  2. Se nenhum fluxo de dados correspondente for encontrado para os aplicativos Firebase, novos fluxos de dados serão provisionados na propriedade do Google Analytics para cada um dos aplicativos Firebase. Observe que um novo fluxo de dados é sempre provisionado para um aplicativo Web, mesmo que tenha sido associado anteriormente a um fluxo de dados na propriedade Analytics.

Saiba mais sobre a hierarquia e a estrutura das contas do Google Analytics na documentação do Analytics.

O resultado dessa chamada é uma Operation . Pesquise a Operation para rastrear o processo de provisionamento chamando operations.get até que o done seja true . Quando done for true , a Operation foi bem-sucedida ou falhou. Se a Operation for bem-sucedida, sua response será definida como AnalyticsDetails ; se a Operation falhou, seu error é definido como google.rpc.Status .

Para chamar projects.addGoogleAnalytics , um membro do projeto deve ser proprietário do FirebaseProject existente e ter permissão de Edit para a conta do Google Analytics.

Se o FirebaseProject já tiver o Google Analytics ativado e você chamar projects.addGoogleAnalytics usando um analyticsPropertyId diferente da propriedade atualmente associada, a chamada falhará. O Analytics pode já ter sido ativado no console do Firebase ou especificando timeZone e regionCode na chamada para projects.addFirebase .

solicitação HTTP

POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics

A URL usa a sintaxe de transcodificação gRPC .

Parâmetros de caminho

Parâmetros
parent

string

O nome do recurso do FirebaseProject para vincular a uma conta existente do Google Analytics, no formato:

projects/ PROJECT_IDENTIFIER

Consulte o campo FirebaseProject name para obter detalhes sobre os valores PROJECT_IDENTIFIER .

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

representação JSON
{

  // Union field analytics_resource can be only one of the following:
  "analyticsAccountId": string,
  "analyticsPropertyId": string
  // End of list of possible types for union field analytics_resource.
}
Campos
Campo de união analytics_resource .

Apenas um recurso do Google Analytics pode ser especificado no corpo da solicitação.
  • Para provisionar uma nova propriedade do Google Analytics e associá-la ao FirebaseProject , forneça analyticsAccountId .
  • Para associar uma propriedade existente do Google Analytics ao FirebaseProject , forneça analyticsPropertyId .


analytics_resource pode ser apenas um dos seguintes:
analyticsAccountId

string

O ID da conta existente do Google Analytics que você deseja vincular ao FirebaseProject .

A especificação desse campo provisionará uma nova propriedade do Google Analytics em sua conta do Google Analytics e associará a nova propriedade ao FirebaseProject .

analyticsPropertyId

string

O ID da propriedade existente do Google Analytics que você deseja associar ao FirebaseProject .

corpo da resposta

Se for bem-sucedido, o corpo da resposta conterá uma instância de Operation .

Escopos de autorização

Requer um dos seguintes escopos OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

Para obter mais informações, consulte Visão geral da autenticação .

,

Vincula o FirebaseProject especificado a uma conta existente do Google Analytics .

Usando esta chamada, você pode:

  • Especifique um analyticsAccountId para provisionar uma nova propriedade do Google Analytics na conta especificada e associe a nova propriedade ao FirebaseProject .
  • Especifique um analyticsPropertyId existente para associar a propriedade ao FirebaseProject .

Observe que quando você chama projects.addGoogleAnalytics :

  1. A primeira verificação determina se algum fluxo de dados existente na propriedade do Google Analytics corresponde a algum aplicativo Firebase existente no FirebaseProject (com base no packageName ou bundleId associado ao fluxo de dados). Então, conforme aplicável, os fluxos de dados e aplicativos são vinculados. Observe que essa vinculação automática se aplica apenas a AndroidApps e IosApps .
  2. Se nenhum fluxo de dados correspondente for encontrado para os aplicativos Firebase, novos fluxos de dados serão provisionados na propriedade do Google Analytics para cada um dos aplicativos Firebase. Observe que um novo fluxo de dados é sempre provisionado para um aplicativo Web, mesmo que tenha sido associado anteriormente a um fluxo de dados na propriedade Analytics.

Saiba mais sobre a hierarquia e a estrutura das contas do Google Analytics na documentação do Analytics.

O resultado dessa chamada é uma Operation . Pesquise a Operation para rastrear o processo de provisionamento chamando operations.get até que o done seja true . Quando done for true , a Operation foi bem-sucedida ou falhou. Se a Operation for bem-sucedida, sua response será definida como AnalyticsDetails ; se a Operation falhou, seu error é definido como google.rpc.Status .

Para chamar projects.addGoogleAnalytics , um membro do projeto deve ser proprietário do FirebaseProject existente e ter permissão de Edit para a conta do Google Analytics.

Se o FirebaseProject já tiver o Google Analytics ativado e você chamar projects.addGoogleAnalytics usando um analyticsPropertyId diferente da propriedade atualmente associada, a chamada falhará. O Analytics pode já ter sido ativado no console do Firebase ou especificando timeZone e regionCode na chamada para projects.addFirebase .

solicitação HTTP

POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics

A URL usa a sintaxe de transcodificação gRPC .

Parâmetros de caminho

Parâmetros
parent

string

O nome do recurso do FirebaseProject para vincular a uma conta existente do Google Analytics, no formato:

projects/ PROJECT_IDENTIFIER

Consulte o campo FirebaseProject name para obter detalhes sobre os valores PROJECT_IDENTIFIER .

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

representação JSON
{

  // Union field analytics_resource can be only one of the following:
  "analyticsAccountId": string,
  "analyticsPropertyId": string
  // End of list of possible types for union field analytics_resource.
}
Campos
Campo de união analytics_resource .

Apenas um recurso do Google Analytics pode ser especificado no corpo da solicitação.
  • Para provisionar uma nova propriedade do Google Analytics e associá-la ao FirebaseProject , forneça analyticsAccountId .
  • Para associar uma propriedade existente do Google Analytics ao FirebaseProject , forneça analyticsPropertyId .


analytics_resource pode ser apenas um dos seguintes:
analyticsAccountId

string

O ID da conta existente do Google Analytics que você deseja vincular ao FirebaseProject .

A especificação desse campo provisionará uma nova propriedade do Google Analytics em sua conta do Google Analytics e associará a nova propriedade ao FirebaseProject .

analyticsPropertyId

string

O ID da propriedade existente do Google Analytics que você deseja associar ao FirebaseProject .

corpo da resposta

Se for bem-sucedido, o corpo da resposta conterá uma instância de Operation .

Escopos de autorização

Requer um dos seguintes escopos OAuth:

  • https://www.googleapis.com/auth/cloud-platform
  • https://www.googleapis.com/auth/firebase

Para obter mais informações, consulte Visão geral da autenticação .