--- sourceDocument: Xanadu API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/api-reference Release : - xanadu ft:locale : - ja-JP ft:publication_title : - Xanadu API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # AWA エージェント API # AWA エージェント API {#ariaid-title1} * リリースバージョン: Xanadu * * 更新日 2024年08月01日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：37分 AWA (Advanced Work Assignment) エージェント API は、エージェントの在席状況、チャネルの可用性、および作業負荷を管理するためのエンドポイントを提供します。この API には高度な作業アサイン (com.glide.awa) プラグインと awa_integration_user ロールが必要です。詳細については、 [高度なワークアサインを参照してください](https://www.servicenow.com/docs/access?context=awa-overview&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)。 ## AWA エージェント - GET /now/awa/agents/{user_id} {#ariaid-title2} 現在のエージェントの在席状況とチャネルの可用性を返します。 ### URL 形式 {#awa-GET-agents__section_hsf_jvl_cmb} バージョニングされた URL：/api/now/{api_version}/awa/agents/{user_id} デフォルトの URL：/api/now/awa/agents/{user_id} ### サポートされている要求パラメーター {#awa-GET-agents__entry__2}{#awa-GET-agents__version-RESTAPI}{#awa-GET-agents__awa-api-ph-work_item_id} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | user_id | AWA 作業アイテム \[awa_work_item\] テーブルにリストされている作業アイテムの sys_id。作業アイテムは次の基準を満たしている必要があります。 * 作業アイテムは、指定されたエージェントにアサインされている必要があります。 * 作業アイテムは、\[承認保留中\] ステータスになっている必要があります。 {#awa-GET-agents__ul_zcs_rh3_htb} データタイプ：文字列 | [表 : 1. パスパラメーター] {#awa-GET-agents__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#awa-GET-agents__presence__entry__2}{#awa-GET-agents__ph-presence_channels_avail-awa}{#awa-GET-agents__ph-presence_channels_sys_id-awa}{#awa-GET-agents__ph-presence_sys_id-awa} | ヘッダー | 説明 | |-|-| | presence.channels.available | チャネルが利用可能かどうかを示すフラグ。可能な値： * true：チャネルは利用可能です。 * false:チャネルは利用できません。 {#awa-GET-agents__ul_qps_xwl_cmb} データタイプ：ブーリアン | | presence.channels.sys_id | チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 | | presents.sys_id | 在席状況の sys_id。在席状況 \[awa_presence_state\] テーブルにあります。データタイプ：文字列 | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-GET-agents__entry__20}{#awa-GET-agents__accept-RESTAPI}{#awa-GET-agents__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 4. 要求ヘッダー] {#awa-GET-agents__entry__26} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-GET-agents__entry__30}{#awa-GET-agents__entry-200-status-code}{#awa-GET-agents__entry-400-status-code}{#awa-GET-agents__entry-401-status-code}{#awa-GET-agents__entry-403-status-code-awa}{#awa-GET-agents__entry-404-status-code}{#awa-GET-agents__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 403 | 禁止されています。考えられる理由: * ユーザーにawa_integration_userロールがありません。{#awa-GET-agents__li-403-role} * glide.awa.enabled プロパティの値が true ではありません。Advanced Work Assignment (com.glide.awa) プラグインがインストールされている場合、このプロパティはシステムのプロパティ \[sys_property\] テーブルにリストされます。詳細については、「 [高度なワークアサインメントとともにインストールされるコンポーネント](https://www.servicenow.com/docs/access?context=installed-with-awa&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。{#awa-GET-agents__li-403-awa-disabled} {#awa-GET-agents__ul_gch_n34_tsb} | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#awa-GET-agents__table_r2q_fbm_cmb__entry__2}{#awa-GET-agents__awa-api-entry-error}{#awa-GET-agents__awa-api-ph-error_detail}{#awa-GET-agents__awa-api-ph-error_message}{#awa-GET-agents__ph-presence-awa}{#awa-GET-agents__ph-presence_available-awa}{#awa-GET-agents__ph-presence_channels-awa}{#awa-GET-agents__d3393e337}{#awa-GET-agents__ph-presence_channels_name-awa}{#awa-GET-agents__d3393e405}{#awa-GET-agents__ph-presence_name-awa}{#awa-GET-agents__ph-presence_restrict_update-awa}{#awa-GET-agents__d3393e465}{#awa-GET-agents__awa-api-entry_status}{#awa-GET-agents__ph-sys_id-awa}{#awa-GET-agents__open-workItem_document-ph}{#awa-GET-agents__open-workItem_document_sysid-ph}{#awa-GET-agents__open-workItem_document_table-ph}{#awa-GET-agents__open-workItem_previousWorkItem-ph}{#awa-GET-agents__open-workItem_serviceChannel-ph}{#awa-GET-agents__open-workItem_serviceChannel_name-ph}{#awa-GET-agents__open-workItem_serviceChannel_sys_id-ph}{#awa-GET-agents__open-workItem_size-ph}{#awa-GET-agents__open-workItem_sysid-ph}{#awa-GET-agents__open-workItem_isQueueTransferred-ph} | パラメーター | 説明 | |-|-| | error | 要求プロセス中に発生したエラーを説明する詳細。データタイプ：オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求プロセス中に発生したエラーの詳細。データタイプ：文字列 | | error.message | 要求プロセス中に発生したエラーのメッセージ。各エラーメッセージには、detail プロパティに対応する説明があります。可能な値： * レコードが見つかりません:要求本文に指定された情報が不正確であるか、存在しません。 * ユーザーが認証されていません:ユーザーにawa_integration_userロールがありません。 {#awa-GET-agents__ul_om3_5sq_tsb} データタイプ：文字列 | | presence | エージェントの現在の在席状況とチャネルに関する情報。データタイプ：オブジェクト "presence": { "available": Boolean, "channels": [Array], "name": "String", "sys_id": "String" } | | presence.available | エージェントが利用可能かどうかを示すフラグ。可能な値： * true：エージェントは利用可能です。 * false:エージェントは利用できません。 {#awa-GET-agents__ul_ezb_kwl_cmb} データタイプ：ブーリアン | | presence.channels | エージェントとの利用可能な通信チャネルを説明するオブジェクトのリスト。データタイプ：アレイ "channels": [ { "available": Boolean, "name": "String", "sys_id": "String" } ] | | presence.channels.available | チャネルが利用可能かどうかを示すフラグ。可能な値： * true：チャネルは利用可能です。 * false:チャネルは利用できません。 {#awa-GET-agents__d3393e342} データタイプ：ブーリアン | | presence.channels.name | チャネル名 (チャットや電話など)。データタイプ：文字列 | | presence.channels.restrict_update | ユーザーが更新を制限できるかどうか、つまり可用性のチャネルを選択できるかどうかを示すフラグ。可能な値： * true：ユーザーはこの可用性のチャネルを選択できます。 * false：ユーザーはこの可用性のチャネルを選択できません。 {#awa-GET-agents__ul_xjk_kn4_tsb} データタイプ：ブール | | presence.channels.service_channel_type | サービスチャネルタイプ (チャットなど)。可能な値は、インストールされているプラグインによって異なります。データタイプ：文字列 | | presence.channels.sys_id | チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 | | presence.name | エージェントの在席状況の名前。可能な値： * 利用可能 * 利用不可 {#awa-GET-agents__ul_mlm_mxl_cmb} データタイプ：文字列 | | presence.restrict_update | ユーザーが更新を制限できるかどうかを示すフラグ。可能な値： * true：ユーザーは更新を制限できます。 * false:ユーザーは更新を制限できません。 {#awa-GET-agents__ul_dfh_cxl_cmb} データタイプ：ブーリアン | | presents.sys_id | 在席状況の sys_id。在席状況 \[awa_presence_state\] テーブルにあります。データタイプ：文字列 | | status | 失敗した要求のステータス。このプロパティは、エラーが発生した場合にのみ応答に含まれます。有効な値： failure データタイプ：文字列 | | sys_id | エージェント sys_id。データタイプ：文字列 | | 作業アイテム | workItem:イベントに関連付けられている作業アイテムに関する情報。{#awa-GET-agents__open-workItem-p} | | workItem.document | workItem.document:作業アイテムタスクに関連付けられたドキュメントのリスト。 | | workItem.document.sys_id | workItem.document.sys_id:作業アイテムタスクにアサインされたドキュメントのSys_id。 | | workItem.document.table | workItem.document.table:タスクに割り当てられたドキュメントテーブルの名前。 | | workItem.previousWorkItem | workItem.previousWorkItem:同じドキュメント ID の以前の作業アイテムのSys_id。非転送作業アイテムの場合、この値は空です。 | | workItem.serviceChannel | workItem.serviceChannel:作業アイテムタスクに関連付けられたサービスチャネルのリスト。 | | workItem.serviceChannel.name | workItem.serviceChannel.name:チャットや電話などのサービスチャネルの名前。 | | workItem.serviceChannel.sys_id | workItem.serviceChannel.sys_id:サービスチャネルのSys_id。 | | workItem.size | workItem.size:この作業アイテムがエージェントにアサインされたときに使用されるエージェントのキャパシティ。 | | workItem.sys_id | workItem.sys_id:承認または提供された作業アイテムのSys_id。 | | workItem.isQueueTransferred | workItem.isQueueTransferred:作業アイテムがキュー転送されているかどうかを示します。作業アイテムがキュー転送される場合は true に設定され、そうでない場合は false に設定されます。キュー転送の詳細については、「 [Transfer a chat to another queue](https://www.servicenow.com/docs/access?context=transfer-chat-queue&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)」を参照してください。 | [表 : 7. 応答本文のパラメーター (JSON または XML)] {#awa-GET-agents__table_r2q_fbm_cmb} ### サンプル cURL 要求 curl -X GET \ https://instance.servicenow.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666 \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password'\ { "result": { "presence": { "name": "Available", "sys_id": "0b10223c57a313005baaaa65ef94f970", "available": true, "channels": [ { "name": "Chat", "available": true, "sys_id": "27f675e3739713004a905ee515f6a7c3" } ] }, "sys_id": "46d44a23a9fe19810012d100cca80666" } } ## AWA エージェント - GET /now/awa/agents/{user_id}/capacities {#ariaid-title3} エージェントがケースを処理できるかどうかを確認するために、エージェントのチャネルキャパシティ、ユニバーサルキャパシティ、および現在の作業負荷を返します。 [AWA エージェント - PUT /now/awa/agents/{user_id}/capacities](https://servicenow-prod.fluidtopics.net/MimsPY1zx7b_xSCHRuVBTA#awa-PUT-capacities "エージェントのチャネルキャパシティとユニバーサルキャパシティの最大キャパシティ (作業負荷) を更新できます。") メソッドを使用して、エージェントのチャネルキャパシティとユニバーサルキャパシティを変更します。関連項目： * [サービスチャネルのキャパシティと使用率](https://www.servicenow.com/docs/access?context=awa-service-channel-capacity&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [サービスチャネルの作成または設定](https://www.servicenow.com/docs/access?context=awa-create-service-channel&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [エージェントの最大ユニバーサルキャパシティの設定](https://www.servicenow.com/docs/access?context=awa-universal-capacity&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) {#awa-GET-capacities__ul_rl1_2wg_jtb} ### URL 形式 {#awa-GET-capacities__section_hsf_jvl_cmb} バージョニングされた URL：/api/now/{api_version}/awa/agents/{user_id}/capacities デフォルトの URL：/api/now/awa/agents/{user_id}/capacities ### サポートされている要求パラメーター {#awa-GET-capacities__section_vg3_ydq_htb} {#awa-GET-capacities__table_wg3_ydq_htb__entry__2}{#awa-GET-capacities__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | user_id | ユーザー \[sys_user\] テーブルにリストされているエージェントの sys_id。データタイプ：文字列 | [表 : 8. パスパラメーター] {#awa-GET-capacities__table_wg3_ydq_htb} {#awa-GET-capacities__table_xg3_ydq_htb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 9. クエリパラメーター] {#awa-GET-capacities__table_xg3_ydq_htb} {#awa-GET-capacities__table_yg3_ydq_htb__entry__2} | 名前 | 説明 | |-|-| | なし | | [表 : 10. 要求本文パラメーター (XML または JSON)] {#awa-GET-capacities__table_yg3_ydq_htb} ### ヘッダー {#awa-GET-capacities__section_zg3_ydq_htb} 次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-GET-capacities__table_ah3_ydq_htb__entry__2}{#awa-GET-capacities__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 11. 要求ヘッダー] {#awa-GET-capacities__table_ah3_ydq_htb} {#awa-GET-capacities__table_bh3_ydq_htb__entry__2} | ヘッダー | 説明 | |-|-| | なし | | [表 : 12. 応答ヘッダー] {#awa-GET-capacities__table_bh3_ydq_htb} ### ステータスコード {#awa-GET-capacities__section_ch3_ydq_htb} この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-GET-capacities__table_dh3_ydq_htb__entry__2}{#awa-GET-capacities__entry-200-status-code}{#awa-GET-capacities__entry-400-status-code}{#awa-GET-capacities__entry-401-status-code}{#awa-GET-capacities__entry-403-status-code-awa}{#awa-GET-capacities__entry-404-status-code}{#awa-GET-capacities__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 403 | 禁止されています。考えられる理由: * ユーザーにawa_integration_userロールがありません。{#awa-GET-capacities__li-403-role} * glide.awa.enabled プロパティの値が true ではありません。Advanced Work Assignment (com.glide.awa) プラグインがインストールされている場合、このプロパティはシステムのプロパティ \[sys_property\] テーブルにリストされます。詳細については、「 [高度なワークアサインメントとともにインストールされるコンポーネント](https://www.servicenow.com/docs/access?context=installed-with-awa&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。{#awa-GET-capacities__li-403-awa-disabled} {#awa-GET-capacities__ul_gch_n34_tsb} | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 13. ステータスコード] {#awa-GET-capacities__table_dh3_ydq_htb} ### 応答本文のパラメーター (JSON または XML) {#awa-GET-capacities__section_agk_dmp_htb} {#awa-GET-capacities__table_bgk_dmp_htb__entry__2}{#awa-GET-capacities__ph-presence_channels_sys_id-awa}{#awa-GET-capacities__ordr-row-error}{#awa-GET-capacities__awa-api-ph-universal_capacity} | 名前 | 説明 | |-|-| | channels | エージェントとの利用可能な通信チャネルを説明するオブジェクトのリスト。 "channels": [ { "channel_sys_id": "String", "current_workload": Number, "max_capacity": Number } ] データタイプ：アレイ | | channels.channel_sys_id | チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 | | channels.current_workload | エージェントに現在アサインされている特定のサービスチャネルの作業アイテムの数。データタイプ：数値 | | channels.max_capacity | エージェントを一度にアクティブにアサインできる特定のサービスチャネルの最大作業負荷。データタイプ：文字列 | | error | 要求プロセス中に発生したエラーを説明する詳細。データタイプ：オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求プロセス中に発生したエラーの詳細。データタイプ：文字列 | | error.message | 要求プロセス中に発生したエラーのメッセージ。説明は error.detail プロパティで提供されます。データタイプ：文字列 | | status | 失敗した要求のステータス。このプロパティは、エラーが発生した場合にのみ応答に含まれます。有効な値： failure データタイプ：文字列 | | universal_capacity | すべてのサービスチャネルにおけるエージェントの最大キャパシティ。エージェントの現在の作業負荷が最大ユニバーサルキャパシティと等しい場合、追加の作業アイテムはエージェントに割り当てられません。このプロパティは、このエージェントのユニバーサルキャパシティレコードが存在する場合にのみ返されます。データタイプ：数値 | | universal_workload | 指定されたエージェントに現在アサインされているすべてのサービスチャネルにわたる作業アイテムの数。このプロパティは、エージェントのユニバーサルキャパシティレコードが存在する場合にのみ返されます。データタイプ：数値 | [ ] {#awa-GET-capacities__table_bgk_dmp_htb} ### サンプル cURL 要求 {#awa-GET-capacities__example_eh3_ydq_htb} 次の例は、ユーザーのキャパシティと作業負荷の値を取得する方法を示しています。 curl "https://instance.service-now.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666/capacities" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 成功した応答には、各チャネルのキャパシティ値と作業負荷が含まれます。 { "result": { "universal_workload": 2, "channels": [ { "channel_sys_id": "27f675e3739713004a905ee515f6a7c3", "current_workload": 2, "max_capacity": 4 } ], "universal_capacity": 10 } } ## AWAエージェント - GET /now/awa/agents/{user_id}/presence_states {#ariaid-title4} エージェントの在席状況を返し、エージェントが対応可能か、または別の在席状況にあるかを示します。 ### URL 形式 {#awa-GET-presence_states__section_hsf_jvl_cmb} バージョニングされた URL：/api/now/{api_version}/awa/agents/{user_id}/presence_states デフォルトの URL：/api/now/awa/agents/{user_id}/presence_states ### サポートされている要求パラメーター {#awa-GET-presence_states__entry__2}{#awa-GET-presence_states__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | user_id | ユーザー \[sys_user\] テーブルにリストされているエージェントの sys_id。データタイプ：文字列 | [表 : 14. パスパラメーター] {#awa-GET-presence_states__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 15. クエリパラメーター] {#awa-GET-presence_states__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 16. 要求本文パラメーター (XML または JSON)] ### ヘッダー次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-GET-presence_states__entry__16}{#awa-GET-presence_states__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 17. 要求ヘッダー] {#awa-GET-presence_states__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 18. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-GET-presence_states__entry__24}{#awa-GET-presence_states__entry-200-status-code}{#awa-GET-presence_states__entry-400-status-code}{#awa-GET-presence_states__entry-401-status-code}{#awa-GET-presence_states__entry-403-status-code-awa}{#awa-GET-presence_states__entry-404-status-code}{#awa-GET-presence_states__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 403 | 禁止されています。考えられる理由: * ユーザーにawa_integration_userロールがありません。{#awa-GET-presence_states__li-403-role} * glide.awa.enabled プロパティの値が true ではありません。Advanced Work Assignment (com.glide.awa) プラグインがインストールされている場合、このプロパティはシステムのプロパティ \[sys_property\] テーブルにリストされます。詳細については、「 [高度なワークアサインメントとともにインストールされるコンポーネント](https://www.servicenow.com/docs/access?context=installed-with-awa&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。{#awa-GET-presence_states__li-403-awa-disabled} {#awa-GET-presence_states__ul_gch_n34_tsb} | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 19. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#awa-GET-presence_states__section_agk_dmp_htb} {#awa-GET-presence_states__table_bgk_dmp_htb__entry__2}{#awa-GET-presence_states__ordr-row-error}{#awa-GET-presence_states__ph-presence_available-awa}{#awa-GET-presence_states__ph-presence_channels_avail-awa}{#awa-GET-presence_states__ph-presence_channels_name-awa}{#awa-GET-presence_states__ph-presence_channels_sys_id-awa}{#awa-GET-presence_states__ph-presence_sys_id-awa} | 名前 | 説明 | |-|-| | error | 要求プロセス中に発生したエラーを説明する詳細。データタイプ：オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求プロセス中に発生したエラーの詳細。データタイプ：文字列 | | error.message | 要求プロセス中に発生したエラーのメッセージ。説明は error.detail プロパティで提供されます。データタイプ：文字列 | | \ | オブジェクトとしてのエージェントの在席状況定義のリスト。各オブジェクトはステータスを表し、エージェントのチャネルを含んでいます。データタイプ：アレイ { "available": Boolean, "channels": [Array], "disable_inactivity_check": Boolean, "name": "String", "show_channels": Boolean, "sys_id": "String" } | | \.available | エージェントが利用可能かどうかを示すフラグ。可能な値： * true：エージェントは利用可能です。 * false:エージェントは利用できません。 {#awa-GET-presence_states__ul_ezb_kwl_cmb} データタイプ：ブーリアン | | \.channels | エージェントとの利用可能な通信チャネルを説明するオブジェクトのリスト。データタイプ：アレイ "channels": [ { "available": Boolean, "name": "String", "restrict_update": Boolean, "service_channel_type": "String", "sys_id": "String" } ] | | \.channels.available | チャネルが利用可能かどうかを示すフラグ。可能な値： * true：チャネルは利用可能です。 * false:チャネルは利用できません。 {#awa-GET-presence_states__ul_qps_xwl_cmb} データタイプ：ブーリアン | | \.channels.name | チャネル名 (チャットや電話など)。データタイプ：文字列 | | \.channels.sys_id | チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 | | \.disable_inactivity_check | この在席状況の非アクティビティチェックを行うかどうかを示すフラグ。有効な値： * true：在席状況の非アクティビティチェックは無効です。 * false：在席状況の非アクティビティチェックは有効です。 {#awa-GET-presence_states__ul_alm_cjn_jtb} データタイプ：ブーリアンデフォルト値：false この設定を変更する方法については、「 [エージェントの在席状況を構成する](https://www.servicenow.com/docs/access?context=awa-configure-agent-presence&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。 | | \.name | エージェントの在席状況の名前。デフォルトでインストールされる在席状況は、対応可能、退席中、オフラインです。データタイプ：文字列 | | \.order | エージェントの受信ボックスでこの状況を表示する順番。データタイプ：数値 | | \.show_channels | エージェントが在席状況を変更する (対応可能から退席中など) 権限を持っているかどうかを示すフラグ。有効な値： * true：ユーザーに在席状況を変更する権限があります。 * false：ユーザーは在席状況の変更を制限されています。 {#awa-GET-presence_states__ul_qlh_xlh_jtb} データタイプ：ブーリアン | | \.sys_id | 在席状況の sys_id。在席状況 \[awa_presence_state\] テーブルにあります。データタイプ：文字列 | | status | 失敗した要求のステータス。このプロパティは、エラーが発生した場合にのみ応答に含まれます。有効な値： failure データタイプ：文字列 | [ ] {#awa-GET-presence_states__table_bgk_dmp_htb} ### サンプル cURL 要求次の例は、指定されたエージェントの在席状況を取得する方法を示しています。 curl "https://instance.service-now.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666/presence_states" \ --request GET \ --header "Accept:application/json" \ --user 'username':'password' 応答の本文には、エージェントの可能な在席状況がリストされ、エージェントが対応可能であることが示されます。 { "result": [ { "name": "Available", "order": 0, "show_channels": false, "sys_id": "0b10223c57a313005baaaa65ef94f970", "available": true, "channels": [ { "name": "Chat", "available": true, "sys_id": "27f675e3739713004a905ee515f6a7c3", "restrict_update": false, "service_channel_type": "chat" } ], "disable_inactivity_check": false }, { "name": "Away", "order": 1000, "show_channels": false, "sys_id": "41f9b8dfb31313005baa6e5f26a8dcac", "available": false, "channels": [], "disable_inactivity_check": false }, { "name": "Offline", "order": 2000, "show_channels": false, "sys_id": "9cd83267575313005baaaa65ef94f98b", "available": false, "channels": [], "disable_inactivity_check": false } ] } ## AWA エージェント - PUT /now/awa/agents/{user_id} {#ariaid-title5} 指定されたエージェントの在席状況を設定し、指定した場合は、その状況のエージェントのチャネルの可用性を設定します。 ### URL 形式 {#awa-PUT-agents__section_qzs_ncm_cmb} バージョニングされた URL：/api/now/{api_version}/awa/agents/{user_id} デフォルトの URL：/api/now/awa/agents/{user_id} ### サポートされている要求パラメーター {#awa-PUT-agents__entry__2}{#awa-PUT-agents__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | user_id | エージェントの sys_id。ユーザー \[sys_user\] テーブルにあります。データタイプ：文字列 | [表 : 20. パスパラメーター] {#awa-PUT-agents__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 21. クエリパラメーター] {#awa-PUT-agents__entry__12}{#awa-PUT-agents__ph-presence_channels_sys_id-awa}{#awa-PUT-agents__ph-presence_sys_id-awa} | 名前 | 説明 | |-|-| | presence.channels | エージェントが利用できるチャネルを定義するオブジェクトのリスト。データタイプ：アレイ "channels": [ { "available": Boolean, "sys_id": "String" } ] | | presence.channels.available | チャネルが利用可能かどうかを示すフラグ。可能な値： * true：チャネルは利用可能です。 * false:チャネルは利用できません。 {#awa-PUT-agents__ul_qps_xwl_cmb} 注: 応答本文にチャネルを含めるには、この設定を指定する必要があります。データタイプ：ブーリアンデフォルト値：false | | presence.channels.sys_id | チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 | | presents.sys_id | 在席状況の sys_id。在席状況 \[awa_presence_state\] テーブルにあります。データタイプ：文字列 | [表 : 22. 要求本文パラメーター (XML または JSON)] ### ヘッダー次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-PUT-agents__entry__22}{#awa-PUT-agents__accept-RESTAPI}{#awa-PUT-agents__content_type-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | | Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 23. 要求ヘッダー] {#awa-PUT-agents__entry__28} | ヘッダー | 説明 | |-|-| | なし | | [表 : 24. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-PUT-agents__entry__32}{#awa-PUT-agents__entry-200-status-code}{#awa-PUT-agents__entry-400-status-code}{#awa-PUT-agents__entry-401-status-code}{#awa-PUT-agents__entry-403-status-code-awa}{#awa-PUT-agents__entry-404-status-code}{#awa-PUT-agents__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー資格情報が間違っているか、渡されていません。 | | 403 | 禁止されています。考えられる理由: * ユーザーにawa_integration_userロールがありません。{#awa-PUT-agents__li-403-role} * glide.awa.enabled プロパティの値が true ではありません。Advanced Work Assignment (com.glide.awa) プラグインがインストールされている場合、このプロパティはシステムのプロパティ \[sys_property\] テーブルにリストされます。詳細については、「 [高度なワークアサインメントとともにインストールされるコンポーネント](https://www.servicenow.com/docs/access?context=installed-with-awa&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US)」を参照してください。{#awa-PUT-agents__li-403-awa-disabled} {#awa-PUT-agents__ul_gch_n34_tsb} | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー。要求の処理中に予期しないエラーが発生しました。応答に、エラーに関する追加情報が含まれます。 | [表 : 25. ステータスコード] {#awa-PUT-agents__table_rcs_b2m_cmb__entry__2}{#awa-PUT-agents__awa-api-entry-error}{#awa-PUT-agents__awa-api-ph-error_detail}{#awa-PUT-agents__awa-api-ph-error_message}{#awa-PUT-agents__ph-presence-awa}{#awa-PUT-agents__ph-presence_available-awa}{#awa-PUT-agents__ph-presence_channels-awa}{#awa-PUT-agents__ph-presence_channels_avail-awa}{#awa-PUT-agents__ph-presence_channels_name-awa}{#awa-PUT-agents__d3393e405}{#awa-PUT-agents__ph-presence_name-awa}{#awa-PUT-agents__ph-presence_restrict_update-awa}{#awa-PUT-agents__d3393e465}{#awa-PUT-agents__awa-api-entry_status}{#awa-PUT-agents__ph-sys_id-awa}{#awa-PUT-agents__open-workItem_document-ph}{#awa-PUT-agents__open-workItem_document_sysid-ph}{#awa-PUT-agents__open-workItem_document_table-ph}{#awa-PUT-agents__open-workItem_previousWorkItem-ph}{#awa-PUT-agents__open-workItem_serviceChannel-ph}{#awa-PUT-agents__open-workItem_serviceChannel_name-ph}{#awa-PUT-agents__open-workItem_serviceChannel_sys_id-ph}{#awa-PUT-agents__open-workItem_size-ph}{#awa-PUT-agents__open-workItem_sysid-ph}{#awa-PUT-agents__open-workItem_isQueueTransferred-ph} | パラメーター | 説明 | |-|-| | error | 要求プロセス中に発生したエラーを説明する詳細。データタイプ：オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求プロセス中に発生したエラーの詳細。データタイプ：文字列 | | error.message | 要求プロセス中に発生したエラーのメッセージ。各エラーメッセージには、detail プロパティに対応する説明があります。可能な値： * レコードが見つかりません:要求本文に指定された情報が不正確であるか、存在しません。 * ユーザーが認証されていません:ユーザーにawa_integration_userロールがありません。 {#awa-PUT-agents__ul_om3_5sq_tsb} データタイプ：文字列 | | presence | エージェントの現在の在席状況とチャネルに関する情報。データタイプ：オブジェクト "presence": { "available": Boolean, "channels": [Array], "name": "String", "sys_id": "String" } | | presence.available | エージェントが利用可能かどうかを示すフラグ。可能な値： * true：エージェントは利用可能です。 * false:エージェントは利用できません。 {#awa-PUT-agents__ul_ezb_kwl_cmb} データタイプ：ブーリアン | | presence.channels | エージェントとの利用可能な通信チャネルを説明するオブジェクトのリスト。データタイプ：アレイ "channels": [ { "available": Boolean, "name": "String", "sys_id": "String" } ] | | presence.channels.available | チャネルが利用可能かどうかを示すフラグ。可能な値： * true：チャネルは利用可能です。 * false:チャネルは利用できません。 {#awa-PUT-agents__d3393e342} データタイプ：ブーリアン | | presence.channels.name | チャネル名 (チャットや電話など)。データタイプ：文字列 | | presence.channels.restrict_update | ユーザーが更新を制限できるかどうか、つまり可用性のチャネルを選択できるかどうかを示すフラグ。可能な値： * true：ユーザーはこの可用性のチャネルを選択できます。 * false：ユーザーはこの可用性のチャネルを選択できません。 {#awa-PUT-agents__ul_xjk_kn4_tsb} データタイプ：ブール | | presence.channels.service_channel_type | サービスチャネルタイプ (チャットなど)。可能な値は、インストールされているプラグインによって異なります。データタイプ：文字列 | | presence.channels.sys_id | チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 | | presence.name | エージェントの在席状況の名前。可能な値： * 利用可能 * 利用不可 {#awa-PUT-agents__ul_mlm_mxl_cmb} データタイプ：文字列 | | presence.restrict_update | ユーザーが更新を制限できるかどうかを示すフラグ。可能な値： * true：ユーザーは更新を制限できます。 * false:ユーザーは更新を制限できません。 {#awa-PUT-agents__ul_dfh_cxl_cmb} データタイプ：ブーリアン | | presents.sys_id | 在席状況の sys_id。在席状況 \[awa_presence_state\] テーブルにあります。データタイプ：文字列 | | status | 失敗した要求のステータス。このプロパティは、エラーが発生した場合にのみ応答に含まれます。有効な値： failure データタイプ：文字列 | | sys_id | エージェント sys_id。データタイプ：文字列 | | 作業アイテム | workItem:イベントに関連付けられている作業アイテムに関する情報。{#awa-PUT-agents__open-workItem-p} | | workItem.document | workItem.document:作業アイテムタスクに関連付けられたドキュメントのリスト。 | | workItem.document.sys_id | workItem.document.sys_id:作業アイテムタスクにアサインされたドキュメントのSys_id。 | | workItem.document.table | workItem.document.table:タスクに割り当てられたドキュメントテーブルの名前。 | | workItem.previousWorkItem | workItem.previousWorkItem:同じドキュメント ID の以前の作業アイテムのSys_id。非転送作業アイテムの場合、この値は空です。 | | workItem.serviceChannel | workItem.serviceChannel:作業アイテムタスクに関連付けられたサービスチャネルのリスト。 | | workItem.serviceChannel.name | workItem.serviceChannel.name:チャットや電話などのサービスチャネルの名前。 | | workItem.serviceChannel.sys_id | workItem.serviceChannel.sys_id:サービスチャネルのSys_id。 | | workItem.size | workItem.size:この作業アイテムがエージェントにアサインされたときに使用されるエージェントのキャパシティ。 | | workItem.sys_id | workItem.sys_id:承認または提供された作業アイテムのSys_id。 | | workItem.isQueueTransferred | workItem.isQueueTransferred:作業アイテムがキュー転送されているかどうかを示します。作業アイテムがキュー転送される場合は true に設定され、そうでない場合は false に設定されます。キュー転送の詳細については、「 [Transfer a chat to another queue](https://www.servicenow.com/docs/access?context=transfer-chat-queue&version=xanadu&pubname=xanadu-platform-user-interface&ft:locale=en-US)」を参照してください。 | [表 : 26. 応答本文のパラメーター (JSON または XML)] {#awa-PUT-agents__table_rcs_b2m_cmb} curl -X PUT \ https://instance.servicenow.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666 \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -u 'username':'password'\ -d '{"presence": {\ "sys_id": "0b10223c57a313005baaaa65ef94f970",\ "channels": [{ \ "sys_id": "0bbdedbb3b892300a2bac9bb34efc445",\ "available": true }] }} { "result": { "presence": { "name": "Available", "sys_id": "0b10223c57a313005baaaa65ef94f970", "available": true, "channels": [ { "name": "Chat", "available": true, "sys_id": "27f675e3739713004a905ee515f6a7c3" } ] }, "sys_id": "46d44a23a9fe19810012d100cca80666" } } ## AWA エージェント - PUT /now/awa/agents/{user_id}/capacities {#ariaid-title6} エージェントのチャネルキャパシティとユニバーサルキャパシティの最大キャパシティ (作業負荷) を更新できます。 [AWA エージェント - GET /now/awa/agents/{user_id}/capacities](https://servicenow-prod.fluidtopics.net/MimsPY1zx7b_xSCHRuVBTA#awa-GET-capacities "エージェントがケースを処理できるかどうかを確認するために、エージェントのチャネルキャパシティ、ユニバーサルキャパシティ、および現在の作業負荷を返します。") メソッドを使用して、エージェントの現在のチャネルキャパシティとユニバーサルキャパシティを取得します。関連項目： * [サービスチャネルのキャパシティと使用率](https://www.servicenow.com/docs/access?context=awa-service-channel-capacity&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [サービスチャネルの作成または設定](https://www.servicenow.com/docs/access?context=awa-create-service-channel&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) * [エージェントの最大ユニバーサルキャパシティの設定](https://www.servicenow.com/docs/access?context=awa-universal-capacity&version=xanadu&pubname=xanadu-servicenow-platform&ft:locale=en-US) {#awa-PUT-capacities__ul_rl1_2wg_jtb} ### URL 形式 {#awa-PUT-capacities__section_hsf_jvl_cmb} バージョニングされた URL：/api/now/{api_version}/awa/agents/{user_id}/capacities デフォルトの URL：/api/now/awa/agents/{user_id}/capacities ### サポートされている要求パラメーター {#awa-PUT-capacities__entry__2}{#awa-PUT-capacities__version-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプションアクセスするエンドポイントのバージョン。たとえば、v1 や v2。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | user_id | ユーザー \[sys_user\] テーブルにリストされているエージェントの sys_id。データタイプ：文字列 | [表 : 27. パスパラメーター] {#awa-PUT-capacities__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 28. クエリパラメーター] {#awa-PUT-capacities__entry__12} | 名前 | 説明 | |-|-| | channels | 指定されたエージェントの 1 つ以上のチャネルの最大値を更新する場合は必須です。エージェントに割り当てられた各チャネルについて、チャネルを最大キャパシティにマッピングする 1 つ以上のキーと値のペアを含む JSON オブジェクト。データタイプ：オブジェクトペアは次の形式です。 * キー (チャネル sys_id) -- チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 * 値 (最大キャパシティ) -- エージェントを一度にアクティブにアサインできる特定のサービスチャネルの最大作業負荷。データタイプ：数値 {#awa-PUT-capacities__ul_e35_r3g_jtb} channels: {"": } | | universal_capacity | ユニバーサルキャパシティを更新する場合は必須です。すべてのサービスチャネルにおけるエージェントの最大キャパシティ。エージェントの現在の作業負荷が最大ユニバーサルキャパシティと等しい場合、追加の作業アイテムはエージェントに割り当てられません。データタイプ：数値 | [表 : 29. 要求本文パラメーター (XML または JSON)] ### ヘッダー次のリクエストや応答ヘッダーは、この HTTP アクションにのみ適用されるか、またはこのアクションに別個の方法で適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-PUT-capacities__entry__18}{#awa-PUT-capacities__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 30. 要求ヘッダー] {#awa-PUT-capacities__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 31. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/ldF_qFEQnejbeXLBxcUhWg "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供し、相互の通信を容易にするシンプルなステートレスアーキテクチャです。")」を参照してください。 {#awa-PUT-capacities__entry__26}{#awa-PUT-capacities__entry-200-status-code}{#awa-PUT-capacities__entry-400-status-code}{#awa-PUT-capacities__entry-404-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 404 | 見つかりません。要求アイテムが見つかりませんでした。 | [表 : 32. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#awa-PUT-capacities__section_agk_dmp_htb} {#awa-PUT-capacities__table_bgk_dmp_htb__entry__2}{#awa-PUT-capacities__ph-presence_channels_sys_id-awa}{#awa-PUT-capacities__ordr-row-error}{#awa-PUT-capacities__awa-api-ph-universal_capacity} | 名前 | 説明 | |-|-| | channels | エージェントとの利用可能な通信チャネルを説明するオブジェクトのリスト。 "channels": [ { "channel_sys_id": "String", "max_capacity": Number } ] データタイプ：アレイ | | channels.channel_sys_id | チャネルの sys_id。サービスチャネル \[awa_service_channel\] テーブルにあります。データタイプ：文字列 | | channels.max_capacity | エージェントを一度にアクティブにアサインできる特定のサービスチャネルの最大作業負荷。データタイプ：文字列 | | error | 要求プロセス中に発生したエラーを説明する詳細。データタイプ：オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 要求プロセス中に発生したエラーの詳細。データタイプ：文字列 | | error.message | 要求プロセス中に発生したエラーのメッセージ。説明は error.detail プロパティで提供されます。データタイプ：文字列 | | status | 失敗した要求のステータス。このプロパティは、エラーが発生した場合にのみ応答に含まれます。有効な値： failure データタイプ：文字列 | | universal_capacity | すべてのサービスチャネルにおけるエージェントの最大キャパシティ。エージェントの現在の作業負荷が最大ユニバーサルキャパシティと等しい場合、追加の作業アイテムはエージェントに割り当てられません。このプロパティは、このエージェントのユニバーサルキャパシティレコードが存在する場合にのみ返されます。データタイプ：数値 | [ ] {#awa-PUT-capacities__table_bgk_dmp_htb} ### サンプル cURL 要求次の例は、エージェントのユニバーサルキャパシティおよび指定されたチャネルの最大キャパシティを変更する方法を示しています。 curl "https://instance.service-now.com/api/now/awa/agents/46d44a23a9fe19810012d100cca80666/capacities" \ --request PUT \ --header "Accept:application/json" \ --header "Content-Type:application/json" \ --data "{ \"channels\": { \"27f675e3739713004a905ee515f6a7c3\": 6 }, \"universal_capacity\" : 12 }" \ --user 'username':'password' 成功応答には、更新されたキャパシティ値が含まれます。 { "result": { "channels": [ { "channel_sys_id": "27f675e3739713004a905ee515f6a7c3", "max_capacity": 6 } ], "universal_capacity": 12 } }