プロビジョニング解除されたユーザーからのコンテンツ転送

この記事では、ワークスペースオーナーが、エンタープライズプランのワークスペースからプロビジョニング解除されたメンバーのコンテンツを移管する方法について解説します 📖
プライベートページにコンテンツを残したまま、ユーザーが削除やプロビジョニング解除されたり、退出したりする場合があります。この機能を使用すれば、エンタープライズプランのワークスペースオーナーは、そのようなコンテンツを別のユーザーに転送して、簡単に復元できます。

備考: このプロセスは、ワークスペースを退出した後のユーザーのプライベートコンテンツに適用されます。現在のワークスペースメンバーと共有しているコンテンツは、転送できません。
以下の場合、ワークスペースオーナーは、ワークスペースを最近退出したユーザーのプライベートコンテンツを再割り当てできます。
ユーザーが現在ワークスペースのメンバーではない(プロビジョニング解除されている)。
ユーザーがプライベートページを持っていた。
ユーザーのプライベートページはまだ別のユーザーに再割り当てされていない。
ユーザーがワークスペースのメンバーではなくなってから30日経過していない。
エンタープライズプランのサブスクリプションのワークスペースである。
設定
に移動し、メンバー
セクションをクリックします。最近の退出
というタブに移動します。プロビジョニング解除されたユーザー(最近退出したユーザー)について、そのユーザーのプライベートページの転送先を選択します。
確認モーダルが表示されます。
プライベートページを転送する
を選択して、プライベートページの転送プロセスを続行します。プロビジョニング解除されたユーザーのプライベートページすべてが、転送先ユーザーのサイドバーに、新しく最上位のプライベートページにネストされた状態で表示されます。

備考: 自分が持っていたプライベートページをすべて再割り当てされたユーザーは、最近の退出
リストには表示されなくなります。
エンタープライズプランのワークスペースオーナーは、コンテンツ転送APIを使用して、最近削除されたワークスペースメンバーから別のメンバーにプライベートページを転送できます。このAPIには、上記と同じ適格性基準が必要です。
このAPIを使用するために、エンタープライズプランのワークスペースオーナーは:
転送コンテンツ
機能で 新しい内部インテグレーションを作成します。コンテンツの転送には、次のAPI呼び出しを使用します:
curl - X POST '<https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=v1 mem-invalid-attributes-holder=users mem-invalid-attributes-holder=transfer>
' \\
- H '承認:ベアラー <token>' \\
-H 'Notion-Version: 2022-06-28' \\
-H "Content-Type: application/json" \\
-d '{ "from_user_id":<from_user_id>,"to_user_id":<to_user_id>}'
From_user_id
は、削除されたユーザーを表します。SCIM Webhookを使用している場合、user_idはペイロードに含まれます。To_user_id
は、転送されたコンテンツの受信者を表します。このuser_idは、リストユーザーAPIエンドポイントを使うか、IDプロバイダーから提供されたAPIを使ってNotionパブリックAPIにクエリすることで取得できます。たとえば、OktaはlistAppUsers APIを提供します。appUserの外部IDは、NotionユーザーIDです。
curl '<https: mem-invalid-attributes-holder=api.notion.com mem-invalid-attributes-holder=v1 mem-invalid-attributes-holder=users>
' \\\\
- H '承認:ベアラー'"$ NOTION_API_KEY "''\\\\
-H "Notion-Version: 2022-06-28"
3.APIは、検証に失敗した場合に失敗応答を返します。fromユーザーがまだワークスペースにいる場合、またはワークスペースがエンタープライズプランにない場合、検証が失敗する可能性があります。検証された場合、APIは成功した応答を返し、転送の処理を開始します。移管が完了すると、移管されたコンテンツが受信者の非公開のNotionコンテンツに表示されます。受信者には、受信トレイ通知とメール通知も送信されます。
ユーザーがワークスペースを退出し、その後30日以内に再び参加する場合、ワークスペースオーナーはそのユーザーのプライベートページ、共有されたページ、グループメンバーシップ、チームスペースメンバーシップを復元できます。
復元方法はシンプルです。対象のメンバーをワークスペースに再び追加すれば、その時点でコンテンツとアクセスは自動的に復元されます。