Method: projects.addGoogleAnalytics

Liên kết FirebaseProject được chỉ định với tài khoản Google Analytics hiện có .

Sử dụng lệnh gọi này, bạn có thể:

  • Chỉ định analyticsAccountId để cung cấp thuộc tính Google Analytics mới trong tài khoản được chỉ định và liên kết thuộc tính mới với FirebaseProject .
  • Chỉ định một analyticsPropertyId hiện có để liên kết thuộc tính với FirebaseProject .

Lưu ý rằng khi bạn gọi projects.addGoogleAnalytics :

  1. Lần kiểm tra đầu tiên sẽ xác định xem mọi luồng dữ liệu hiện có trong thuộc tính Google Analytics có tương ứng với bất kỳ Ứng dụng Firebase hiện có nào trong FirebaseProject hay không (dựa trên packageName hoặc bundleId được liên kết với luồng dữ liệu). Sau đó, nếu có thể, các luồng dữ liệu và ứng dụng sẽ được liên kết. Lưu ý rằng việc liên kết tự động này chỉ áp dụng cho AndroidApps và IosApps .
  2. Nếu không tìm thấy luồng dữ liệu tương ứng cho Ứng dụng Firebase thì luồng dữ liệu mới sẽ được cung cấp trong thuộc tính Google Analytics cho từng Ứng dụng Firebase. Xin lưu ý rằng luồng dữ liệu mới luôn được cung cấp cho Ứng dụng web ngay cả khi trước đó luồng dữ liệu đó đã được liên kết với luồng dữ liệu trong thuộc tính Analytics.

Tìm hiểu thêm về thứ bậc và cấu trúc của tài khoản Google Analytics trong tài liệu Analytics .

Kết quả của cuộc gọi này là Operation . Thăm dò Operation để theo dõi quá trình cung cấp bằng cách gọi operations.get cho đến khi done là true . Khi done là true , Operation đã thành công hoặc thất bại. Nếu Operation thành công, response của nó được đặt thành AnalyticsDetails ; nếu Operation không thành công, error của nó được đặt thành google.rpc.Status .

Để gọi projects.addGoogleAnalytics , thành viên dự án phải là Chủ sở hữu của FirebaseProject hiện tại và có quyền Edit đối với tài khoản Google Analytics.

Nếu FirebaseProject đã bật Google Analytics và bạn gọi projects.addGoogleAnalytics bằng cách sử dụng analyticsPropertyId khác với thuộc tính hiện được liên kết thì lệnh gọi sẽ không thành công. Analytics có thể đã được bật trong bảng điều khiển Firebase hoặc bằng cách chỉ định timeZone và regionCode trong lệnh gọi tới projects.addFirebase .

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC .

Tham số đường dẫn

Thông số
parent

string

Tên tài nguyên của FirebaseProject để liên kết với tài khoản Google Analytics hiện có, ở định dạng:

projects/ PROJECT_IDENTIFIER

Tham khảo trường name FirebaseProject để biết chi tiết về các giá trị PROJECT_IDENTIFIER .

Nội dung yêu cầu

Phần thân yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn 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.
}
Lĩnh vực
Phân tích trường liên analytics_resource .

Chỉ có thể chỉ định một tài nguyên Google Analytics trong nội dung yêu cầu.
  • Để cung cấp thuộc tính Google Analytics mới và liên kết thuộc tính đó với FirebaseProject , hãy cung cấp analyticsAccountId .
  • Để liên kết thuộc tính Google Analytics hiện có với FirebaseProject , hãy cung cấp analyticsPropertyId .


analytics_resource chỉ có thể là một trong những thứ sau:
analyticsAccountId

string

ID của tài khoản Google Analytics hiện tại mà bạn muốn liên kết với FirebaseProject .

Việc chỉ định trường này sẽ cung cấp thuộc tính Google Analytics mới trong tài khoản Google Analytics của bạn và liên kết thuộc tính mới với FirebaseProject .

analyticsPropertyId

string

Mã cho thuộc tính Google Analytics hiện có mà bạn muốn liên kết với FirebaseProject .

Nội dung phản hồi

Nếu thành công, phần nội dung phản hồi sẽ chứa một phiên bản của Operation .

Phạm vi ủy quyền

Yêu cầu một trong các phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về xác thực .