Method: projects.addGoogleAnalytics

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

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

  • Hãy chỉ định analyticsAccountId để cung cấp một tài sản Google Analytics mới trong tài khoản được chỉ định và liên kết tài sản mới đó với FirebaseProject.
  • Hãy 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. Bước kiểm tra đầu tiên giúp xác định xem có luồng dữ liệu hiện có nào trong tài sản Google Analytics có tương ứng với mọi ứng dụng Firebase hiện có 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 đó, các luồng dữ liệu và ứng dụng sẽ được liên kết (nếu có). Xin lưu ý rằng tính năng tự động liên kết 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ì hệ thống sẽ cung cấp các luồng dữ liệu mới trong tài sản Google Analytics cho từng Ứng dụng Firebase. Xin lưu ý rằng hệ thống luôn cấp phép cho một luồng dữ liệu mới cho một Ứng dụng web, ngay cả khi trước đó luồng dữ liệu đó đã được liên kết với một luồng dữ liệu trong tài sản Analytics.

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

Kết quả của lệnh gọi này là một Operation. Thăm dò Operation để theo dõi quá trình cấp phé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 không thành công. Nếu Operation thành công, thì response của ứng dụng sẽ được đặt thành AnalyticsDetails; nếu Operation không thành công thì error của thiết bị đó sẽ đượ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 analyticsPropertyId khác với tài sản hiện được liên kết, thì lệnh gọi đó sẽ không thực hiện được. Analytics có thể đã được bật trong bảng điều khiển của Firebase hoặc bằng cách chỉ định timeZone và regionCode trong lệnh gọi đến 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 một tài khoản Google Analytics hiện có, theo định dạng:

projects/PROJECT_IDENTIFIER

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

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Trường
Trường kết hợp analytics_resource.

Bạn chỉ có thể chỉ định một tài nguyên Google Analytics trong nội dung yêu cầu.
  • Để cấp phép một tài sản Google Analytics mới và liên kết tài sản đó với FirebaseProject, hãy cung cấp analyticsAccountId.
  • Để liên kết một tài sản 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 trạng thái sau:
analyticsAccountId

string

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

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

string

Mã của tài sản 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, nội dung phản hồi sẽ chứa một thực thể của Operation.

Phạm vi uỷ 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 bài viết Tổng quan về việc xác thực.