Method: projects.addGoogleAnalytics

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

Con esta llamada, puede:

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

Tenga en cuenta que cuando llama projects.addGoogleAnalytics :

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

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

El resultado de esta llamada es una Operation . Sondee la Operation para realizar un seguimiento del proceso de aprovisionamiento llamando operations.get hasta que done sea true . Cuando done es true , la Operation tuvo éxito o fracasó. Si la Operation tuvo éxito, su response se establece en AnalyticsDetails ; Si la 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 permiso Edit para la cuenta de Google Analytics.

Si FirebaseProject ya tiene Google Analytics habilitado y llama a projects.addGoogleAnalytics usando 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 especificando timeZone y regionCode en la llamada a projects.addFirebase .

solicitud HTTP

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

La URL utiliza la sintaxis de transcodificación gRPC .

Parámetros de ruta

Parámetros
parent

string

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

projects/ PROJECT_IDENTIFIER

Consulte el campo name FirebaseProject 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
analytics_resource del campo de unión .

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 FirebaseProject , proporcione analyticsAccountId .
  • Para asociar una propiedad de Google Analytics existente con FirebaseProject , proporcione analyticsPropertyId .


analytics_resource puede ser solo uno de los siguientes:
analyticsAccountId

string

El ID de la cuenta de Google Analytics existente que desea vincular con FirebaseProject .

Al especificar este campo, se proporcionará una nueva propiedad de Google Analytics en su cuenta de Google Analytics y se asociará la nueva propiedad con FirebaseProject .

analyticsPropertyId

string

El ID de la propiedad de Google Analytics existente que desea asociar con FirebaseProject .

Cuerpo de respuesta

Si tiene éxito, el cuerpo de la respuesta contiene una instancia de Operation .

Alcances de autorización

Requiere uno de los siguientes ámbitos de OAuth:

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

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