README

GAPI 现在是版本 2.0 - 该版本具有完整的 OAuth2 和 V3 认证支持。

Google Analytics 过滤控制器的开发已完成。现在您可以使用简单的 GAPI 过滤字符串来过滤结果，例如

$filter = 'country == United States && browser == Firefox || browser == Chrome';

您可以创建简单的查询字符串来表示 Google Analytics 所需的逻辑，但它足够抽象，以便更易于阅读和使用。

下载最新的 gapi.class.php 并通过 example.filter.php 示例尝试过滤控制器。了解更多关于 GAPI 过滤控制器 的信息。

特性

• 支持 CURL 和 fopen HTTP 访问方法，具有自动检测功能
• PHP 数组用于 Google Analytics 指标和维度
• 账户数据对象映射 - 获取参数的方法
• 报告数据对象映射 - 获取指标和参数的方法
• 易于过滤，使用 GAPI 查询语言进行 Google Analytics 过滤
• 完整的 PHP5 面向对象代码，适用于您的 PHP 应用程序

GAPI（读作 'g,a,p,i'）是 Google Analytics PHP5 接口。

您的 OO PHP5 项目需要 Google Analytics 接口吗？

您可能正在运行 symfony、zend 框架、cakePHP，并且需要一个良好的面向对象接口来获取这些统计数据。此类提供了一个良好的基于类的接口。

使用方法如下

$ga = new gapi('XXXX@developer.gserviceaccount.com','oauthkeyfile.p12');

$ga->requestReportData(145141242,array('browser','browserVersion'),array('pageviews','visits'));

foreach($ga->getResults() as $result)
{
  echo '<strong>'.$result.'</strong><br />';
  echo 'Pageviews: ' . $result->getPageviews() . ' ';
  echo 'Visits: ' . $result->getVisits() . '<br />';
}

echo '<p>Total pageviews: ' . $ga->getPageviews() . ' total visits: ' . $ga->getVisits() . '</p>';

本项目受 Doctrine 和 Propel ORM 接口在 PHP 中的应用启发。处理复杂数据应该是容易的！

使用魔法获取方法访问指标和维度

使用 GAPI，当数据从 Google 返回时，会自动将其转换为原生 PHP 对象，并提供一个接口以允许获取任何维度或指标的值。

例如，如果您请求指标 'uniquePageviews' 和维度 'pagePath'，您可以进行以下操作

foreach($ga->getResults() as $result)
{
  echo $result->getUniquePageviews();
  echo $result->getPagePath();
}

设置 Google 服务账户以使用 GAPI 的说明

GAPI（因为现在 Google Analytics API 只支持 OAuth2）将要求您创建一个 '服务账户'，然后下载一个 .P12 文件以上传到您的应用程序。

1. 创建一个 Google 开发者项目
2. 在此项目下创建服务账户，查看说明
3. 下载此服务账户的 .p12 文件，与 gapi.class.php 放在同一文件夹中
4. 在 Google 开发者控制台中启用 '分析 API'
5. 在 Google Analytics 管理 > 用户管理 中，授予服务账户对您想要访问的分析账户的 '读取和分析' 权限