Method: projects.addGoogleAnalytics

Связывает указанный FirebaseProject с существующей учетной записью Google Analytics .

Используя этот вызов, вы можете:

  • Укажите analyticsAccountId , чтобы предоставить новое свойство Google Analytics в указанной учетной записи и связать новое свойство с FirebaseProject .
  • Укажите существующий analyticsPropertyId , чтобы связать свойство с FirebaseProject .

Обратите внимание: когда вы вызываете projects.addGoogleAnalytics :

  1. Первая проверка определяет, соответствуют ли какие-либо существующие потоки данных в свойстве Google Analytics каким-либо существующим приложениям Firebase в FirebaseProject (на основе packageName или bundleId , связанного с потоком данных). Затем, если применимо, потоки данных и приложения связываются. Обратите внимание, что это автоматическое связывание применимо только к AndroidApps и IosApps .
  2. Если соответствующие потоки данных для приложений Firebase не найдены, новые потоки данных предоставляются в свойстве Google Analytics для каждого из приложений Firebase. Обратите внимание, что новый поток данных всегда подготавливается для веб-приложения, даже если он ранее был связан с потоком данных в свойстве Analytics.

Подробнее об иерархии и структуре аккаунтов Google Analytics читайте в документации Analytics .

Результатом этого вызова является Operation . Опрашивайте Operation , чтобы отслеживать процесс подготовки, вызывая operations.get до тех пор, пока done не станет true . Если done равно true , Operation либо завершилась успешно, либо не удалась. Если Operation завершилась успешно, ее response будет присвоено значение AnalyticsDetails ; если Operation завершилась неудачно, ее error присваивается значение google.rpc.Status .

Чтобы вызвать projects.addGoogleAnalytics , участник проекта должен быть владельцем существующего FirebaseProject и иметь разрешение на Edit учетной записи Google Analytics.

Если в FirebaseProject уже включена Google Analytics, и вы вызываете projects.addGoogleAnalytics , используя analyticsPropertyId , который отличается от текущего связанного свойства, вызов завершится неудачно. Возможно, аналитика уже включена в консоли Firebase или путем указания timeZone и regionCode при вызове projects.addFirebase .

HTTP-запрос

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

URL-адрес использует синтаксис транскодирования gRPC .

Параметры пути

Параметры
parent

string

Имя ресурса FirebaseProject для связи с существующей учетной записью Google Analytics в формате:

projects/ PROJECT_IDENTIFIER

Подробную информацию о значениях PROJECT_IDENTIFIER см. в поле name FirebaseProject .

Тело запроса

Тело запроса содержит данные следующей структуры:

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.
}
Поля
Объединение полей analytics_resource .

В теле запроса можно указать только один ресурс Google Analytics.
  • Чтобы предоставить новый ресурс Google Analytics и связать его с FirebaseProject , укажите analyticsAccountId .
  • Чтобы связать существующий ресурс Google Analytics с FirebaseProject , укажите analyticsPropertyId .


analytics_resource может быть только одним из следующих:
analyticsAccountId

string

Идентификатор существующей учетной записи Google Analytics , которую вы хотите связать с FirebaseProject .

При указании этого поля будет предоставлен новый ресурс Google Analytics в вашей учетной записи Google Analytics и свяжется новый ресурс с FirebaseProject .

analyticsPropertyId

string

Идентификатор существующего ресурса Google Analytics, который вы хотите связать с FirebaseProject .

Тело ответа

В случае успеха тело ответа содержит экземпляр Operation .

Области авторизации

Требуется одна из следующих областей OAuth:

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

Для получения дополнительной информации см. Обзор аутентификации .