README

用于通过Service Account方便地操作Google表格的库。此库依赖于https://github.com/googleapis/google-api-php-client

安装

composer require digitalstars/google-sheets

该库存在一个bug(issue)，第一次运行时某个清理脚本没有执行。因此，需要执行安装命令两次，否则不会出现vendor/autoload.php

开始之前

1. 按照此指南创建.json配置文件和服务账户邮箱

$spreadsheet_id = '1FpDbHUknChjWzioeTrddMur-d_tSl7E_-tKCqn9xW6o';
$config_path = 'fire-322212-c5306b491ecc.json';

1. 进入Google表格并授予服务账户编辑权限

工作示例

连接

<?php
require_once 'vendor/autoload.php';
use DigitalStars\Sheets\DSheets;

$spreadsheet_id = '1FpDbHUknChjWzioeTrddMur-d_tSl7E_-tKCqn9xW6o';
$config_path = 'fire-322212-c5306b491ecc.json';

$sheet = DSheets::create($spreadsheet_id, $config_path)->setSheet('Лист');

数据导出

$data = $sheet->get(); //выгрузит все данные в листе
print_r($data);
// [
//   ['id', 'name', 'mail'],
//   ['1', 'name1', 'mail1'],
//   ['2', 'name1', 'mail2']
// ]

$data = $sheet->setSheet('Лист2')->get('A:A'); //выгрузит весь столбец А из Лист2
print_r($data);
// [
//   ['id'],
//   ['1']
//   ['2']
// ]

$data = $sheet->get('A2:B3'); //выгрузит диапазон A2:B3
print_r($data);
// [
//   ['1', 'name1'],
//   ['2', 'name1']
// ]

添加到工作表末尾

此方法将数据添加到工作表的末尾，直到遇到空白处

$sheet->append([['Имя', 'Фамилия', 'Возраст']]); //добавит в конец A по максимальной используемой строке всех букв
//Если C6-C8 пустые, то добавит в них. Иначе в самый конец A ориентируясь по максимальной используемой строке всех букв
$sheet->setSheet('Лист2')->append([['Имя', 'Фамилия', 'Возраст']], 'C6'); 

更新/添加数据

$sheet->update([['Имя', 'Фамилия', 'Возраст']]); //добавит в A1-C1
$sheet->setSheet('Лист2')->update([['Имя', 'Фамилия', 'Возраст']], 'A3'); //добавит в A3-C3 даже если они заполнены

使用原始Google_Service_Sheets

$service = $sheet->getService(); //получаем
$service->spreadsheets->...
$service->spreadsheets_sheets->...
$service->spreadsheets_values->...
$client = $service->getClient();
$sheet->setService($service); //устанавливаем обратно если надо