共有コネクター - Base44 Support Documentation

共有コネクターは、アプリ全体に対して 1 つのアカウントを接続します。すべてのアプリユーザーが同じ OAuth トークンを共有します。会社の Slack チャンネルへの投稿、共有 Google カレンダーからの読み取り、共有 Notion ワークスペースへのクエリなど、サービスアカウントに使用してください。 共有コネクターをセットアップするには:

必要な各サービス用に JSONC ファイルを構成します
CLI 経由でデプロイして認可します
OAuth コネクターの場合は getConnection() を呼び出し、決済の場合は Stripe REST API を直接使用してバックエンド関数で使用します

構成

各コネクターは、プロジェクトの connectors ディレクトリ内の JSONC ファイルです。ファイルは、インテグレーションタイプとアプリが必要とするスコープを定義します。デフォルトでは、ディレクトリは base44/connectors/ ですが、プロジェクト構成でパスをカスタマイズできます。

connectors

googlecalendar.jsonc

slack.jsonc

slackbot.jsonc

notion.jsonc

例

この例では、読み取りとイベント管理スコープで Google Calendar コネクターを構成します:

{
  "type": "googlecalendar",
  "scopes": [
    "https://www.googleapis.com/auth/calendar.readonly",
    "https://www.googleapis.com/auth/calendar.events",
  ],
}

フィールドリファレンス

type

string

必須

インテグレーションタイプ識別子。受け入れられる完全な値リストについては、サポートされるサービステーブルを参照してください。各コネクタータイプは、プロジェクトで一度だけ定義できます。

scopes

array

必須

インテグレーションに必要な OAuth スコープの配列。特定のスコープは外部サービスとアプリが実行する必要のある操作に依存します。各サービスで利用可能なスコープについては、コネクターの権限とスコープドキュメントを参照してください。

デプロイと認可

connectors push または deploy でコネクターをデプロイします。Base44 から既存のコネクターをダウンロードするには、connectors pull を使用してください。プッシュすると、CLI はタイプに基づいて各コネクターを処理します:

OAuth コネクター: CLI は各コネクターを 1 つずつ認可するように促します。ブラウザを自動的に開くことを提案し、承諾すると各インテグレーションの認可ページを順次反復処理します。認可が完了すると、OAuth トークンが安全に保存され、SDK を使用して取得できます。
Stripe: CLI はアプリ用の Stripe sandbox をプロビジョニングし、オンボーディングを完了するための claim URL を返します。OAuth フローは不要です。

バックエンド関数で使用する

デプロイされて認可された後、バックエンド関数でコネクターを使用します。アプローチはコネクターの認証モデルによって異なります:

OAuth コネクター
Stripe

認証された API 呼び出しを行うための accessToken を取得するには、コネクタータイプで connectors.getConnection() を呼び出してください。一部のコネクターは、追加のパラメータ (サブドメインやアカウント ID など) を含む connectionConfig も返します。この例では、Google Calendar 接続を取得し、今後のイベントをフェッチします:

const { accessToken } =
  await base44.asServiceRole.connectors.getConnection("googlecalendar");

const timeMin = new Date().toISOString();
const url = `https://www.googleapis.com/calendar/v3/calendars/primary/events?maxResults=10&orderBy=startTime&singleEvents=true&timeMin=${timeMin}`;

const response = await fetch(url, {
  headers: { Authorization: `Bearer ${accessToken}` },
});

const events = await response.json();

Stripe は getConnection() を使用しません。代わりに、コネクターをプロビジョニングするときに、プラットフォームが Stripe API キーをアプリのシークレットとして保存します。バックエンド関数では、環境から STRIPE_SECRET_KEY を読み取り、Stripe REST API を直接呼び出してください。この例では、Stripe Checkout セッションを作成し、決済 URL を返します:

const STRIPE_SECRET_KEY = Deno.env.get("STRIPE_SECRET_KEY");

Deno.serve(async (req) => {
  const { priceId, successUrl, cancelUrl } = await req.json();

  const response = await fetch("https://api.stripe.com/v1/checkout/sessions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${STRIPE_SECRET_KEY}`,
      "Content-Type": "application/x-www-form-urlencoded",
    },
    body: new URLSearchParams({
      "payment_method_types[]": "card",
      "line_items[0][price]": priceId,
      "line_items[0][quantity]": "1",
      mode: "payment",
      success_url: successUrl || `${req.headers.get("origin")}?success=true`,
      cancel_url: cancelUrl || `${req.headers.get("origin")}?canceled=true`,
    }),
  });

  const session = await response.json();
  return Response.json({ url: session.url });
});

コネクター自動化

コネクター自動化を使用すると、バックエンド関数が接続されたサービスのイベントにリアルタイムで応答できます。例えば、Gmail に新しいメールが届いたときや Google Drive のファイルが変更されたときに関数を実行できます。 function.jsonc ファイルで、他の自動化と一緒にコネクター自動化を構成してください。完全なフィールドリファレンス、サポートされるイベント、ペイロードドキュメントについては、コネクター自動化を参照してください。

​構成

​例

​フィールドリファレンス

​デプロイと認可

​バックエンド関数で使用する

​コネクター自動化

​関連項目

構成

例

フィールドリファレンス

デプロイと認可

バックエンド関数で使用する

コネクター自動化

関連項目