Method: projects.addGoogleAnalytics

지정된 FirebaseProject 기존 Google Analytics 계정 과 연결합니다.

이 호출을 사용하면 다음 중 하나를 수행할 수 있습니다.

  • 지정된 계정 내에 새 Google Analytics 속성을 프로비저닝하고 새 속성을 FirebaseProject 와 연결하려면 analyticsAccountId 를 지정하세요.
  • 기존 analyticsPropertyId 지정하여 속성을 FirebaseProject 와 연결합니다.

projects.addGoogleAnalytics 호출할 때 다음 사항에 유의하세요.

  1. 첫 번째 확인에서는 Google Analytics 속성의 기존 데이터 스트림이 FirebaseProject 의 기존 Firebase 앱에 해당하는지 확인합니다(데이터 스트림과 연결된 packageName 또는 bundleId 기반). 그런 다음 해당하는 경우 데이터 스트림과 앱이 연결됩니다. 이 자동 연결은 AndroidAppsIosApps 에만 적용됩니다.
  2. Firebase 앱에 해당하는 데이터 스트림이 없으면 각 Firebase 앱의 Google Analytics 속성에 새 데이터 스트림이 프로비저닝됩니다. 이전에 Analytics 속성의 데이터 스트림과 연결되어 있던 경우에도 새 데이터 스트림은 항상 웹 앱에 대해 프로비저닝됩니다.

Analytics 문서 에서 Google Analytics 계정의 계층구조와 구조에 대해 자세히 알아보세요.

이 호출의 결과는 Operation 입니다. done true 될 때까지 operations.get 호출하여 프로비저닝 프로세스를 추적하기 위해 Operation 폴링합니다. donetrue 이면 Operation 성공했거나 실패한 것입니다. Operation 이 성공하면 해당 response AnalyticsDetails 로 설정됩니다. Operation 이 실패하면 해당 error google.rpc.Status 로 설정됩니다.

projects.addGoogleAnalytics 호출하려면 프로젝트 구성원이 기존 FirebaseProject 의 소유자여야 하며 Google Analytics 계정에 대한 Edit 권한이 있어야 합니다.

FirebaseProject 이미 Google Analytics가 활성화되어 있고 현재 연결된 속성과 다른 analyticsPropertyId 사용하여 projects.addGoogleAnalytics 호출하는 경우 호출이 실패합니다. Firebase 콘솔에서 또는 projects.addFirebase 호출 시 timeZoneregionCode 지정하여 Analytics가 이미 활성화되었을 수 있습니다.

HTTP 요청

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

URL은 gRPC 트랜스코딩 구문을 사용합니다.

경로 매개변수

매개변수
parent

string

기존 Google Analytics 계정에 연결할 FirebaseProject 의 리소스 이름으로, 형식은 다음과 같습니다.

projects/ PROJECT_IDENTIFIER

PROJECT_IDENTIFIER 값에 대한 자세한 내용은 FirebaseProject name 필드를 참조하세요.

요청 본문

요청 본문에는 다음 구조의 데이터가 포함됩니다.

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.
}
필드
Union 필드 analytics_resource .

요청 본문에는 하나의 Google Analytics 리소스만 지정할 수 있습니다.
  • 새 Google Analytics 속성을 프로비저닝하고 이를 FirebaseProject 와 연결하려면 analyticsAccountId 제공하세요.
  • 기존 Google Analytics 속성을 FirebaseProject 와 연결하려면 analyticsPropertyId 제공하세요.


analytics_resource 다음 중 하나만 될 수 있습니다.
analyticsAccountId

string

FirebaseProject 와 연결하려는 기존 Google Analytics 계정 의 ID입니다.

이 필드를 지정하면 Google Analytics 계정에 새 Google Analytics 속성이 프로비저닝되고 새 속성이 FirebaseProject 와 연결됩니다.

analyticsPropertyId

string

FirebaseProject 와 연결하려는 기존 Google Analytics 속성의 ID입니다.

응답 본문

성공하면 응답 본문에 Operation 인스턴스가 포함됩니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

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

자세한 내용은 인증 개요를 참조하세요.