OAuth 2.0 クライアントクレデンシャルグラントは、このAPIのクライアントを認証するために使用されます。認証されたユーザーが、要求された操作を実行するための適切な権限を持っているかどうかが確認されます。権限の完全なリストはこちらでご確認いただけます。権限は、1つ以上の役割を介してユーザーに割り当てられます。

この方法では、コンタクトセンターの設定に新規のユーザーを作成します。

このメソッドは、ユーザーのIDを指定することで、そのユーザーに関する詳細な設定情報を返します。

データの照会対象となるユーザーのID（例：5974D6AE-66BD-4B2A-A9D6-1AEADD18F669）

既存のユーザーのすべての属性を、指定された置換属性セットで置き換えます。RFC7644に従い、PUTメソッドは、ユーザーの現在のすべての属性を、本文で指定された属性に置き換えることでユーザーを更新することにご注意ください。

また、ユーザー名を変更するには、サービスプロバイダーがお客様のコンタクトセンターに対してこの機能を許可している必要があります。詳細については、『_コンタクトセンター管理者ガイド_』の「ユーザー」のセクションをご参照ください。

データを更新するユーザーのid（例：5974D6AE-66BD-4B2A-A9D6-1AEADD18F669）

既存のユーザーの属性を更新します。なお、RFC7644に従い、PATCHメソッドは、クライアントが指定した変更内容に基づいてユーザーを変更します（部分更新）。

また、ユーザー名を変更するには、サービスプロバイダーがお客様のコンタクトセンターに対してこの機能を許可している必要があります。詳細については、『_コンタクトセンター管理者ガイド_』のセクション「ユーザー」を参照してください。

削除対象のユーザーのID（例：7D6A5564-2104-442F-82DA-D55B6D7CFAE9）

このメソッドは、userNameフィルターを使用して、既存のユーザーに関する詳細な設定情報を返します。

https://<tenant_url>/configapi/v2/scim/users エンドポイントを使用すると、以下の操作を行うことができます：

以下に、この API 経由でアクセス可能なユーザー属性について説明します。特に記載がない限り、すべての属性は文字列です。また、特に記載がない限り、すべての属性は必須です。注：特定の SCIM フィールドがリストにない場合、BPCC ではそのフィールドはサポートされていません。

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

SCIM	BPCC Mapping	Required	Read/Write	Notes
active	Disabled	No	Read/write	反転関係に注意してください。active = true は Disabled = false に相当し、その逆も同様です
addresses/Country	Country	No	Read/write	「addresses/primary」のメモを参照してください
addresses/locality	City	No	Read/write	「addresses/primary」のメモを参照してください
addresses/primary	See Notes			SCIM では、複数の物理アドレスの指定が可能です。配列に複数のアドレスが含まれている場合、BPCC は「primary」属性が「true」に設定されているアドレスから上記の属性を取得します。どのアドレスにも「primary」属性が設定されていない場合、BPCC は配列の最初のアドレスから上記の属性を取得します。
addresses/region	State/Province	No	Read/write	「addresses/primary」のメモを参照してください
emails/primary	See Notes			SCIM では、複数のメールアドレスの指定が可能です。配列に複数のメールアドレスが含まれている場合、BPCC は「primary」属性が「true」に設定されているメールアドレスを採用します。どのメールアドレスにも「primary」属性が設定されていない場合、BPCC は配列の最初のメールアドレスを採用します。
emails/value	Email address	Yes	Read/write	「emails/primary」のメモを参照してください
externalId	See \"userName\"	No	Read only	この属性はリクエストでは無視され、レスポンスでは常に空の文字列が設定されます。
id	UUID of the user object in the Configuration Database	No	Read only	レスポンスにのみ表示されます
meta/location	Equal to the \"Location\" header of a newly created resource	No	Read only	https://tools.ietf.org/html/rfc7231#section-3.1.4.2
meta/resourceType	See Notes	No	Read only	レスポンスにのみ表示されます。常に「USER」に設定されます。
name/familyName	Last name	No	Read/write	Create User メソッドで指定する必要があります
name/givenName	First name	No	Read/write	Create User メソッドで指定する必要があります
nickName	Chat nickname	No	Read/write
password	Password	No	Write only	新規作成されたユーザーのパスワード設定は任意です。たとえば、コンタクトセンターのユーザーがシングルサインオン (SSO) 経由でログインする場合などには、空のパスワードを使用できます。パスワードが指定されない場合は、自動的に生成されます。パスワードが指定される場合は、サービスプロバイダーが定義するパスワードの複雑性要件をすべて満たす必要があります。パスワードは、いかなる SCIM レスポンスにも返されません。
phoneNumbers/type	See Notes			- 「extension」に設定された場合、「phoneNumbers/value」属性は「Phone extension」にマッピングされます。指定された番号が別のユーザーに割り当てられている場合、Create/Update リクエストはエラーを返します。 - 「default」に設定された場合、「phoneNumbers/value」属性は「Default hardphone number」にマッピングされます。 - 「work」に設定された場合、「phoneNumbers/value」属性は「Work phone」にマッピングされます。 - 「mobile」に設定された場合、「phoneNumbers/value」属性は「Mobile phone」にマッピングされます。 - その他すべてのタイプは無視されます。
phoneNumbers/value	See Notes for “phoneNumbers/type”	No	Read/write
photos/type	See Notes for “photo/value”			「Photo」属性を呼び出す際、以下の属性がサポートされています： - photo - thumbnail SCIM では、複数の写真を指定することができます。配列に複数の写真が含まれている場合、BPCC は「primary」属性が「true」に設定されている写真を採用します。どの写真にも「primary」属性が「true」に設定されていない場合、BPCC は配列の最初の写真を採用します。
photos/value	Photo	No	Write only	SCIM では、写真の値は URI です。SCIM は、写真の抽出プロセスに関する特別なガイドラインを定めていません。BPCC 側では、以下のガイドラインに従います。 - 作成/更新リクエストに写真配列の値が含まれている場合、BPCC は直ちに URI から写真を抽出し、ローカルに保存しようと試行します。何らかの理由で試行が失敗した場合、BPCC はエラーコード（URL が不正な場合は 400、画像が見つからない場合は 404）を返します。 - 写真配列内の複数の値を扱う方法については、「photo/type」のメモを参照してください。
roles	Roles	No	Read/write	BPCC の設定で定義された役割の名前を含む配列です。存在しない役割を指定した場合、404 エラー「Role not found」が返されます
schemas	See Notes	Yes	N/A	以下のように設定してください：[\"urn:ietf:params:scim:schemas:core:2.0:User\"]
timezone	Time zone	No	Read/write	SCIM と BPCC はいずれも IANA（Olson）のタイムゾーンを使用しているため、変換は不要です
title	Title	No	Read/write
userName	Username	Yes	Read/write	Create User メソッドで指定する必要があります。Update User メソッド経由で変更可能です

はじめに

前提条件

メモ

チームの割り当て

役割の割り当て

ユーザー名の変更

パスワード

ソフトフォン

Microsoft Azure