Method: projects.addGoogleAnalytics

Menautkan FirebaseProject yang ditentukan dengan akun Google Analytics yang ada.

Dengan panggilan ini, Anda dapat:

  • Tentukan analyticsAccountId untuk menyediakan properti Google Analytics baru dalam akun yang ditentukan dan mengaitkan properti baru dengan FirebaseProject.
  • Tentukan analyticsPropertyId yang ada untuk mengatribusikan properti dengan FirebaseProject.

Perlu diketahui bahwa saat Anda memanggil projects.addGoogleAnalytics:

  1. Pemeriksaan pertama menentukan apakah aliran data yang ada di properti Google Analytics sesuai dengan Aplikasi Firebase yang ada di FirebaseProject (berdasarkan packageName atau bundleId yang dikaitkan dengan aliran data). Kemudian, jika berlaku, aliran data dan aplikasi akan ditautkan. Perlu diperhatikan bahwa penautan otomatis ini hanya berlaku untuk AndroidApps dan IosApps.
  2. Jika tidak ditemukan aliran data yang sesuai untuk Aplikasi Firebase, aliran data baru akan disediakan di properti Google Analytics untuk setiap Aplikasi Firebase. Perhatikan bahwa aliran data baru selalu disediakan untuk Aplikasi Web meskipun sebelumnya telah dikaitkan dengan aliran data di properti Analytics.

Pelajari hierarki dan struktur akun Google Analytics lebih lanjut di dokumentasi Analytics.

Hasil panggilan ini adalah Operation. Lakukan polling Operation untuk melacak proses penyediaan dengan memanggil operations.get hingga done adalah true. Jika done adalah true, berarti Operation telah berhasil atau gagal. Jika Operation berhasil, response-nya akan disetel ke AnalyticsDetails; jika Operation gagal, error-nya akan disetel ke google.rpc.Status.

Untuk memanggil projects.addGoogleAnalytics, anggota project harus menjadi Pemilik untuk FirebaseProject yang ada dan memiliki izin Edit untuk akun Google Analytics.

Jika FirebaseProject sudah mengaktifkan Google Analytics, dan Anda memanggil projects.addGoogleAnalytics menggunakan analyticsPropertyId yang berbeda dari properti yang saat ini dikaitkan, panggilan akan gagal. Analytics mungkin telah diaktifkan di Firebase console atau dengan menentukan timeZone dan regionCode dalam panggilan ke projects.addFirebase.

Permintaan HTTP

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

URL menggunakan sintaks gRPC Transcoding.

Parameter jalur

Parameter
parent

string

Nama resource FirebaseProject yang akan ditautkan ke akun Google Analytics yang ada, dalam format:

projects/PROJECT_IDENTIFIER

Lihat kolom FirebaseProject name untuk mengetahui detail tentang nilai PROJECT_IDENTIFIER.

Isi permintaan

Isi permintaan memuat data dengan struktur berikut:

Representasi 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.
}
Kolom
Kolom union analytics_resource.

Hanya satu resource Google Analytics yang dapat ditentukan dalam isi permintaan.
  • Untuk menyediakan properti Google Analytics baru dan mengaitkannya dengan FirebaseProject, masukkan analyticsAccountId.
  • Untuk mengatribusikan properti Google Analytics yang ada dengan FirebaseProject, masukkan analyticsPropertyId.


analytics_resource hanya dapat berupa salah satu dari yang berikut:
analyticsAccountId

string

ID untuk akun Google Analytics yang ada yang ingin Anda tautkan dengan FirebaseProject.

Penentuan kolom ini akan menyediakan properti Google Analytics baru di akun Google Analytics Anda dan mengaitkan properti baru dengan FirebaseProject.
analyticsPropertyId

string

ID untuk properti Google Analytics yang ada yang ingin Anda atribusikan dengan FirebaseProject.

Isi respons

Jika berhasil, isi respons akan berisi instance Operation.

Cakupan Otorisasi

Memerlukan salah satu cakupan OAuth berikut:

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

Untuk mengetahui informasi selengkapnya, lihat Ringkasan Autentikasi.