Day23-介接 API（一）Google Calendar（I）启用 API 与 Events——Create

大家好～
接着一起来介接 API 吧！
今天先从 Google Calendar API 开始～

上图撷取自 Google Calendar API 的官方文件，
官方将我们能使用的资源分成八个类型，
该篇主要会以使用 Events 的 CRUD 为主，
其他资源的使用，
不会介绍到喔～

前言

Composer

composer require google/apiclient:^2.0

据官方表示，
该 Repo 内有超过200个的 Google 服务，
如果想清除其他不会用到的部分，
可以藉由修改 composer.json 来保留

{
    "require": {
        "google/apiclient": "^2.11"
    },
    "scripts": {
        "pre-autoload-dump": "Google\\Task\\Composer::cleanup"
    },
    "extra": {
        "google/apiclient-services": [
            "Calendar",
            "Sheets"
        ]
    }
}

extra 内放你要保留的服务。

rm -r vendor/google/apiclient-services

删除 apiclient-services 的资料夹，

composer update

再用 composer update 重新下载，
这样就会只保留在 extra 内指定的那些服务罗。

专案建立与启用 API

在 GCP 上新增专案。

建立完专案後，
启用 Google Calendar API。

之後会看到如下图之提醒。

然後点击同列右侧的建立凭证。

建立凭证

下一步

建立服务帐户#1

建立服务帐户#2

建立金钥

选择建立 JSON 类型的金钥。

专案的新增与金钥建立差不多就是这样的流程，
基本上只要跟着网站给的流程走就能完成罗！
也可以参考下面这篇官方文件：
Create a project and enable the API

新增日历

在 Google Calendar 页面新增一个日历。

对 ironman2021 这个日历选择设定和共用。

将刚刚建立的服务帐户加进共用日历。

等等会用到的 日历ID 也在这个页面喔～

Google Calendar Events 实作篇

金钥放专案内的话，
记得要加进 .gitignore 喔～
另外下面范例是把 日历ID 与 金钥位置 加到 .env。

先实例 Client 和 Calendar 吧～

use Google\Client;
use Google\Service\Calendar;
use Google\Service\Calendar\Event;
use Google\Service\Calendar\EventDateTime;

protected $client;
protected $googleCalendar;
protected $calendarId;
    
public function __construct()
{
    $this->client = new Client();
    $this->client->setAuthConfig(env('CLIENT_CREDENTIALS_PATH'));
    $this->client->addScope(Calendar::CALENDAR_EVENTS);
    $this->googleCalendar = new Calendar($this->client);
    $this->calendarId = env('GOOGLE_CALENDAR_ID');
}

Google Calendar Events－Create

public function insert(Request $request)
{
    $calendarEvent = new Event();

    $calendarEvent->setSummary($request->summary);

    $calendarEvent->setDescription($request->description);

    $startTime = new EventDateTime();
    $startTime->setDateTime($request->startTime);

    $endTime = new EventDateTime();
    $endTime->setDateTime($request->endTime);

    $calendarEvent->setStart($startTime);

    $calendarEvent->setEnd($endTime);

    $response = $this->googleCalendar->events->insert($this->calendarId, $calendarEvent);

    return $response->getHtmlLink();
}