指定されたFirebaseProject
既存のGoogle Analytics アカウントにリンクします。
この呼び出しを使用すると、次のいずれかを行うことができます。
-
analyticsAccountId
を指定して、指定したアカウント内に新しい Google アナリティクス プロパティをプロビジョニングし、新しいプロパティをFirebaseProject
に関連付けます。 - 既存の
analyticsPropertyId
を指定して、プロパティをFirebaseProject
に関連付けます。
projects.addGoogleAnalytics
呼び出すときは次の点に注意してください。
- 最初のチェックでは、Google アナリティクス プロパティ内の既存のデータ ストリームが
FirebaseProject
内の既存の Firebase アプリに対応するかどうかを判断します(データ ストリームに関連付けられたpackageName
またはbundleId
に基づいて)。次に、必要に応じて、データ ストリームとアプリがリンクされます。この自動リンクはAndroidApps
とIosApps
にのみ適用されることに注意してください。 - Firebase アプリに対応するデータ ストリームが見つからない場合は、各 Firebase アプリの Google アナリティクス プロパティに新しいデータ ストリームがプロビジョニングされます。新しいデータ ストリームは、以前に Analytics プロパティのデータ ストリームに関連付けられていた場合でも、常に Web アプリ用にプロビジョニングされることに注意してください。
Google Analytics アカウントの階層と構造について詳しくは、 Analytics のドキュメントをご覧ください。
この呼び出しの結果はOperation
です。 Operation
をポーリングし、 done
true
になるまでoperations.get
を呼び出してプロビジョニング プロセスを追跡します。 done
がtrue
の場合、 Operation
成功したか失敗したかのいずれかです。 Operation
成功した場合、そのresponse
AnalyticsDetails
に設定されます。 Operation
失敗した場合、そのerror
google.rpc.Status
に設定されます。
projects.addGoogleAnalytics
を呼び出すには、プロジェクト メンバーが既存のFirebaseProject
の所有者であり、Google Analytics アカウントのEdit
権限を持っている必要があります。
FirebaseProject
ですでに Google Analytics が有効になっており、現在関連付けられているプロパティとは異なるanalyticsPropertyId
を使用してprojects.addGoogleAnalytics
を呼び出すと、呼び出しは失敗します。分析は、Firebase コンソールで、またはprojects.addFirebase
の呼び出しでtimeZone
とregionCode
を指定することによって、すでに有効になっている可能性があります。
HTTPリクエスト
POST https://firebase.googleapis.com/v1beta1/{parent=projects/*}:addGoogleAnalytics
URL はgRPC トランスコーディング構文を使用します。
パスパラメータ
パラメーター | |
---|---|
parent | 既存の Google Analytics アカウントにリンクする PROJECT_IDENTIFIER値の詳細については、 |
リクエストボディ
リクエスト本文には、次の構造のデータが含まれます。
JSON表現 |
---|
{ // Union field |
田畑 | |
---|---|
ユニオンフィールドのanalytics_resource 。リクエスト本文に指定できる Google Analytics リソースは 1 つだけです。
analytics_resource 次のいずれか 1 つだけです。 | |
analyticsAccountId | このフィールドを指定すると、Google アナリティクス アカウントに新しい Google アナリティクス プロパティがプロビジョニングされ、新しいプロパティが |
analyticsPropertyId | |
レスポンスボディ
成功した場合、応答本文にはOperation
のインスタンスが含まれます。
認可の範囲
次の OAuth スコープのいずれかが必要です。
-
https://www.googleapis.com/auth/cloud-platform
-
https://www.googleapis.com/auth/firebase
詳細については、 「認証の概要」を参照してください。