Tổng quan về API Quản trị của Google Analytics

Tóm tắt: Tài liệu này cung cấp thông tin tổng quan cấp cao về API Quản trị của Google Analytics Phiên bản 1.0.

API này hiện cung cấp các tính năng trong các kênh Alpha và Beta.

Alpha

Các tính năng trong kênh Alpha đang trong giai đoạn xem trước sớm. Mặc dù chúng tôi sẽ cố gắng thông báo cho bạn về những thay đổi sắp tới, nhưng bạn sẽ gặp phải các thay đổi có thể gây lỗi trước khi API này được phát hành công khai.

Beta

Theo dự kiến, kênh này sẽ không có thay đổi có thể gây lỗi. Xin lưu ý rằng những sản phẩm trước giai đoạn phát hành rộng rãi có thể bị hỗ trợ hạn chế và các thay đổi đối với sản phẩm trước giai đoạn phát hành rộng rãi có thể không tương thích với những phiên bản khác trước giai đoạn phát hành rộng rãi.

Để biết các thông báo chính thức về API Google Analytics, vui lòng đăng ký Nhóm thông báo API Google Analytics.

Giới thiệu

API Quản trị của Google Analytics cho phép truy cập theo phương thức lập trình vào dữ liệu cấu hình Google Analytics 4 (GA4) và chỉ tương thích với các tài sản GA4. Tìm hiểu thêm về tài sản GA4.

Bạn có thể sử dụng API Quản trị của Google Analytics để:

• Cấp phép cho tài khoản mới.
• Quản lý tài khoản.
• Quản lý chế độ cài đặt chia sẻ dữ liệu.
• Liệt kê các bản tóm tắt tài khoản.
• Sự kiện nhật ký thay đổi tìm kiếm.
• Quản lý tài sản.
• Xác nhận việc thu thập dữ liệu người dùng.
• Quản lý chế độ cài đặt giữ lại dữ liệu cho một tài sản.
• Chế độ cài đặt Quản lý tín hiệu của Google cho một tài sản (phiên bản alpha).
• Quản lý sự kiện phát trực tiếp.
• Quản lý các mã thông báo bí mật cho Measurement Protocol.
• Quản lý giản đồ giá trị lượt chuyển đổi SKAdNetwork (phiên bản Alpha).
• Tạo đoạn mã thẻ Google cho luồng dữ liệu web (phiên bản Alpha).
• Quản lý sự kiện chuyển đổi.
• Quản lý phương diện tuỳ chỉnh.
• Quản lý chỉ số tuỳ chỉnh.
• Quản lý mối liên kết giữa tài sản GA4 và dự án Firebase.
• Quản lý mối liên kết giữa tài sản GA4 và tài khoản Google Ads.
• Quản lý các đề xuất liên kết giữa tài sản GA4 và nhà quảng cáo Display & Video 360 (phiên bản Alpha).
• Quản lý các mối liên kết giữa tài sản GA4 và nhà quảng cáo Display & Video 360 (Alpha).
• Quản lý mối liên kết giữa tài sản GA4 và Search Ads 360 (phiên bản thử nghiệm alpha).
• Quản lý mối liên kết giữa tài sản GA4 và dự án BigQuery (phiên bản Alpha).
• Quản lý quyền của người dùng đối với hệ thống phân cấp tài khoản và tài sản GA4 (phiên bản Alpha).
• Tạo báo cáo về quyền truy cập dữ liệu.
• Quản lý đối tượng (phiên bản Alpha).
• Quản lý tập dữ liệu mở rộng (Alpha).
• Quản lý chế độ chọn không sử dụng quy trình thiết lập GA4 tự động (phiên bản Alpha).

Các phương thức hiện có

Sau đây là các phương thức có thể sử dụng.

Cấp phép tài khoản

• accounts.provisionAccountTicket

Phương thức này trả về trường accountTicketId cần có trong URL của Điều khoản dịch vụ (TOS): https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID. Sau khi người dùng truy cập URL của Điều khoản dịch vụ và chấp nhận Điều khoản dịch vụ, quy trình tạo tài khoản Google Analytics sẽ hoàn tất. Xem Mẫu cấp phép tài khoản.

Quản lý tài khoản

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

Quản lý chế độ cài đặt chia sẻ dữ liệu

• accounts.getDataSharingSettings

Liệt kê các bản tóm tắt tài khoản

• accountSummaries.list

Sự kiện nhật ký thay đổi tìm kiếm

• accounts.searchChangeHistoryEvents

Quản lý tài sản

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

Xác nhận hoạt động thu thập dữ liệu người dùng

• properties.acknowledgeUserDataCollection

Quản lý chế độ cài đặt giữ lại dữ liệu

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

Quản lý chế độ cài đặt tín hiệu của Google (phiên bản alpha)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

Quản lý luồng dữ liệu

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

Quản lý khoá bí mật trên Measurement Protocol

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

Quản lý giản đồ giá trị lượt chuyển đổi SKAdNetwork (phiên bản alpha)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

Quản lý sự kiện chuyển đổi

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.update

Quản lý phương diện tuỳ chỉnh

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

Quản lý chỉ số tuỳ chỉnh

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

Liên kết dự án Firebase

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

Liên kết với tài khoản Google Ads

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

Tạo thẻ Google (Alpha)

• properties.webDataStreams.getGlobalSiteTag

Đề xuất liên kết giữa tài sản GA4 với nhà quảng cáo Display & Video 360 (phiên bản thử nghiệm alpha)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

Liên kết tài khoản nhà quảng cáo Display & Video 360 (phiên bản Alpha)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

Liên kết tài khoản Search Ads 360 (phiên bản thử nghiệm alpha)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

Tìm hiểu thêm về cách thiết lập tính năng tích hợp Analytics Search Ads 360 cho tài sản GA4.

Liên kết tài khoản BigQuery (phiên bản alpha)

• properties.bigQueryLinks.get
• properties.bigQueryLinks.list

Tìm hiểu thêm về cách thiết lập tính năng BigQuery Export cho tài sản GA4.

Quản lý quyền của người dùng (phiên bản alpha)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

Báo cáo quyền truy cập vào dữ liệu

• properties.runAccessReport

Hãy xem hướng dẫn về Báo cáo quyền truy cập dữ liệu để biết thêm thông tin về tính năng này.

Quản lý đối tượng (giai đoạn thử nghiệm alpha)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

Tìm hiểu thêm về đối tượng trong Google Analytics.

Quản lý tập dữ liệu mở rộng (Alpha)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

Tìm hiểu thêm về Tập dữ liệu mở rộng trong Google Analytics 360.

Tự động chọn không sử dụng quy trình thiết lập GA4 (phiên bản thử nghiệm alpha)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

Tìm hiểu thêm về cách quản lý trạng thái chọn không tham gia cho quy trình thiết lập GA4 tự động cho tài sản UA.