README

Google API客户端库PHP版

描述

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-api-php-client/autoload.php'; // or wherever autoload.php is located
  $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，这是库所支持的格式。您可以通过在方法调用中通常作为最后一个参数的必选参数中添加一个'alt'参数来请求JSON响应

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

代码质量

将style/目录中的ruleset.xml复制到您的/usr/share/php/PHP/CodeSniffer/Standards (或相应的等效目录)下的新目录GAPI/中，然后使用以下命令运行代码检查：

    phpcs --standard=GAPI src/

productsupcom / google_apiclient

维护者

详细信息