Method: projects.addGoogleAnalytics

Verknüpft das angegebene FirebaseProject mit einem vorhandenen Google Analytics-Konto .

Mit diesem Aufruf können Sie entweder:

  • Geben Sie eine analyticsAccountId an, um eine neue Google Analytics-Property innerhalb des angegebenen Kontos bereitzustellen und die neue Property mit dem FirebaseProject zu verknüpfen.
  • Geben Sie eine vorhandene analyticsPropertyId an, um die Eigenschaft dem FirebaseProject zuzuordnen.

Beachten Sie Folgendes, wenn Sie projects.addGoogleAnalytics aufrufen:

  1. Bei der ersten Prüfung wird ermittelt, ob vorhandene Datenströme in der Google Analytics-Eigenschaft vorhandenen Firebase-Apps im FirebaseProject entsprechen (basierend auf dem packageName oder bundleId die dem Datenstrom zugeordnet sind). Anschließend werden ggf. die Datenströme und Apps verknüpft. Beachten Sie, dass diese automatische Verknüpfung nur für AndroidApps und IosApps gilt.
  2. Wenn für die Firebase-Apps keine entsprechenden Datenströme gefunden werden, werden in der Google Analytics-Property für jede der Firebase-Apps neue Datenströme bereitgestellt. Beachten Sie, dass ein neuer Datenstrom immer für eine Web-App bereitgestellt wird, auch wenn er zuvor mit einem Datenstrom in der Analytics-Eigenschaft verknüpft war.

Weitere Informationen zur Hierarchie und Struktur von Google Analytics-Konten finden Sie in der Analytics-Dokumentation .

Das Ergebnis dieses Aufrufs ist eine Operation . Fragen Sie den Operation ab, um den Bereitstellungsprozess zu verfolgen, indem Sie operations.get aufrufen, bis done den Wert „ true hat. Wenn done den true hat, war der Operation entweder erfolgreich oder fehlgeschlagen. Wenn der Operation erfolgreich war, wird seine response auf AnalyticsDetails festgelegt. Wenn der Operation fehlgeschlagen ist, wird der error auf google.rpc.Status gesetzt.

Um projects.addGoogleAnalytics aufzurufen, muss ein Projektmitglied Eigentümer des vorhandenen FirebaseProject sein und über die Edit für das Google Analytics-Konto verfügen.

Wenn für das FirebaseProject Google Analytics bereits aktiviert ist und Sie projects.addGoogleAnalytics mit einer analyticsPropertyId aufrufen, die sich von der aktuell zugeordneten Eigenschaft unterscheidet, schlägt der Aufruf fehl. Analytics wurde möglicherweise bereits in der Firebase-Konsole oder durch Angabe von timeZone und regionCode im Aufruf von projects.addFirebase aktiviert.

HTTP-Anfrage

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

Die URL verwendet die gRPC-Transcoding -Syntax.

Pfadparameter

Parameter
parent

string

Der Ressourcenname des FirebaseProject zur Verknüpfung mit einem vorhandenen Google Analytics-Konto im Format:

projects/ PROJECT_IDENTIFIER

Einzelheiten zu PROJECT_IDENTIFIER Werten finden Sie im name FirebaseProject .

Anforderungstext

Der Anfragetext enthält Daten mit folgender Struktur:

JSON-Darstellung
{

  // 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.
}
Felder
Union-Feld analytics_resource .

Im Anfragetext kann nur eine Google Analytics-Ressource angegeben werden.
  • Um eine neue Google Analytics-Eigenschaft bereitzustellen und sie mit dem FirebaseProject zu verknüpfen, geben Sie analyticsAccountId an.
  • Um eine vorhandene Google Analytics-Property mit dem FirebaseProject zu verknüpfen, geben Sie analyticsPropertyId an.


analytics_resource kann nur einer der folgenden Werte sein:
analyticsAccountId

string

Die ID für das vorhandene Google Analytics-Konto , das Sie mit dem FirebaseProject verknüpfen möchten.

Wenn Sie dieses Feld angeben, wird eine neue Google Analytics-Property in Ihrem Google Analytics-Konto bereitgestellt und die neue Property mit dem FirebaseProject verknüpft.

analyticsPropertyId

string

Die ID für die vorhandene Google Analytics-Property, die Sie dem FirebaseProject zuordnen möchten.

Antwortkörper

Bei Erfolg enthält der Antworttext eine Instanz von Operation .

Autorisierungsbereiche

Erfordert einen der folgenden OAuth-Bereiche:

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

Weitere Informationen finden Sie in der Authentifizierungsübersicht .