README

已弃用

创建于2016年 - 现在相当老了，不再维护。

stopsopa/google-spreadsheets-api-extension

安装

遵循Packagist说明： Packagist

设置对Google表格文档的访问权限

首先，您需要在Google API控制台中生成凭据并设置服务帐户密钥（阅读更多）。之后，您将收到一个'.p12'文件，这是一个私钥和特殊的电子邮件地址（例如：applicationname@applicationname.iam.gserviceaccount.com），您应该使用它来给Google Drive中的特定工作表提供API访问权限。

设置此库

use Stopsopa\GoogleSpreadsheets\Services\GoogleSpreadsheets;

$service = new GoogleSpreadsheets();

$service->setupByServiceAccountKey(
    'pathtofile.p12', 
    'applicationname@applicationname.iam.gserviceaccount.com'
);

... 现在您已经准备就绪。

API

大多数方法都是相当直观的，所以通常您可以通过IDE或通过探索返回的数据结构（特别是如果您阅读了Sheets API中使用的术语）来探索它们，这里不需要详细解释，但是列出它们也是一个好主意。还有一个好主意是查看从方法testFindWorksheets开始的测试。

GoogleSpreadsheets类的实例方法

GoogleSpreadsheetsList类的实例方法

更多关于基于列表的馈送的信息。

常用参数

$rawResponse

许多这些方法都有一个特殊的参数$rawResponse，将此设置为true会将返回的数据结构转换为原始形式，就像它来自Google API一样。但大多数情况下，最好保持此参数不变，并从这些方法的输出获取更一致和更好的数据结构迭代。

$key

您可以在电子表格URL中找到键（以下示例中的粗体）。

https://docs.google.com/spreadsheets/d/1IAP4HOacD4Az6q_PFfxxxxxxxxxxxxxxxx9KBX-IMO25s/edit?usp=sharing

$wid

这是电子表格中每个工作表的唯一标识符，您可以通过使用方法findWorksheets来获取这些ID。

$filter

此参数用于从工作表中获取特定的行或列范围，例如

  $result = $service->findWorksheetData($key, $wid, false, array(
    'max-col' => 4,
    'max-row' => 3
  ));

有关更多信息，请参阅Google API中的获取特定行或列。

其他细节

方法GoogleSpreadsheets->update()

    $service->update($key, $wid, array(
        'A1' => "Name",
        'B1' => "Surname",
        'C1' => "Age",
        'D1' => "Weight",
        'E1' => "Height",
        'A2' => "Something else... ",
        'R2C5' => "And again...",
        'R3C2' => '' // empty string to delete value from cell
    ));

使用此方法，您可以使用两种类型的定位表示法。使用方法update，您可以通过一个批量请求来设置/更新/删除许多单元格中的数据。

要在这两种格式之间进行转换，请使用此库。

方法GoogleSpreadsheetsList->add()

    $list->add(array(
        'Name' => 'John',
        'Surname' => 'Smith',
        'Age' => '35'
    ));

想了解更多关于基于列表的源的基本假设，请访问这里。

许可协议

MIT许可协议（MIT）版权所有（c）2016 Szymon Działowski 允许任何获得本软件及其相关文档文件（以下简称“软件”）副本的人免费使用该软件，不受限制地使用、复制、修改、合并、发布、分发、再许可和/或出售软件的副本，并允许获得软件的人进行上述操作，但受以下条件约束：上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。本软件按“原样”提供，不提供任何形式的保证，明示或暗示，包括但不限于适销性、特定用途适用性和非侵权性保证。在任何情况下，作者或版权所有者不对任何索赔、损害或其他责任承担责任，无论这些责任是因合同、侵权或其他原因引起的，无论是否与软件或其使用或其他操作有关。