Method: projects.addGoogleAnalytics

Lie le FirebaseProject spécifié à un compte Google Analytics existant .

Grâce à cet appel, vous pouvez soit :

  • Spécifiez un analyticsAccountId pour provisionner une nouvelle propriété Google Analytics dans le compte spécifié et associer la nouvelle propriété au FirebaseProject .
  • Spécifiez un analyticsPropertyId existant pour associer la propriété au FirebaseProject .

Notez que lorsque vous projects.addGoogleAnalytics :

  1. La première vérification détermine si des flux de données existants dans la propriété Google Analytics correspondent à des applications Firebase existantes dans FirebaseProject (en fonction du packageName ou bundleId associé au flux de données). Ensuite, le cas échéant, les flux de données et les applications sont liés. Notez que cette liaison automatique s'applique uniquement aux AndroidApps et IosApps .
  2. Si aucun flux de données correspondant n'est trouvé pour les applications Firebase, de nouveaux flux de données sont fournis dans la propriété Google Analytics pour chacune des applications Firebase. Notez qu'un nouveau flux de données est toujours provisionné pour une application Web même s'il était précédemment associé à un flux de données dans la propriété Analytics.

Apprenez-en davantage sur la hiérarchie et la structure des comptes Google Analytics dans la documentation Analytics .

Le résultat de cet appel est une Operation . Interrogez l' Operation pour suivre le processus d'approvisionnement en appelant operations.get jusqu'à ce que done soit true . Lorsque done est true , l' Operation a réussi ou échoué. Si l' Operation a réussi, sa response est définie sur AnalyticsDetails ; si l' Operation a échoué, son error est définie sur google.rpc.Status .

Pour projects.addGoogleAnalytics , un membre du projet doit être propriétaire du FirebaseProject existant et disposer de l' autorisation Edit pour le compte Google Analytics.

Si Google Analytics est déjà activé FirebaseProject et que vous projects.addGoogleAnalytics à l'aide d'un analyticsPropertyId différent de la propriété actuellement associée, l'appel échouera. Les analyses ont peut-être déjà été activées dans la console Firebase ou en spécifiant timeZone et regionCode dans l'appel à projects.addFirebase .

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC .

Paramètres du chemin

Paramètres
parent

string

Nom de la ressource du FirebaseProject à associer à un compte Google Analytics existant, au format :

projects/ PROJECT_IDENTIFIER

Reportez-vous au champ name FirebaseProject pour plus de détails sur les valeurs PROJECT_IDENTIFIER .

Corps de la demande

Le corps de la requête contient des données avec la structure suivante :

Représentation 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.
}
Des champs
Union champ analytics_resource .

Une seule ressource Google Analytics peut être spécifiée dans le corps de la requête.
  • Pour provisionner une nouvelle propriété Google Analytics et l'associer au FirebaseProject , fournissez analyticsAccountId .
  • Pour associer une propriété Google Analytics existante au FirebaseProject , fournissez analyticsPropertyId .


analytics_resource ne peut être que l'un des éléments suivants :
analyticsAccountId

string

L'ID du compte Google Analytics existant que vous souhaitez associer au FirebaseProject .

La spécification de ce champ fournira une nouvelle propriété Google Analytics dans votre compte Google Analytics et associera la nouvelle propriété au FirebaseProject .

analyticsPropertyId

string

ID de la propriété Google Analytics existante que vous souhaitez associer au FirebaseProject .

Corps de réponse

En cas de succès, le corps de la réponse contient une instance de Operation .

Portées des autorisations

Nécessite l'une des étendues OAuth suivantes :

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

Pour plus d'informations, consultez la Présentation de l'authentification .