首页
/ Legato:Ruby 客户端用于 Google Analytics 核心报告和管理 API

Legato:Ruby 客户端用于 Google Analytics 核心报告和管理 API

2024-12-26 20:10:32作者:侯霆垣

1. 安装指南

1.1 安装 Ruby 环境

在安装 Legato 之前,确保你的系统已经安装了 Ruby 环境。你可以通过以下命令检查 Ruby 是否已安装:

ruby -v

如果未安装 Ruby,请参考 Ruby 官方安装指南 进行安装。

1.2 安装 Legato Gem

Legato 是一个 Ruby Gem,可以通过 Bundler 或直接使用 gem 命令进行安装。

使用 Bundler 安装

在你的 Gemfile 中添加以下内容:

gem 'legato'

然后运行以下命令安装 Gem:

bundle install

使用 gem 命令安装

你也可以直接使用 gem 命令安装 Legato:

gem install legato

2. 项目的使用说明

2.1 获取 OAuth2 访问令牌

首先,你需要从 Google 获取一个 OAuth2 访问令牌。你可以参考 Google OAuth2 文档 获取访问令牌。

access_token = OAuth2 Access Token # 从 Google 获取

2.2 创建用户

使用获取到的访问令牌创建一个新的用户:

user = Legato::User.new(access_token)

2.3 列出账户和配置文件

你可以列出用户有权访问的所有账户和配置文件:

user.accounts
user.accounts.first.profiles

2.4 获取配置文件

你可以获取用户有权访问的配置文件:

profile = user.profiles.first

2.5 使用配置文件

配置文件可以用于查询 Google Analytics 数据。例如,你可以定义一个模型来查询退出率和页面浏览量:

class Exit
  extend Legato::Model

  metrics :exits, :pageviews
  dimensions :page_path, :operating_system, :browser
end

profile.exit # 返回一个 Legato::Query 对象
profile.exit.each {} # 任何可枚举的操作都会触发对 GA 的请求

3. 项目 API 使用文档

3.1 指标和维度

你可以使用 metricsdimensions 方法来定义查询的指标和维度:

metrics :exits, :pageviews
dimensions :page_path, :operating_system, :browser

3.2 过滤

你可以使用 filter 方法来定义查询过滤器:

filter(:high_exits) { gte(:exits, 2000) }
filter(:low_pageviews) { lte(:pageviews, 200) }

3.3 使用和链式过滤

你可以将配置文件作为参数传递给过滤器,并链式调用多个过滤器:

Exit.for_browser("Safari", profile)
Exit.high_exits.low_pageviews(profile)

3.4 实时报告

你可以使用 realtime 方法进行实时报告查询:

Exit.results(profile).realtime

4. 项目安装方式

4.1 使用 Bundler 安装

在你的 Gemfile 中添加以下内容:

gem 'legato'

然后运行以下命令安装 Gem:

bundle install

4.2 使用 gem 命令安装

你也可以直接使用 gem 命令安装 Legato:

gem install legato

4.3 验证安装

安装完成后,你可以通过以下命令验证 Legato 是否安装成功:

irb
require 'legato'

如果没有报错,说明 Legato 已成功安装。

总结

Legato 是一个强大的 Ruby 客户端,用于与 Google Analytics 核心报告和管理 API 进行交互。通过本文档,你可以了解如何安装、配置和使用 Legato 来查询和管理 Google Analytics 数据。希望本文档能帮助你更好地理解和使用 Legato。

登录后查看全文
热门项目推荐

热门内容推荐

最新内容推荐

项目优选

收起
docsdocs
OpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
144
1.94 K
kernelkernel
deepin linux kernel
C
22
6
ohos_react_nativeohos_react_native
React Native鸿蒙化仓库
C++
192
274
openGauss-serveropenGauss-server
openGauss kernel ~ openGauss is an open source relational database management system
C++
145
189
RuoYi-Vue3RuoYi-Vue3
🎉 (RuoYi)官方仓库 基于SpringBoot,Spring Security,JWT,Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
930
554
nop-entropynop-entropy
Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台,包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分,采用java语言实现,可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
8
0
openHiTLSopenHiTLS
旨在打造算法先进、性能卓越、高效敏捷、安全可靠的密码套件,通过轻量级、可剪裁的软件技术架构满足各行业不同场景的多样化要求,让密码技术应用更简单,同时探索后量子等先进算法创新实践,构建密码前沿技术底座!
C
887
394
金融AI编程实战金融AI编程实战
为非计算机科班出身 (例如财经类高校金融学院) 同学量身定制,新手友好,让学生以亲身实践开源开发的方式,学会使用计算机自动化自己的科研/创新工作。案例以量化投资为主线,涉及 Bash、Python、SQL、BI、AI 等全技术栈,培养面向未来的数智化人才 (如数据工程师、数据分析师、数据科学家、数据决策者、量化投资人)。
Jupyter Notebook
75
66
CangjieCommunityCangjieCommunity
为仓颉编程语言开发者打造活跃、开放、高质量的社区环境
Markdown
1.11 K
0
openHiTLS-examplesopenHiTLS-examples
本仓将为广大高校开发者提供开源实践和创新开发平台,收集和展示openHiTLS示例代码及创新应用,欢迎大家投稿,让全世界看到您的精巧密码实现设计,也让更多人通过您的优秀成果,理解、喜爱上密码技术。
C
64
512