README

PHP的Google API客户端库

描述

Google API客户端库允许您在服务器上使用Google API，例如Google+、Drive或YouTube。

测试版

这个库处于测试版。我们对库的稳定性和功能足够放心，希望您使用它构建实际的生产应用。我们将努力支持库的公共和受保护表面，并在未来保持向后兼容性。在我们仍然处于测试版期间，我们保留做出不兼容更改的权利。如果我们确实移除了一些功能（通常因为存在更好的功能或该功能不可行），我们的意图是将其弃用，并为开发人员提供足够的时间来更新他们的代码。

需求

注意：由于加密算法的要求，一些功能（服务帐户和ID令牌验证）需要PHP 5.3.0或更高版本。

开发者文档

http://developers.google.com/api-client-library/php

安装

有关最新安装和设置说明，请参阅文档。

基本示例

请参阅examples/目录中的关键客户端功能示例。

<?php
  require_once 'Google/Client.php';
  require_once 'Google/Service/Books.php';
  $client = new Google_Client();
  $client->setApplicationName("Client_Library_Examples");
  $client->setDeveloperKey("YOUR_APP_KEY");
  $service = new Google_Service_Books($client);
  $optParams = array('filter' => 'free-ebooks');
  $results = $service->volumes->listVolumes('Henry David Thoreau', $optParams);

  foreach ($results as $item) {
    echo $item['volumeInfo']['title'], "<br /> \n";
  }

常见问题解答

如果某个功能不起作用，我该怎么做？

有关库的支持，最佳询问地点是StackOverflow上的google-api-php-client标签：http://stackoverflow.com/questions/tagged/google-api-php-client

如果库中存在特定的问题，请在Github问题跟踪器中提交问题，包括失败代码的（最小）示例和任何特定错误。也可以提交功能请求，只要它们是核心库请求，而不是特定于API的请求：对于那些请求，请参阅各个API的文档以确定最佳提交位置。请尽量提供清晰说明该功能将解决的问题。

如何贡献？

我们通过Github Pull Requests接受贡献，但所有贡献者都必须遵守标准的Google贡献者许可协议。您可以在文档中找到链接和更多说明：https://developers.google.com/api-client-library/php/contribute

为什么仍然支持5.2？

当我们开始开发1.0.0分支时，我们知道库的0.6版本存在一些基本问题需要修复。当时我们查看库的使用情况和其他相关项目，发现PHP 5.2安装的基础仍然很大且活跃。您可以在WordPress统计数据中的PHP版本图表中看到这一点：https://wordpresstheme.cn/about/stats/。我们将继续关注我们看到的用法类型，并尽可能利用新的PHP功能。

为什么Google_..._Service有奇怪的名字？

Service类通常是自动从API发现文档生成的：https://developers.google.com/discovery/。有时API中会添加具有不寻常名称的新功能，这可能导致PHP类中出现一些意外的或非标准样式命名。

如何处理非JSON响应类型

一些服务默认返回XML或类似格式，而不是JSON，而该库支持的是JSON。您可以通过在方法调用中添加一个通常作为最后一个参数的'alt'参数来请求JSON响应。

$opt_params = array(
  'alt' => "json"
);

代码质量

将style/目录下的ruleset.xml复制到您的/usr/share/php/PHP/CodeSniffer/Standards（或适当的等效目录）中的新目录GAPI/中，并使用以下命令运行代码检查：

    phpcs --standard=GAPI src/

dollar / google-php-sdk

维护者

详细信息