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 过滤控件的更多信息，请参阅 GAPI 过滤控件。

功能

• 支持 CURL 和 fopen HTTP 访问方法，自动检测
• Google Analytics 度量和维度的 PHP 数组
• 帐户数据对象映射 - 获取参数的方法
• 报告数据对象映射 - 获取度量和参数的方法
• 易于过滤，使用 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 对象，并具有允许 'get' 任何维度或度量值的接口。

例如，如果您请求度量 '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 开发者控制台中启用 'Analytics API'
5. 在 Google Analytics 管理 > 用户管理 中，授予服务帐户对您想要访问的分析帐户的 '读取和分析' 权限