Method: projects.addGoogleAnalytics

Vincula el FirebaseProject especificado con una cuenta de Google Analytics existente.

Con esta llamada, puedes hacer lo siguiente:

  • Especifica un analyticsAccountId para aprovisionar una nueva propiedad de Google Analytics en la cuenta especificada y asociar la nueva propiedad con el FirebaseProject.
  • Especifica un analyticsPropertyId existente para asociar la propiedad con el FirebaseProject.

Ten en cuenta que, cuando llamas a projects.addGoogleAnalytics, sucede lo siguiente:

  1. La primera verificación determina si algún flujo de datos existente en la propiedad de Google Analytics corresponde a alguna app de Firebase existente en FirebaseProject (en función de packageName o bundleId asociados con el flujo de datos). Luego, según corresponda, se vincularán los flujos de datos y las aplicaciones. Ten en cuenta que esta vinculación automática solo se aplica a AndroidApps y IosApps.
  2. Si no se encuentran flujos de datos correspondientes a las aplicaciones de Firebase, se aprovisionan flujos de datos nuevos en la propiedad de Google Analytics para cada una de las aplicaciones de Firebase. Ten en cuenta que siempre se aprovisiona un flujo de datos nuevo a una aplicación web, incluso si antes se asoció con un flujo de datos en la propiedad de Analytics.

Obtén más información sobre la jerarquía y la estructura de las cuentas de Google Analytics en la documentación de Analytics.

El resultado de esta llamada es una Operation. Sondea el Operation para hacer un seguimiento del proceso de aprovisionamiento. Para ello, llama a operations.get hasta que done sea true. Cuando done es true, Operation se completó correctamente o falló. Si la Operation se ejecuta correctamente, su response se establece en AnalyticsDetails. Si Operation falla, su error se establece en google.rpc.Status.

Para llamar a projects.addGoogleAnalytics, un miembro del proyecto debe ser propietario del FirebaseProject existente y tener el permiso Edit para la cuenta de Google Analytics.

Si el FirebaseProject ya tiene habilitado Google Analytics y llamas a projects.addGoogleAnalytics con un analyticsPropertyId que es diferente de la propiedad asociada actualmente, la llamada fallará. Es posible que Analytics ya se haya habilitado en Firebase console o mediante la especificación de timeZone y regionCode en la llamada a projects.addFirebase.

Solicitud HTTP

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

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
parent

string

El nombre del recurso del FirebaseProject que se vinculará a una cuenta existente de Google Analytics, en el formato:

projects/PROJECT_IDENTIFIER

Consulta el campo FirebaseProject name para obtener detalles sobre los valores PROJECT_IDENTIFIER.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación 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ón analytics_resource.

Solo se puede especificar un recurso de Google Analytics en el cuerpo de la solicitud.
  • Para aprovisionar una nueva propiedad de Google Analytics y asociarla con el FirebaseProject, proporciona analyticsAccountId.
  • Para asociar una propiedad existente de Google Analytics con FirebaseProject, proporciona analyticsPropertyId.


analytics_resource puede ser solo una de las siguientes opciones:
analyticsAccountId

string

Es el ID de la cuenta de Google Analytics existente que deseas vincular con FirebaseProject.

Si especificas este campo, se aprovisionará una nueva propiedad de Google Analytics en tu cuenta de Google Analytics y se asociará la nueva propiedad con el FirebaseProject.
analyticsPropertyId

string

Es el ID de la propiedad existente de Google Analytics que deseas asociar con el FirebaseProject.

Cuerpo de la respuesta

Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Operation.

Alcances de autorización

Se necesita uno de los siguientes alcances de OAuth:

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

Para obtener más información, consulta Descripción general de la autenticación.