Method: projects.addGoogleAnalytics

Łączy określony FirebaseProject z istniejącym kontem Google Analytics .

Korzystając z tego połączenia, możesz:

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

Pamiętaj, że gdy wywołujesz projects.addGoogleAnalytics :

  1. Pierwsza kontrola określa, czy istniejące strumienie danych w usłudze Google Analytics odpowiadają jakimkolwiek istniejącym aplikacjom Firebase w FirebaseProject (na podstawie packageName lub bundleId powiązanego ze strumieniem danych). Następnie, jeśli ma to zastosowanie, strumienie danych i aplikacje są łączone. Należy pamiętać, że to automatyczne łączenie dotyczy tylko aplikacji AndroidApps i IosApps .
  2. Jeśli nie zostaną znalezione odpowiednie strumienie danych dla aplikacji Firebase, w usłudze Google Analytics zostaną udostępnione nowe strumienie danych dla każdej aplikacji Firebase. Pamiętaj, że dla aplikacji internetowej zawsze jest udostępniany nowy strumień danych, nawet jeśli był wcześniej powiązany ze strumieniem danych w usłudze Analytics.

Więcej informacji na temat hierarchii i struktury kont Google Analytics znajdziesz w dokumentacji Analytics .

Wynikiem tego wywołania jest Operation . Odpytuj Operation , aby śledzić proces udostępniania, wywołując operations.get , dopóki done true . Jeśli done ma true , Operation zakończyła się sukcesem lub niepowodzeniem. Jeśli Operation się powiodła, jej response jest ustawiona na AnalyticsDetails ; jeśli Operation nie powiodła się, jej error jest ustawiany na google.rpc.Status .

Aby wywołać projects.addGoogleAnalytics , członek projektu musi być właścicielem istniejącego FirebaseProject i mieć uprawnienia do Edit na koncie Google Analytics.

Jeśli w FirebaseProject jest już włączona usługa Google Analytics i wywołasz metodę projects.addGoogleAnalytics przy użyciu analyticsPropertyId innego niż aktualnie powiązana usługa, wywołanie zakończy się niepowodzeniem. Analiza mogła być już włączona w konsoli Firebase lub przez określenie timeZone i regionCode w wywołaniu 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 FirebaseProject , który ma zostać połączony z istniejącym kontem Google Analytics, w formacie:

projects/ PROJECT_IDENTIFIER

Szczegółowe informacje na temat wartości PROJECT_IDENTIFIER można znaleźć w polu name FirebaseProject .

Treść żądania

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

Reprezentacja 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
analytics_resource Unii .

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


analytics_resource może mieć tylko jedną z następujących wartości:
analyticsAccountId

string

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

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

analyticsPropertyId

string

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

Treść odpowiedzi

Jeśli się powiedzie, treść odpowiedzi zawiera instancję Operation .

Zakresy autoryzacji

Wymaga jednego z następujących zakresów OAuth:

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

Aby uzyskać więcej informacji, zobacz Omówienie uwierzytelniania .