ibnuhalimm/laravel-google-sheet

Laravel 的 Google Sheet API 包装器

v1.2.1 2022-04-23 03:47 UTC

This package is auto-updated.

Last update: 2024-09-23 08:57:10 UTC


README

Latest Version on Packagist Total Downloads

Laravel 的 Google Sheet API 包装器。与您的表格交互的最简单方式。

内容

需求

  1. 创建 Google Cloud 项目。如果您想使用现有的项目,可以跳到下一步。
  2. 在 Google 开发者控制台创建服务帐户凭证并将您的 Google Sheet 文件共享给这些服务帐户邮箱。
  3. 将下载的服务帐户 JSON 文件放置于 storage/app/google-sheet/ 文件夹,然后将这些文件重命名为 credentials.json
  4. 在 Google Workspace APIs 中启用 Google Sheet API

安装

您可以通过 composer 安装此包

composer require ibnuhalimm/laravel-google-sheet

可选,您可以使用以下命令发布此包的配置文件

php artisan vendor:publish --provider="Ibnuhalimm\LaravelGoogleSheet\GoogleSheetServiceProvider"

或通过提及配置标签

php artisan vendor:publish --tag=google-sheet-config

使用

获取数据

您可以使用 GoogleSheet 门面(别名或类本身)。

use GoogleSheet;

$spreadSheetId = '1cyUalLbuw_TpAIgkf76JcU-BbsYCSwtVqJuf_gCNzYA';
$sheetName = 'Class Data';
$cellRange = 'A1:E5';

GoogleSheet::useDocument($spreadSheetId)->fetchData($sheetName, $cellRange);

此方法将返回数组数据的子集

=> [
     [
       "Student Name",
       "Gender",
       "Class Level",
       "Home State",
       "Major",
     ],
     [
       "Alexandra",
       "Female",
       "4. Senior",
       "CA",
       "English",
     ],
    ...

测试

composer test

变更日志

请参阅 CHANGELOG 以获取有关最近更改的更多信息。

贡献

请参阅 CONTRIBUTING 以获取详细信息。

安全

如果您发现任何与安全相关的问题,请通过电子邮件 ibnuhalim@pm.me 联系,而不是使用问题跟踪器。

鸣谢

许可

MIT 许可证 (MIT)。请参阅 许可文件 以获取更多信息。

Laravel 包模板

此包是用 Laravel 包模板 生成的。