Method: projects.addGoogleAnalytics

Łączy konto FirebaseProject z istniejącym kontem Google Analytics.

Podczas tego połączenia możesz:

  • Określ analyticsAccountId, aby udostępnić nową usługę w Google Analytics na określonym koncie i powiązać ją z usługą FirebaseProject.
  • Określ istniejący element analyticsPropertyId, aby powiązać usługę z usługą FirebaseProject.

Pamiętaj, że gdy dzwonisz pod numer projects.addGoogleAnalytics:

  1. Pierwsze sprawdzenie pozwala ustalić, czy jakiekolwiek strumienie danych w usłudze w Google Analytics odpowiadają istniejącym aplikacjom Firebase w FirebaseProject (na podstawie danych packageName lub bundleId powiązanych ze strumieniem danych). Następnie, w zależności od sytuacji, strumienie danych i aplikacje są łączone. Pamiętaj, że to automatyczne łączenie ma zastosowanie tylko do sieci AndroidApps i IosApps.
  2. Jeśli dla aplikacji Firebase nie ma odpowiednich strumieni danych, dla każdej z nich zostaną udostępnione w usłudze w Google Analytics nowe strumienie danych. Pamiętaj, że dla aplikacji internetowej jest zawsze udostępniany nowy strumień danych, nawet jeśli był on wcześniej powiązany ze strumieniem danych w usłudze w Analytics.

Więcej informacji o hierarchii i strukturze kont Google Analytics znajdziesz w dokumentacji Analytics.

Wynik tego wywołania to Operation. Wyślij ankietę do Operation, aby śledzić proces obsługi administracyjnej, dzwoniąc pod numer operations.get do czasu, aż done będzie true. Gdy done ma wartość true, Operation jest albo zakończyło się powodzeniem lub niepowodzeniem. Jeśli zasada Operation jest poprawna, jej response ma wartość AnalyticsDetails; Jeśli nie udało się wykonać polecenia Operation, jego error ma wartość google.rpc.Status.

Aby można było wywołać funkcję projects.addGoogleAnalytics, członek projektu musi być właścicielem istniejącego elementu FirebaseProject i mieć uprawnienie Edit na koncie Google Analytics.

Jeśli w usłudze FirebaseProject jest już włączona usługa Google Analytics, a wywołanie projects.addGoogleAnalytics za pomocą usługi analyticsPropertyId, która jest inna niż w przypadku aktualnie powiązanej usługi, wywołanie się nie powiedzie. Usługa Analytics mogła być już włączona w konsoli Firebase lub przez określenie właściwości timeZone i regionCode w wywołaniu funkcji projects.addFirebase.

Żądanie HTTP

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

Adres URL używa składni transkodowania gRPC.

Parametry ścieżki

Parametry
parent

string

Nazwa zasobu typu FirebaseProject, który ma zostać połączony z istniejącym kontem Google Analytics, w formacie:

projects/PROJECT_IDENTIFIER

Szczegółowe informacje o wartościach PROJECT_IDENTIFIER znajdziesz w polu FirebaseProject name.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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.
}
Pola
Pole sumy analytics_resource.

W treści żądania można określić tylko jeden zasób Google Analytics.
  • Aby udostępnić nową usługę w Google Analytics i powiązać ją z kontem FirebaseProject, podaj te dane: analyticsAccountId.
  • Aby powiązać dotychczasową usługę w Google Analytics z kontem FirebaseProject, podaj: analyticsPropertyId.


analytics_resource może mieć tylko jedną z tych wartości:
analyticsAccountId

string

Identyfikator konta Google Analytics, które chcesz połączyć z kontem FirebaseProject.

Określenie tego pola spowoduje udostępnienie na koncie Google Analytics nowej usługi Google Analytics i powiązanie jej z usługą FirebaseProject.
analyticsPropertyId

string

Identyfikator istniejącej usługi w Google Analytics, którą chcesz powiązać z usługą FirebaseProject.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała instancję Operation.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

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

Więcej informacji znajdziesz w artykule o uwierzytelnianiu (w języku angielskim).