Method: projects.addGoogleAnalytics

Collega il FirebaseProject specificato a un account Google Analytics esistente.

Usando questa chiamata puoi:

  • Specifica un analyticsAccountId per eseguire il provisioning di una nuova proprietà Google Analytics all'interno dell'account specificato e associare la nuova proprietà a FirebaseProject .
  • Specifica un analyticsPropertyId esistente per associare la proprietà a FirebaseProject .

Tieni presente che quando chiami projects.addGoogleAnalytics :

  1. Il primo controllo determina se eventuali flussi di dati esistenti nella proprietà Google Analytics corrispondono a eventuali app Firebase esistenti in FirebaseProject (in base al packageName o bundleId associato al flusso di dati). Quindi, se applicabile, i flussi di dati e le app vengono collegati. Tieni presente che questo collegamento automatico si applica solo ad AndroidApps e IosApps .
  2. Se non vengono trovati flussi di dati corrispondenti per le app Firebase, viene eseguito il provisioning di nuovi flussi di dati nella proprietà Google Analytics per ciascuna delle app Firebase. Tieni presente che viene sempre eseguito il provisioning di un nuovo flusso di dati per un'app Web anche se era precedentemente associato a un flusso di dati nella proprietà Analytics.

Ulteriori informazioni sulla gerarchia e sulla struttura degli account Google Analytics nella documentazione di Analytics .

Il risultato di questa chiamata è Operation . Eseguire il polling Operation per tenere traccia del processo di provisioning chiamando operations.get finché done risulta true . Quando done è true , l' Operation è riuscita o è fallita. Se l' Operation ha avuto successo, la sua response è impostata su AnalyticsDetails ; se l' Operation fallisce, il suo error viene impostato su google.rpc.Status .

Per chiamare projects.addGoogleAnalytics , un membro del progetto deve essere un proprietario del FirebaseProject esistente e disporre dell'autorizzazione Edit per l'account Google Analytics.

Se FirebaseProject ha già Google Analytics abilitato e chiami projects.addGoogleAnalytics utilizzando un analyticsPropertyId diverso dalla proprietà attualmente associata, la chiamata avrà esito negativo. L'analisi potrebbe essere già stata abilitata nella console Firebase o specificando timeZone e regionCode nella chiamata a projects.addFirebase .

Richiesta HTTP

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

L'URL usa la sintassi di transcodifica gRPC .

Parametri del percorso

Parametri
parent

string

Il nome della risorsa FirebaseProject da collegare a un account Google Analytics esistente, nel formato:

projects/ PROJECT_IDENTIFIER

Fare riferimento al campo name FirebaseProject per dettagli sui valori PROJECT_IDENTIFIER .

Richiedi corpo

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione 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.
}
Campi
Campo unione analytics_resource .

È possibile specificare una sola risorsa Google Analytics nel corpo della richiesta.
  • Per eseguire il provisioning di una nuova proprietà Google Analytics e associarla a FirebaseProject , fornisci analyticsAccountId .
  • Per associare una proprietà Google Analytics esistente a FirebaseProject , fornisci analyticsPropertyId .


analytics_resource può essere solo uno dei seguenti:
analyticsAccountId

string

L'ID dell'account Google Analytics esistente che desideri collegare a FirebaseProject .

Se specifichi questo campo verrà fornita una nuova proprietà Google Analytics nel tuo account Google Analytics e verrà associata la nuova proprietà a FirebaseProject .

analyticsPropertyId

string

L'ID della proprietà Google Analytics esistente che desideri associare a FirebaseProject .

Corpo della risposta

In caso di esito positivo, il corpo della risposta contiene un'istanza di Operation .

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, vedere la panoramica sull'autenticazione .