README

关于此分支的说明

此包是一个简单的分支，允许向GoogleCalendar Event的更新方法传递选项参数。它允许在更新时启用通知，例如。如果您不需要此功能，请访问spatie/laravel-google-calendar。

此包使使用Google日历变得轻而易举。一旦设置完毕，您就可以执行以下操作

use Spatie\GoogleCalendar\Event;

//create a new event
$event = new Event;

$event->name = 'A new event';
$event->startDateTime = Carbon\Carbon::now();
$event->endDateTime = Carbon\Carbon::now()->addHour();
$event->addAttendee(['email' => 'youremail@gmail.com']);
$event->addAttendee(['email' => 'anotherEmail@gmail.com']);

$event->save();

// get all future events on a calendar
$events = Event::get();

// update existing event
$firstEvent = $events->first();
$firstEvent->name = 'updated name';
$firstEvent->save();

$firstEvent->update(['name' => 'updated again']);

// create a new event
Event::create([
   'name' => 'A new event',
   'startDateTime' => Carbon\Carbon::now(),
   'endDateTime' => Carbon\Carbon::now()->addHour(),
]);

// delete an event
$event->delete();

Spatie是一家总部位于比利时的安特卫普的网页设计公司。您可以在我们的网站上找到我们所有开源项目的概述。

支持我们

我们投入了大量资源来创建一流的开放式源代码包。您可以通过购买我们的付费产品之一来支持我们。

我们非常感谢您从您的家乡寄来明信片，注明您正在使用我们的哪个包。您可以在我们的联系页面上找到我们的地址。我们将在我们的虚拟明信片墙上发布收到的所有明信片。

安装

您可以通过composer安装此包

composer require spatie/laravel-google-calendar

您必须使用以下命令发布配置

php artisan vendor:publish --provider="Spatie\GoogleCalendar\GoogleCalendarServiceProvider"

这将发布一个名为google-calendar.php的文件到您的config目录中，内容如下

return [
    /*
     * Path to the json file containing the credentials.
     */
    'service_account_credentials_json' => storage_path('app/google-calendar/service-account-credentials.json'),

    /*
     *  The id of the Google Calendar that will be used by default.
     */
    'calendar_id' => env('GOOGLE_CALENDAR_ID'),
];

如何获取与Google日历通信的凭证

您首先需要获取用于使用Google API的凭证。我假设您已经创建了一个Google帐户并已登录。前往Google API控制台，然后在页眉中点击“选择一个项目”。

接下来，我们必须指定项目可能消耗哪些API。从页眉选择“启用API和服务”。

在下一页上，搜索“日历”，然后从列表中选择“Google日历API”。

从这里，按“启用”以启用此项目的Google日历API。

现在，您已经创建了一个可以访问日历API的项目，是时候下载包含这些凭证的文件了。在侧边栏中点击“凭证”，然后点击“API和服务的凭证”链接。

从该页面，打开“创建凭证”下拉菜单，选择“服务帐户密钥”。

在下一屏幕上，您可以给服务帐户起一个名字。您想叫什么都行。在服务帐户id中，您将看到一个电子邮件地址。我们将在本指南的后面使用此电子邮件地址。选择“JSON”作为密钥类型，然后点击“创建”以下载JSON文件。您会收到一个警告，表示服务帐户没有角色，您可以安全地忽略此警告，创建服务帐户而不分配角色。

将json文件保存到Laravel项目中的指定位置，该位置在包的配置文件中由service_account_credentials_json键指定。由于json文件可能包含敏感信息，我建议不要将其提交到您的git仓库。

现在API站点上的所有设置都已就绪，我们还需要在Google日历网站上配置一些内容。转到Google日历，查看您要通过PHP操作的那个日历的设置。在“与特定人员共享”标签页上，点击“添加人员”按钮，并添加在API站点上创建凭证时显示的服务帐户ID。

向下滚动到“集成日历”部分，以查看日历的ID。您需要在配置文件中指定该ID。

用法

获取事件

您可以通过调用Event::get();获取所有事件，这将返回未来一年的所有事件。事件以Spatie\GoogleCalendar\Event对象的形式出现。

函数的全签名如下

public static function get(Carbon $startDateTime = null, Carbon $endDateTime = null, array $queryParameters = [], string $calendarId = null): Collection

您可以在$queryParameters中传递的参数列表，请参阅Google日历API文档中的list请求说明。

访问事件的开始和结束日期

您可以使用这些getter来检索作为Carbon实例的开始和结束日期

$events = Event::get();

$events[0]->startDate;
$events[0]->startDateTime;
$events[0]->endDate;
$events[0]->endDateTime;

创建事件

您可以直接实例化一个Spatie\GoogleCalendar\Event-对象

$event = new Event;

$event->name = 'A new event';
$event->startDateTime = Carbon\Carbon::now();
$event->endDateTime = Carbon\Carbon::now()->addHour();

$event->save();

您也可以静态调用create

Event::create([
   'name' => 'A new event',
   'startDateTime' => Carbon\Carbon::now(),
   'endDateTime' => Carbon\Carbon::now()->addHour(),
]);

这将创建一个具有特定开始和结束时间的事件。如果您想创建一个全天事件，必须使用startDate和endDate而不是startDateTime和endDateTime。

$event = new Event;

$event->name = 'A new full day event';
$event->startDate = Carbon\Carbon::now();
$event->endDate = Carbon\Carbon::now()->addDay();

$event->save();

您可以根据简单的文本字符串创建事件，如下所示

$event = new Event();

$event->quickSave('Appointment at Somewhere on April 25 10am-10:25am');

// statically
Event::quickCreate('Appointment at Somewhere on April 25 10am-10:25am');

获取单个事件

Google为每个单个事件分配一个唯一的ID。您可以通过使用get方法获取事件并从Spatie\GoogleCalendar\Event-对象获取id属性来获取此ID

// get the id of the first upcoming event in the calendar.
$eventId = Event::get()->first()->id;

您可以使用此ID从Google获取单个事件

Event::find($eventId);

更新事件

很简单，只需更改一些属性并调用save()

$event = Event::find($eventId);

$event->name = 'My updated title';
$event->save();

或者，您可以使用更新方法

$event = Event::find($eventId)

$event->update(['name' => 'My updated title']);

删除事件

没有其他事情要做！

$event = Event::find($eventId);

$event->delete();

限制

Google日历API提供了许多选项。此包不支持所有这些选项。例如，使用此包无法正确管理重复事件。如果您坚持创建具有名称和日期的事件，则应该没问题。

从v1升级到v2

v1和v2之间唯一的重大区别在于底层使用的是Google API v2而不是v1。以下是升级所需的步骤

将配置文件重命名为laravel-google-calendar
在配置文件中将client_secret_json键重命名为service_account_credentials_json

变更日志

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

测试

composer test

贡献

有关详细信息，请参阅贡献

安全

如果您发现任何安全相关的问题，请通过电子邮件freek@spatie.be报告，而不是使用问题跟踪器。

鸣谢

非常感谢Sebastiaan Luca在创建此包的v2版本时提供的巨大帮助。

许可证

MIT许可证（MIT）。请参阅许可证文件获取更多信息。

nidrax69/ laravel-google-calendar-wupdate

维护者

详细信息