プロビジョニング解除されたユーザーからのコンテンツ転送
この記事では、ワークスペースオーナーが、エンタープライズプランのワークスペースからプロビジョニング解除されたメンバーのコンテンツを移管する方法について解説します。
ユーザーが削除やプロビジョニング解除されたり、ワークスペースから退出したりすると、そのユーザーが所有していたページが残る場合があります。この機能を使うと、エンタープライズプランのワークスペースオーナーは、そのコンテンツを現在ワークスペースにいる別のユーザーに引き継ぎ、作業内容が失われないようにできます。
各ページがどうなるかは、誰がそのページを閲覧できたかによって決まります。
そのユーザーのみが閲覧できたページは、引き継ぎ先のユーザーに移動されます。これらのページは、引き継ぎ先のユーザーのプライベートセクションに「{name}から引き継いだページ」という新しいページの下にまとめて表示されます。
ユーザーが所有していたものの、すでに他のユーザーと共有されていたページは、元の場所に残ります。引き継ぎ先のユーザーは各ページへのフルアクセス権を取得し、同じ「{name}から引き継いだページ」というページに各ページへのリンクが追加されます。
一部のページは転送されません。
ほとんどのチームスペースページのように、親ページやチームスペースからアクセス権を継承しているページ。
ごみ箱内のページ。
ワークスペース全体がすでにフルアクセス権を持っているページ。
以下の場合、ワークスペースオーナーは、ワークスペースを最近退出したユーザーのコンテンツを再割り当てできます。
ユーザーが現在ワークスペースのメンバーではない(プロビジョニング解除されている)。
ユーザーがページを所有していたこと。
ユーザーのページがまだ別のユーザーに再割り当てされていないこと。
ユーザーがワークスペースのメンバーではなくなってから30日経過していない。
エンタープライズプランのサブスクリプションのワークスペースである。
設定に移動し、メンバーセクションをクリックします。最近の退出というタブに移動します。プロビジョニング解除されたユーザー(「最近退出したユーザー」)のページを受け取るメンバーを選択します。リストには各ユーザーの名前の横にメールアドレスが表示されるため、同姓同名のユーザーも区別できます。
確認ウィンドウで
ページを転送ボタンを選択して続行します。Notionは、「{name}から引き継いだページ」という新しいページを引き継ぎ先のユーザーのプライベートセクションに追加します。退出したユーザーのみが閲覧できたページはその中に移動されます。すでに他のユーザーと共有されていたページは元の場所に残り、このページには各ページへのリンクがまとめられます。引き継ぎ先のユーザーは、これらすべてのページにフルアクセスできるようになります。
備考:すべてのページが再割り当てされたユーザーは、最近退出したユーザーのリストに表示されなくなります。
エンタープライズプランのワークスペースオーナーは、Content Transfer APIを使って、最近ワークスペースから削除されたメンバーのページを別のメンバーに転送できます。このAPIを使うには、上記と同じ条件を満たす必要があります。
このAPIを使用するために、エンタープライズプランのワークスペースオーナーは:
転送コンテンツ機能で 新しい内部インテグレーションを作成します。
コンテンツの転送には、次のAPI呼び出しを使用します:
curl -X POST '<https://api.notion.com/v1/users/transfer>' \\
-H 'Authorization: Bearer <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エンドポイントを使用してNotion パブリックAPIに問い合わせるか、ご利用のIDプロバイダーが提供するAPIを使用して取得できます。たとえば、OktaはlistAppUsers APIを提供しています。AppUserのexternalIDは、NotionのユーザーIDです。
curl '<https://api.notion.com/v1/users>' \\\\
- H '承認:ベアラー'"$ NOTION_API_KEY "''\\\\
-H "Notion-Version: 2022-06-28"
3. 検証に失敗した場合、APIは失敗応答を返します。転送元のユーザーがまだワークスペースにいる場合や、ワークスペースがエンタープライズプランを利用していない場合は、検証に失敗することがあります。検証に成功すると、APIは成功応答を返し、転送処理を開始します。転送が完了すると、転送されたコンテンツが引き継ぎ先のユーザーのNotionに表示されます。引き継ぎ先のユーザーには、受信トレイとメールにも通知が届きます。
ユーザーがワークスペースを退出し、その後30日以内に再び参加する場合、ワークスペースオーナーはそのユーザーのプライベートページ、共有されたページ、グループメンバーシップ、チームスペースメンバーシップを復元できます。
これを行うには、設定 → ユーザーまたはメンバー(プランによって異なります)に移動し、メンバーをワークスペースに再度追加します。再追加後、同じ設定画面でその名前の横にある矢印を選択し、アクセスとコンテンツを復元します。

