対象読者：この記事は、現在iSAMS連携機能をご利用中のSchoolsBuddy既存顧客を対象としています。
iSAMS 、すべてのバッチAPIをOAuth 2.0にアップグレードします。OAuth 2.0は、データセキュリティの強化、接続の信頼性の向上、学校のデータへのアクセス制御の改善を提供する最新の業界標準です。
今後予定されているiSAMS通信障害期間中もデータ同期が中断なく継続されるようにするため、 2026年10月14日までに以下の手順を完了してください。
パート1： iSAMSでOAuth 2.0クライアントシークレットを生成する
- 管理者としてiSAMSにログインし、コントロールパネルを開きます。
- APIサービスマネージャーを選択してください。
- 「バッチAPIキーの管理」を選択してください。
- SchoolsBuddyの既存のバッチAPIキーを見つけて、右側の金色の鍵アイコンをクリックしてください。
- この API キーの新しいシークレットを作成するかどうかを尋ねるポップアップウィンドウで、 [はい]をクリックします。
- クライアントIDとクライアントシークレットが表示されます。
⚠️重要: パート 2 を完了するまで、このウィンドウまたはブラウザ タブを閉じないでください。
パート2： SchoolsBuddyにあなたの認証情報を追加する
SchoolsBuddyにスーパー管理者としてログインしてください。
- 設定に移動
- はじめに > データ統合
- インポート有効化のトグルスイッチがオン（緑色）に設定されていることを確認してください。
学校のiSAMSホスティングURLが正しいことを確認してください。
APIキーのセクションまでスクロールしてください（すべての有効なデータエンティティは既に有効になっているはずです）。
クライアントIDを確認してください（この欄は既に入力されているはずです）。
パート1（ステップ6）で生成したクライアントシークレットを、該当するフィールドに貼り付けてください。
保護者インポートフィルター：これらのフィルターは、初期導入時に学校の希望に合わせて設定されています。学校のインポート要件に変更がない限り、これらの設定はそのままにしておいてください。
- 職員インポートフィルター：学校のメールアドレスのドメインは既にここに追加されています。職員のドメインを更新する場合を除き、このセクションを変更しないでください。
- 年度末処理：現時点では、ここで変更する必要はありません。年度末の学籍繰り越し時期になりましたら、 [ iSAMS年度末処理ガイド]をご参照ください。
- ページの一番下までスクロールして、「変更を保存」をクリックしてください。
iSAMSとの連携機能が更新され、今後のOAuth 2.0への移行に対応できるようになりました！
🚀 新機能：手動トリガーによるiSAMSインポート
SchoolsBuddy内でiSAMSからオンデマンドのデータインポートを手動で実行できるようになりました！ iSAMSで緊急の変更を行い、それをSchoolsBuddyにすぐに反映させる必要がある場合は、以下の機能をご利用ください。
設定>はじめに>データ統合に移動します。
ページ下部の「インポートを実行」ボタンをクリックしてください。
⏱️ 手動インポートに関する重要な注意事項：
レート制限：インポート実行ボタンは5分に1回しか押すことができません。
処理時間：学校の規模やデータセットによって異なりますが、インポートには10分から20分かかる場合があります。
iSAMSフィードの更新遅延： SchoolsBuddyに更新内容が反映されるには、まずiSAMS APIフィードに変更が反映される必要があります。iSAMS iSAMSでデータを直接更新しても、 SchoolsBuddyが取得できるフィードに即座に反映されるわけではありません。インポートを実行する前に、 iSAMSフィードを更新するまでしばらくお待ちください。
-
プロのヒント： APIキーキャッシュの有効期限を短くすることで、 iSAMSフィードの更新頻度を短縮できます。（デフォルト：24時間）