README

PHP 库用于 API Spreadsheets

需求

• PHP >= 7.0

安装

composer require asharma327/apispreadsheets-php

用法

1. 创建

create 方法将在文件中创建新的行。

必需的参数包括

• fileId:string 这是电子表格的 ID。
• data:array 您想创建的行。

require 'vendor/autoload.php';

use ApiSpreadsheets\Spreadsheet;

// Data can have 3 formats:
$data = [ 
    'Id' => 1,
    'Name' => 'AT&T'
];

// Or:
$data = [[
    'Id' => 1,
    'Name' => 'AT&T'
], [
    'Id' => 2,
    'Name' => 'Apple'
]];

// Or:
$data = [
    'Id' => [1, 2],
    'Name' => ['AT&T', 'Apple']
];

$response = Spreadsheet::create('fileId', $data);

// Or if the file is private you can provide API keys as extra parameters:
$response = Spreadsheet::create('fileId', $data, 'accessKey', 'secretKey');

// ['message' => 'Your rows were created successfully', 'status_code' => 201]

2. 更新

update 方法将更新列中的值。

必需的参数包括

• fileId:string 这是电子表格的 ID。
• data:array 您想更新的数据。
• query: string SQL 风格的查询，用于更新您想更新的行。

require 'vendor/autoload.php';

use ApiSpreadsheets\Spreadsheet;

$data = [ 
    'Id' => 1,
    'Name' => 'AT&T'
];

$query = "select*from[fileId]whereId=1";

$response = Spreadsheet::update('fileId', $data, $query);

// Or if the file is private you can provide API keys as extra parameters:
$response = Spreadsheet::update('fileId', $data, $query, 'accessKey', 'secretKey');

// ['message' => 'Your rows were updated successfully', 'status_code' => 201]

3. 读取

read 方法将读取文件中的行。

必需参数：

• fileId:string 这是电子表格的 ID。

require 'vendor/autoload.php';

use ApiSpreadsheets\Spreadsheet;

// An optional array to filter or change how the returned rows look like
$params = [ 
    'dataFormat' => 'column', // Can be matrix or column, the default is row.
    'limit' => 10, // limit the returned rows
    'count' => true, // only return the count of the result
    'query' => "select*from{$file_id}whereId=1" // SQL style query to get a subset of rows.
];

$response = Spreadsheet::read('fileId', $params);

// Or if the file is private you can provide API keys as extra parameters:
$response = Spreadsheet::read('fileId', $params, 'accessKey', 'secretKey');

// Response:

// in case of dataFormat is row (default):
// ['data' => [['Id' => 1, 'Name' => 'Apple'], [...]], 'status_code' => 200]

// column dataFormat:
// ['Id' => [1, ...], 'Name' => ['Apple', ...], 'status_code' => 200]

// matrix dataFormat:
// ['data' => [[1, 'Apple'], [...]], 'status_code' => 200]

// In case of count is true
// ['count' => 10, 'status_code' => 200]

4. 删除

delete 方法将删除文件中的行。

必需的参数包括

• fileId:string 这是电子表格的 ID。
• query: string SQL 风格的 DELETE 查询，用于指定要删除的行。

require 'vendor/autoload.php';

use ApiSpreadsheets\Spreadsheet;

$query = "delete*from[fileID]whereId=1";

$response = Spreadsheet::delete('fileId', $query);

// Or if the file is private you can provide API keys as extra parameters:
$response = Spreadsheet::delete('fileId', $query, 'accessKey', 'secretKey');


// ['message' => '2 rows were deleted', 'status_code' => 200]

API 错误处理

如果 API 请求有错误，将返回包含 error 和 status_code 键对的数组，例如

['error' = 'Error message', 'status_code' => 400]

更多信息请参阅 API 文档：https://www.apispreadsheets.com/docs

许可证

MIT 许可证 (MIT)。有关更多信息，请参阅 LICENSE