INTEGRITY Dokumentace

Google Chat

Google Chat Pages Plugin vytvoří bota Google Chat, který dokáže odpovídat na zprávy. Obsahuje také API pro interakci s Google Chat (například pro vytváření zpráv) bez nutnosti zásahu uživatele. Toto API se hodí například pro upozornění.

Instalace

npm i @cloudflare/pages-plugin-google-chat

Použití

import googleChatPlugin from "@cloudflare/pages-plugin-google-chat";

export const onRequest: PagesFunction = googleChatPlugin(async (message) => {
	if (message.text.includes("ping")) {
		return { text: "pong" };
	}

	return { text: "Sorry, I could not understand your message." };
});

Plugin přijímá funkci, která zase přijímá příchozí zprávu a vrací Promise odpovědní zprávy (nebo void pokud nemá být žádná odpověď).

Plugin nabízí jedinou trasu, jejíž URL adresu byste měli nastavit v Google Cloud Console při vytváření bota.

Connection Settings v Google Cloud Console pro Google Chat API, kde je vybráno 'App URL' a do textového pole 'App URL' je zadáno 'https://example.com/google-chat'.

API

Google Chat API lze volat přímo pomocí GoogleChatAPI třída:

import { GoogleChatAPI } from "@cloudflare/pages-plugin-google-chat/api";

export const onRequest: PagesFunction = () => {
	// Initialize a GoogleChatAPI with your service account's credentials
	const googleChat = new GoogleChatAPI({
		credentials: {
			client_email: "SERVICE_ACCOUNT_EMAIL_ADDRESS",
			private_key: "SERVICE_ACCOUNT_PRIVATE_KEY",
		},
	});

	// Post a message
	// https://developers.google.com/chat/api/reference/rest/v1/spaces.messages/create
	const message = await googleChat.createMessage(
		{ parent: "spaces/AAAAAAAAAAA" },
		undefined,
		{
			text: "I'm an alert!",
		},
	);

	return new Response("Alert sent.");
};

Doporučujeme uchovávat přihlašovací údaje účtu služby v KV, nikoli jako čistý text podle příkladu výše.

Následující funkce jsou k dispozici na GoogleChatAPI instanci. Každá z nich přijímá až tři argumenty: objekt parametrů cesty, objekt parametrů dotazu a objekt těla požadavku, jak je popsáno v dokumentace k Google Chat API.