ユーザー
ユーザー
📘SCIM を使用したユーザーとグループのプロビジョニング
SCIM API は、Notion のエンタープライズ プランのワークスペースで利用できます。SCIM を Notion で使用する方法について詳しくは、こちらをご覧ください。
📘Notion でシングル サインオン (SSO) を設定する
シングル サインオン (SSO) は、Notion のエンタープライズ プランのワークスペースに対して構成できます。Notion を使用した SSO の詳細については、こちらをご覧ください。
API でユーザー オブジェクトが表示される場所
created_byとlast_edited_byの下のブロック オブジェクト。created_byとlast_edited_byプロパティ項目の下およびpeople中のページ オブジェクト。created_byおよびlast_edited_byの下のデータベース オブジェクト。peopleプロパティの場合のプロパティ オブジェクト。objectキーとidキーが含まれます。残りのプロパティは、ユーザーがリッチ テキストまたはページ プロパティのコンテキストでレンダリングされており、ボットがそれらのプロパティにアクセスするための適切な機能を持っている場合に表示されることがあります。機能の詳細については、機能ガイドと認証ガイドを参照してください。すべてのユーザー
| パロパティ | 更新可能 | タイプ | 説明 | 例の値 |
|---|---|---|---|---|
object* | 表示のみ | "user" | 常に「ユーザー」 | "user" |
id* | 表示のみ | string(UUID) | このユーザーの一意の識別子。 | "e79a0b74-3aba-4149-9f74-0bb5791a6ee6" |
type | 表示のみ | string(オプション、列挙型) | ユーザーのタイプ。可能な値は"person"と"bot"です。 | "person" |
name | 表示のみ | string(オプション) | Notion に表示されるユーザー名。 | "Avocado Lovelace" |
avatar_url | 表示のみ | string(オプション) | 選択したアバター画像。 | "https://secure.notion-static.com/e6a352a8-8381-44d0-a1dc-9ed80e62b53d.jpg" |
人々
typeプロパティは"person" に設定されています。これらのオブジェクトには、次のプロ パティもあります。| パロパティ | 更新可能 | タイプ | 説明 | 例の値 |
|---|---|---|---|---|
person | 表示のみ | object | ボット以外のユーザーにのみ存在するプロパティ。 | |
person.email | 表示のみ | string | 個人の電子メール アドレス。これは、統合に電子メール アドレスへのアクセスを許可するユーザー機能がある場合にのみ存在します。 | "avo@example.org" |
ボット
typeプロパティは"bot"に設定されると、ユーザー オブジェクトがボットを表す場合です。ボット ユーザー オブジェクトには、次のプロパティがあります。| パロパティ | 更新可能 | タイプ | 説明 | 例の値 |
|---|---|---|---|---|
bot | 表示のみ | object | GET /v1/users/meま たはGET /v1/users/{{your_bot_id}}を使用している場合、このフィールドはowner、owner.type および workspace_nameを含むボットに関するデータを返します。これらのプロパティについては、以下で詳しく説明します。 | { "object": "user", "id": "9188c6a5-7381-452f-b3dc-d4865aa89bdf", "name": "Test Integration", "avatar_url": null, "type": "bot", "bot": { "owner": { "type": "workspace", "workspace": true }, "workspace_name": "Ada Lovelace’s Notion" } } |
owner | 表示のみ | object | このボットの所有者に関する情報。 | { "type": "workspace", "workspace": true } |
owner.type | 表示のみ | string列挙 | "workspace"または"user"のいずれかの所有者のタイプ。 | "workspace" |
workspace_name | 表示のみ | string列挙 | owner.typeが"workspace"の場合、workspace.nameボットを所有するワークスペースの名前を識 別します。owner.typeが"user"の場合、workspace.name はnullです。 |
更新日時 2023-04-28 07:07:46