--- sourceDocument: オーストラリア API リファレンス sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference Release : - australia ft:locale : - ja-JP ft:publication_title : - オーストラリア API リファレンス ft:clusterId : - crapiref bundleId : - crapiref workflow : - Creator --- # 連絡先 API # 連絡先 API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：44分連絡先 API には、カスタマーサービス管理 (CSM)連絡先レコードを取得および更新できるエンドポイントが用意されています。さらに、連絡先の作成時に新しいソーシャルメディアプロファイルレコードを生成できます。連絡先 API にはカスタマーサービスプラグイン (com.sn_customerservice) が必要で、`これは now` 名前空間内で提供されます。ユーザーには、完全な API アクセスのための csm_ws_integration ロールが必要です。 ## 連絡先:GET /now/contact {#ariaid-title2} 指定されたカスタマーサービス管理 (CSM) 連絡先のセットを取得します。 ### URL 形式バージョニングされた URL: /api/now/{api_version}/contact デフォルト URL: /api/now/contact 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#contact-GET__entry__2}{#contact-GET__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | [表 : 1. パスパラメーター] {#contact-GET__entry__6}{#contact-GET__sysparm-limit-entry}{#contact-GET__sysparm-offset-entry}{#contact-GET__sysparm-query-entry} | 名前 | 説明 | |-|-| | sysparm_limit | 返されるレコードの最大数。このレコード数を超える要求の場合は、 sysparm_offset パラメーターを使用してレコード取得をページネーションします。応答では、ブールパラメーター hasMore が返されます。フィルター基準を満たす、返されるレコードが他にあるかどうかを示します。データタイプ：数値デフォルト：10 | | sysparm_offset | レコード取得を開始する開始レコードインデックス。この値を使用して、レコード取得をページネーションします。この機能を使用すると、レコードの数に関係なく、すべてのレコードを小さな管理可能なチャンクで取得できます。たとえば、このエンドポイントを初めて呼び出すとき、 sysparm_offset は「0」に設定されます。使用可能なすべてのレコードを単純にページングするには、すべてのレコードの最後に到達するまで `sysparm_offset=sysparm_offset+sysparm_limit` を使用します。 sysparm_offsetパラメーターに負の数を渡さないでください。データタイプ：数値デフォルト：0 | | sysparm_query | 結果セットのフィルタリングに使用されるエンコードクエリ。例： `sysparm_query=caller_id=javascript:gs.getUserID()^active=true` エンコードされたクエリは順番をサポートしています。特定のフィールドに基づいて応答をソートするには、sysparm_queryで ORDERBY 句と ORDERBYDESC 句を使用します。たとえば、 `sysparm_query=active=true^ORDERBYnumber^ORDERBYDESCcategory` は、すべてのアクティブなレコードをフィルタリングし、結果を最初に番号の昇順に並べ替え、次にカテゴリ別の降順に並べ替えます。無効なフィールド名を指定するなどしてクエリーの一部が無効な場合、インスタンスは無効な部分を無視します。次に、クエリの有効な部分のみを使用して行を返します。この動作は、プロパティ glide.invalid_query.returns_no_rows を使用して制御できます。無効なクエリで行を返さない場合は、このプロパティを true に設定します。注: glide.invalid_query.returns_no_rows プロパティは、リスト、スクリプト (GlideRecord.query())、Web サービス API など、インスタンス全体のすべてのクエリの動作を制御します。データタイプ：文字列 | [表 : 2. クエリパラメーター] {#contact-GET__entry__14} | 名前 | 説明 | |-|-| | なし | | [表 : 3. 要求本文パラメーター (XML または JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#contact-GET__entry__18}{#contact-GET__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 4. 要求ヘッダー] {#contact-GET__entry__22} | ヘッダー | 説明 | |-|-| | なし | | [表 : 5. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#contact-GET__entry__26}{#contact-GET__entry-200-status-code}{#contact-GET__entry-500-status-code}{#contact-GET__d3014e916} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON または XML) エンドポイントは、応答本文で次の JSON または XML 要素を返す場合があります。以下で定義する要素のリスト (ベースシステムの要素を定義する) に加えて、エンドポイントは連絡先 \[customer_contact\] テーブルに追加されたカスタムフィールドも返します。これらの要素の詳細については、特定のテーブル定義 \[システム定義テーブル\]. {#contact-GET__csmcontact_response_parms__entry__2}{#contact-GET__contacttable-account-enrty}{#contact-GET__contacttable-active-entry}{#contact-GET__contacttable-agent_status-entry}{#contact-GET__contacttable-building-entry}{#contact-GET__contacttable-calendar_integration-entry}{#contact-GET__contacttable-city-entry}{#contact-GET__contacttable-company-entry}{#contact-GET__contacttable-cost_center-entry}{#contact-GET__contacttable-country-entry}{#contact-GET__contacttable-date_format-entry}{#contact-GET__contacttable-default_perspective-entry}{#contact-GET__contacttable-department-entry}{#contact-GET__contacttable-edu_status-entry}{#contact-GET__contacttable-email-entry}{#contact-GET__contacttable-employee_number-entry}{#contact-GET__contacttable-enable_multifactor_authn-entry}{#contact-GET__contacttable-failed_attempts-entry}{#contact-GET__contacttable-first_name-entry}{#contact-GET__contacttable-gender-entry}{#contact-GET__contacttable-geolocation_tracked-entry}{#contact-GET__contacttable-home_phone-entry}{#contact-GET__contacttable-internal_integration_user-entry}{#contact-GET__contacttable-introduction-entry}{#contact-GET__contacttable-last_login-entry}{#contact-GET__contacttable-last_login_device-entry}{#contact-GET__contacttable-last_login_time-entry}{#contact-GET__contacttable-last_name-entry}{#contact-GET__contacttable-last_position_update-entry}{#contact-GET__contacttable-latitude-entry}{#contact-GET__contacttable-ldap_server-entry}{#contact-GET__contacttable-location-entry}{#contact-GET__contacttable-locked_out-entry}{#contact-GET__contacttable-longitude-entry}{#contact-GET__contacttable-manager-entry}{#contact-GET__contacttable-middle_name-entry}{#contact-GET__contacttable-mobile_phone-entry}{#contact-GET__contacttable-name-entry}{#contact-GET__contacttable-notification-entry}{#contact-GET__contacttable-on_schedule-entry}{#contact-GET__contacttable-phone-entry}{#contact-GET__contacttable-photo-entry}{#contact-GET__contacttable-preferred_language-entry}{#contact-GET__contacttable-roles-entry}{#contact-GET__contacttable-schedule-entry}{#contact-GET__contacttable-source-entry}{#contact-GET__contacttable-state-entry}{#contact-GET__contacttable-street-entry}{#contact-GET__contacttable-sys_class_name-entry}{#contact-GET__contacttable-sys_created_by-entry}{#contact-GET__contacttable-sys_created_on-entry}{#contact-GET__contacttable-sys_domain-entry}{#contact-GET__contacttable-sys_domain_path-entry}{#contact-GET__contacttable-sys_id-entry}{#contact-GET__contacttable-sys_mod_count-entry}{#contact-GET__contacttable-sys_updated_by-entry}{#contact-GET__contacttable-sys_updated_on-entry}{#contact-GET__contacttable-time_format-entry}{#contact-GET__contacttable-time_sheet_policy-entry}{#contact-GET__contacttable-time_zone-entry}{#contact-GET__contacttable-title-entry}{#contact-GET__contacttable-user_name-entry}{#contact-GET__contacttable-vip-entry}{#contact-GET__contacttable-web_service_access_only-entry}{#contact-GET__contacttable-zip-entry} | 要素 | 説明 | |-|-| | アカウント | 連絡先が関連付けられているアカウントレコードのSys_id。データタイプ：文字列テーブル:アカウント \[customer_account\] | | アクティブ | 連絡先がシステム内でアクティブかどうかを示すフラグ。可能な値： * true:連絡先はアクティブです * false:連絡先は非アクティブですデータタイプ：ブーリアンデフォルト：true | | agent_status | エージェントのステータス。可能な値： * 業務時間外 * ブレーク時 * 移動中 * 現地データタイプ：文字列最大長：40 | | 建物 | 連絡先が所在する建物を説明するレコードのSys_id。データタイプ：文字列テーブル:建物 \[cmn_building\] | | calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値：1 | | city | 連絡先が所在する市区町村。データタイプ：文字列最大長：40 | | 会社 | 連絡先が関連付けられている会社レコードのSys_id。データタイプ：文字列テーブル:会社 \[core_company\] | | cost_center | 連絡先に関連付けられたコストセンターのSys_id。データタイプ：文字列テーブル:コストセンター \[cmn_cost_center\] | | country | 連絡先が所在する国の国コード。データタイプ：文字列最大長:3 | | date_format | 連絡先に日付を表示する形式。有効な値： * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd データタイプ：文字列最大長：40 デフォルト:空 (システムの日付形式) | | default_perspective | 連絡先のデフォルトの視点のSys_id。データタイプ：文字列テーブル:メニューリスト \[sys_perspective\] | | department | 連絡先に関連付けられている部門のSys_id。データタイプ：文字列テーブル:部門 \[cmn_department\] | | edu_status | 関連付けられた連絡先の教育ステータス。データタイプ：文字列最大長：40 デフォルト:faculty | | email | 連絡先のメールアドレス。データタイプ：文字列 | | employee_number | 連絡先の従業員番号。データタイプ：文字列 | | enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。可能な値： * true:マルチファクター認証が有効 * false:多要素認証が無効ですデータタイプ：ブーリアンデフォルト値：false | | failed_attempts | ログイン試行の失敗回数。データタイプ:数値 (整数) | | first_name | 連絡先の名。データタイプ：文字列最大長:50 | | 性別 | 連絡先の性別。データタイプ：文字列最大長：40 | | geolocation_tracked | 連絡先の場所がジオトラッキングによって取得されているかどうかを示すフラグ。可能な値： * true:ジオトラッキングによって取得された連絡先の場所 * false:連絡先の場所がジオトラッキングによって取得されないデータタイプ：ブーリアンデフォルト値：false | | home_phone | 自宅の電話番号に連絡してください。データタイプ：文字列最大長：40 | | internal_integration_user | 連絡先が内部統合ユーザーであるかどうかを示すフラグ。可能な値： * true:内部統合ユーザー * false:その他のタイプのユーザーデータタイプ：ブーリアンデフォルト値：false | | はじめに | 導入データタイプ：文字列最大長：40 | | last_login | 連絡先が最後にシステムにログインした日付。データタイプ:文字列 (日付) | | last_login_device | コンシューマーが前回システムにログインしたときに使用したデバイス。データタイプ：文字列最大長：40 | | last_login_time | 連絡先がシステムにログインした日時。データタイプ:文字列 (日付/時刻) | | last_name | 連絡先の姓。データタイプ：文字列最大長:50 | | last_position_update | 前回の位置が更新された日時。データタイプ:文字列 (日付/時刻) | | 緯度 | 連絡先の緯度座標。データタイプ:数値 (浮動小数点) 最大長：40 | | ldap_server | 連絡先がシステムへの前回のログインに使用した LDAP サーバーのSys_id。データタイプ：文字列テーブル:LDAP サーバー \[ldap_server_config\] | | location | 連絡先の場所を説明するレコードのSys_id データタイプ：文字列テーブル:場所 \[cmn_location\] | | locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。可能な値： * true:連絡先がロックアウトされています * false:連絡先がロックアウトされていませんデータタイプ：ブーリアンデフォルト値：false | | 経度 | 連絡先の経度座標。データタイプ:数値 (浮動小数点) 最大長：40 | | マネージャー | 連絡先の直属の上司を説明するレコードのSys_id。データタイプ：文字列テーブル：ユーザー \[sys_user\] | | middle_name | 連絡先のミドルネーム。データタイプ:数値 (浮動小数点) 最大長:50 | | mobile_phone | 連絡先の携帯電話番号。データタイプ：文字列最大長：40 | | name | 連絡先のフルネーム。データタイプ：文字列最大長:151 | | 通知 | 連絡先が通知を受信するかどうかを示します。有効な値： * 1:無効 * 2:有効データタイプ:数値 (整数) デフォルト値：2 | | on_schedule | 派遣されたサービス担当者の適時性を示します。有効な値： * 先行:予定より進んでいます。 * behind_less30:予定より遅れていますが、30 分未満です。 * behind_30to60:予定より 30 分から 60 分遅れます。 * behind_more60:予定より 60 分以上遅れています。 * on_time:スケジュール遵守。データタイプ：文字列最大長：40 | | phone | 連絡先の勤務先電話番号。データタイプ：文字列最大長：40 | | 写真 | 連絡先の写真画像。データタイプ：文字列 | | preferred_language | 連絡先の主要言語の国コード。データタイプ：文字列最大長:3 | | ロール | 連絡先に関連付けられているユーザーロールのリスト。データタイプ：文字列最大長：40 | | schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。データタイプ：文字列テーブル:スケジュール \[cmn_schedule\] | | ソース | 連絡先のソース。データタイプ：文字列最大長:255 | | 状況 | 連絡先が所在する都道府県。データタイプ：文字列最大長：40 | | street | 連絡先の番地。データタイプ：文字列最大長:255 | | sys_class_name | 連絡先レコードを含むテーブル。データタイプ：文字列最大長：80 | | sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。データタイプ：文字列最大長：40 | | sys_created_on | 関連付けられた連絡先が最初に作成された日時。データタイプ:文字列 (日付/時刻) | | sys_domain | ServiceNow 関連する連絡先レコードのインスタンスドメイン。データタイプ：文字列 | | sys_domain_path | 連絡先レコードのドメインパス。データタイプ：文字列最大長:255 デフォルト:/ (グローバル) | | sys_id | 関連付けられた連絡先レコードの一意の識別子。データタイプ：文字列 | | sys_mod_count | 関連付けられた連絡先レコードが変更された回数。データタイプ:数値 (整数) | | sys_tags | システムタグ。データタイプ：文字列 | | sys_updated_by | 関連する連絡先情報を最後に更新したユーザー。データタイプ：文字列最大長：40 | | sys_updated_on | 関連する連絡先情報が更新された日時。データタイプ:文字列 (日付/時刻) | | time_format | 時間を表示する形式。有効な値： * hh.mm.ss A:hh.mm.ss (12 時間) * hh:mm:ss a:hh:mm:ss (12 時間制) * HH.mm.ss:hh.mm.ss (24 時間) * HH:mm:ss: hh:mm:ss (24 時間制) データタイプ：文字列最大長：40 デフォルト:空 (システム時間形式) | | time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。データタイプ：文字列テーブル:タイムシートポリシー \[time_sheet_policy\] | | time_zone | カナダ/中部、米国/東部など、連絡先が存在するタイムゾーン。データタイプ：文字列最大長：40 | | タイトル | 連絡先の役職 (マネージャー、ソフトウェア開発者、請負業者など)。データタイプ：文字列最大長:60 | | user_name | 連絡先ユーザー ID。データタイプ：文字列最大長：40 | | VIP | 関連付けられた連絡先に VIP ステータスがあるかどうかを示すフラグ。可能な値： * true:VIP * false:VIP ではないデータタイプ：ブーリアンデフォルト値：false | | web_service_access_only | 連絡先が Web を介してのみサービスにアクセスできるかどうかを示すフラグ。可能な値： * true:Web アクセスのみ * false:利用可能なすべての方法でアクセスしますデータタイプ：ブーリアンデフォルト値：false | | zip | 連絡先の郵便番号。データタイプ：文字列最大長：40 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/now/contact?sysparm_query=account=86837a386f0331003b3c498f5d3ee4ca&sysparm_limit=2&sysparm_offset=2>;rel="next" \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": [ { "country": "", "calendar_integration": "1", "last_position_update": "", "last_login_time": "2018-03-10 21:48:11", "last_login_device": "", "source": "", "sys_updated_on": "2019-01-03 05:49:34", "building": "", "web_service_access_only": "false", "notification": "2", "sys_updated_by": "system", "enable_multifactor_authn": "false", "sys_created_on": "2018-03-04 20:26:32", "sys_domain": "global", "agent_status": "", "state": "", "vip": "false", "sys_created_by": "admin", "longitude": "", "zip": "", "home_phone": "", "time_format": "", "last_login": "", "default_perspective": "", "geolocation_tracked": "false", "active": "true", "time_sheet_policy": "", "sys_domain_path": "/", "phone": "+1 858 287 7834", "cost_center": "", "name": "George Warren", "employee_number": "", "gender": "", "city": "", "user_name": "george.warren", "failed_attempts": "", "edu_status": "", "latitude": "", "roles": "", "title": "Network Administrator", "sys_class_name": "customer_contact", "sys_id": "ddce70866f9331003b3c498f5d3ee417", "internal_integration_user": "false", "ldap_server": "", "mobile_phone": "+1 858 867 7857", "street": "", "company": "86837a386f0331003b3c498f5d3ee4ca", "department": "", "first_name": "George", "preferred_language": "", "introduction": "", "email": "geo.warren@mailinator.com", "manager": "", "locked_out": "false", "sys_mod_count": "3", "last_name": "Warren", "photo": "", "sys_tags": "", "middle_name": "", "time_zone": "", "schedule": "", "on_schedule": "", "date_format": "", "location": "25ab8e460a0a0bb300857304ff811af5", "account": "86837a386f0331003b3c498f5d3ee4ca" }, { "country": "", "calendar_integration": "1", "last_position_update": "", "last_login_time": "2019-01-03 15:08:57", "last_login_device": "73.71.157.241", "source": "", "sys_updated_on": "2019-01-03 23:26:12", "building": "", "web_service_access_only": "false", "notification": "2", "sys_updated_by": "admin", "enable_multifactor_authn": "false", "sys_created_on": "2019-01-03 15:07:25", "sys_domain": "global", "agent_status": "", "state": "", "vip": "false", "sys_created_by": "carl.customer", "longitude": "", "zip": "", "home_phone": "", "time_format": "", "last_login": "", "default_perspective": "", "geolocation_tracked": "false", "active": "true", "time_sheet_policy": "", "sys_domain_path": "/", "phone": "+16692627777", "cost_center": "", "name": "Jane Contact", "employee_number": "", "gender": "", "city": "", "user_name": "Jane.Contact", "failed_attempts": "", "edu_status": "faculty", "latitude": "", "roles": "", "title": "", "sys_class_name": "customer_contact", "sys_id": "0a232a0013691200042ab3173244b075", "internal_integration_user": "false", "ldap_server": "", "mobile_phone": "", "street": "", "company": "86837a386f0331003b3c498f5d3ee4ca", "department": "", "first_name": "Jane", "preferred_language": "", "introduction": "", "email": "jane.contact@mailinator.com", "manager": "", "locked_out": "false", "sys_mod_count": "3", "last_name": "Contact", "photo": "", "sys_tags": "", "middle_name": "", "time_zone": "", "schedule": "", "on_schedule": "", "date_format": "", "location": "", "account": "86837a386f0331003b3c498f5d3ee4ca" } ] } ## 連絡先:GET /now/contact/{id} {#ariaid-title3} 指定されたカスタマーサービス管理 (CSM) 連絡先を取得します。 ### URL 形式バージョニングされた URL: /api/now/{api_version}/contact/{id} デフォルト URL: /api/now/contact/{id} 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#contact-GET-id__entry__2}{#contact-GET-id__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | | ID | 取得する連絡先のSys_id。データタイプ：文字列テーブル:連絡先 \[customer_contact\] | [表 : 7. パスパラメーター] {#contact-GET-id__entry__8} | 名前 | 説明 | |-|-| | なし | | [表 : 8. クエリパラメーター] {#contact-GET-id__entry__12} | 名前 | 説明 | |-|-| | なし | | [表 : 9. 要求本文パラメーター (XML または JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#contact-GET-id__entry__16}{#contact-GET-id__accept-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。デフォルト： application/json | [表 : 10. 要求ヘッダー] {#contact-GET-id__entry__20} | ヘッダー | 説明 | |-|-| | なし | | [表 : 11. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#contact-GET-id__entry__24}{#contact-GET-id__entry-200-status-code}{#contact-GET-id__entry-401-status-code}{#contact-GET-id__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 200 | 成功。要求が正常に処理されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 要求が無効であることを示します。次のいずれかの理由が考えられます。 * 要求されたケースが存在しません。 * ユーザーにはケースへのアクセス権がありません。 {#contact-GET-id__ul_ubm_1jl_3v} | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 12. ステータスコード] ### 応答本文のパラメーター (JSON または XML) エンドポイントは、応答本文で次の JSON または XML 要素を返す場合があります。以下で定義する要素のリスト (ベースシステムの要素を定義する) に加えて、エンドポイントは連絡先 \[customer_contact\] テーブルに追加されたカスタムフィールドも返します。これらの要素の詳細については、特定のテーブル定義 \[システム定義テーブル\]. {#contact-GET-id__csmcontact_response_parms__entry__2}{#contact-GET-id__contacttable-account-enrty}{#contact-GET-id__contacttable-active-entry}{#contact-GET-id__contacttable-agent_status-entry}{#contact-GET-id__contacttable-building-entry}{#contact-GET-id__contacttable-calendar_integration-entry}{#contact-GET-id__contacttable-city-entry}{#contact-GET-id__contacttable-company-entry}{#contact-GET-id__contacttable-cost_center-entry}{#contact-GET-id__contacttable-country-entry}{#contact-GET-id__contacttable-date_format-entry}{#contact-GET-id__contacttable-default_perspective-entry}{#contact-GET-id__contacttable-department-entry}{#contact-GET-id__contacttable-edu_status-entry}{#contact-GET-id__contacttable-email-entry}{#contact-GET-id__contacttable-employee_number-entry}{#contact-GET-id__contacttable-enable_multifactor_authn-entry}{#contact-GET-id__contacttable-failed_attempts-entry}{#contact-GET-id__contacttable-first_name-entry}{#contact-GET-id__contacttable-gender-entry}{#contact-GET-id__contacttable-geolocation_tracked-entry}{#contact-GET-id__contacttable-home_phone-entry}{#contact-GET-id__contacttable-internal_integration_user-entry}{#contact-GET-id__contacttable-introduction-entry}{#contact-GET-id__contacttable-last_login-entry}{#contact-GET-id__contacttable-last_login_device-entry}{#contact-GET-id__contacttable-last_login_time-entry}{#contact-GET-id__contacttable-last_name-entry}{#contact-GET-id__contacttable-last_position_update-entry}{#contact-GET-id__contacttable-latitude-entry}{#contact-GET-id__contacttable-ldap_server-entry}{#contact-GET-id__contacttable-location-entry}{#contact-GET-id__contacttable-locked_out-entry}{#contact-GET-id__contacttable-longitude-entry}{#contact-GET-id__contacttable-manager-entry}{#contact-GET-id__contacttable-middle_name-entry}{#contact-GET-id__contacttable-mobile_phone-entry}{#contact-GET-id__contacttable-name-entry}{#contact-GET-id__contacttable-notification-entry}{#contact-GET-id__contacttable-on_schedule-entry}{#contact-GET-id__contacttable-phone-entry}{#contact-GET-id__contacttable-photo-entry}{#contact-GET-id__contacttable-preferred_language-entry}{#contact-GET-id__contacttable-roles-entry}{#contact-GET-id__contacttable-schedule-entry}{#contact-GET-id__contacttable-source-entry}{#contact-GET-id__contacttable-state-entry}{#contact-GET-id__contacttable-street-entry}{#contact-GET-id__contacttable-sys_class_name-entry}{#contact-GET-id__contacttable-sys_created_by-entry}{#contact-GET-id__contacttable-sys_created_on-entry}{#contact-GET-id__contacttable-sys_domain-entry}{#contact-GET-id__contacttable-sys_domain_path-entry}{#contact-GET-id__contacttable-sys_id-entry}{#contact-GET-id__contacttable-sys_mod_count-entry}{#contact-GET-id__contacttable-sys_updated_by-entry}{#contact-GET-id__contacttable-sys_updated_on-entry}{#contact-GET-id__contacttable-time_format-entry}{#contact-GET-id__contacttable-time_sheet_policy-entry}{#contact-GET-id__contacttable-time_zone-entry}{#contact-GET-id__contacttable-title-entry}{#contact-GET-id__contacttable-user_name-entry}{#contact-GET-id__contacttable-vip-entry}{#contact-GET-id__contacttable-web_service_access_only-entry}{#contact-GET-id__contacttable-zip-entry} | 要素 | 説明 | |-|-| | アカウント | 連絡先が関連付けられているアカウントレコードのSys_id。データタイプ：文字列テーブル:アカウント \[customer_account\] | | アクティブ | 連絡先がシステム内でアクティブかどうかを示すフラグ。可能な値： * true:連絡先はアクティブです * false:連絡先は非アクティブですデータタイプ：ブーリアンデフォルト：true | | agent_status | エージェントのステータス。可能な値： * 業務時間外 * ブレーク時 * 移動中 * 現地データタイプ：文字列最大長：40 | | 建物 | 連絡先が所在する建物を説明するレコードのSys_id。データタイプ：文字列テーブル:建物 \[cmn_building\] | | calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値：1 | | city | 連絡先が所在する市区町村。データタイプ：文字列最大長：40 | | 会社 | 連絡先が関連付けられている会社レコードのSys_id。データタイプ：文字列テーブル:会社 \[core_company\] | | cost_center | 連絡先に関連付けられたコストセンターのSys_id。データタイプ：文字列テーブル:コストセンター \[cmn_cost_center\] | | country | 連絡先が所在する国の国コード。データタイプ：文字列最大長:3 | | date_format | 連絡先に日付を表示する形式。有効な値： * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd データタイプ：文字列最大長：40 デフォルト:空 (システムの日付形式) | | default_perspective | 連絡先のデフォルトの視点のSys_id。データタイプ：文字列テーブル:メニューリスト \[sys_perspective\] | | department | 連絡先に関連付けられている部門のSys_id。データタイプ：文字列テーブル:部門 \[cmn_department\] | | edu_status | 関連付けられた連絡先の教育ステータス。データタイプ：文字列最大長：40 デフォルト:faculty | | email | 連絡先のメールアドレス。データタイプ：文字列 | | employee_number | 連絡先の従業員番号。データタイプ：文字列 | | enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。可能な値： * true:マルチファクター認証が有効 * false:多要素認証が無効ですデータタイプ：ブーリアンデフォルト値：false | | failed_attempts | ログイン試行の失敗回数。データタイプ:数値 (整数) | | first_name | 連絡先の名。データタイプ：文字列最大長:50 | | 性別 | 連絡先の性別。データタイプ：文字列最大長：40 | | geolocation_tracked | 連絡先の場所がジオトラッキングによって取得されているかどうかを示すフラグ。可能な値： * true:ジオトラッキングによって取得された連絡先の場所 * false:連絡先の場所がジオトラッキングによって取得されないデータタイプ：ブーリアンデフォルト値：false | | home_phone | 自宅の電話番号に連絡してください。データタイプ：文字列最大長：40 | | internal_integration_user | 連絡先が内部統合ユーザーであるかどうかを示すフラグ。可能な値： * true:内部統合ユーザー * false:その他のタイプのユーザーデータタイプ：ブーリアンデフォルト値：false | | はじめに | 導入データタイプ：文字列最大長：40 | | last_login | 連絡先が最後にシステムにログインした日付。データタイプ:文字列 (日付) | | last_login_device | コンシューマーが前回システムにログインしたときに使用したデバイス。データタイプ：文字列最大長：40 | | last_login_time | 連絡先がシステムにログインした日時。データタイプ:文字列 (日付/時刻) | | last_name | 連絡先の姓。データタイプ：文字列最大長:50 | | last_position_update | 前回の位置が更新された日時。データタイプ:文字列 (日付/時刻) | | 緯度 | 連絡先の緯度座標。データタイプ:数値 (浮動小数点) 最大長：40 | | ldap_server | 連絡先がシステムへの前回のログインに使用した LDAP サーバーのSys_id。データタイプ：文字列テーブル:LDAP サーバー \[ldap_server_config\] | | location | 連絡先の場所を説明するレコードのSys_id データタイプ：文字列テーブル:場所 \[cmn_location\] | | locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。可能な値： * true:連絡先がロックアウトされています * false:連絡先がロックアウトされていませんデータタイプ：ブーリアンデフォルト値：false | | 経度 | 連絡先の経度座標。データタイプ:数値 (浮動小数点) 最大長：40 | | マネージャー | 連絡先の直属の上司を説明するレコードのSys_id。データタイプ：文字列テーブル：ユーザー \[sys_user\] | | middle_name | 連絡先のミドルネーム。データタイプ:数値 (浮動小数点) 最大長:50 | | mobile_phone | 連絡先の携帯電話番号。データタイプ：文字列最大長：40 | | name | 連絡先のフルネーム。データタイプ：文字列最大長:151 | | 通知 | 連絡先が通知を受信するかどうかを示します。有効な値： * 1:無効 * 2:有効データタイプ:数値 (整数) デフォルト値：2 | | on_schedule | 派遣されたサービス担当者の適時性を示します。有効な値： * 先行:予定より進んでいます。 * behind_less30:予定より遅れていますが、30 分未満です。 * behind_30to60:予定より 30 分から 60 分遅れます。 * behind_more60:予定より 60 分以上遅れています。 * on_time:スケジュール遵守。データタイプ：文字列最大長：40 | | phone | 連絡先の勤務先電話番号。データタイプ：文字列最大長：40 | | 写真 | 連絡先の写真画像。データタイプ：文字列 | | preferred_language | 連絡先の主要言語の国コード。データタイプ：文字列最大長:3 | | ロール | 連絡先に関連付けられているユーザーロールのリスト。データタイプ：文字列最大長：40 | | schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。データタイプ：文字列テーブル:スケジュール \[cmn_schedule\] | | ソース | 連絡先のソース。データタイプ：文字列最大長:255 | | 状況 | 連絡先が所在する都道府県。データタイプ：文字列最大長：40 | | street | 連絡先の番地。データタイプ：文字列最大長:255 | | sys_class_name | 連絡先レコードを含むテーブル。データタイプ：文字列最大長：80 | | sys_created_by | 関連付けられた連絡先レコードを最初に作成したユーザー。データタイプ：文字列最大長：40 | | sys_created_on | 関連付けられた連絡先が最初に作成された日時。データタイプ:文字列 (日付/時刻) | | sys_domain | ServiceNow 関連する連絡先レコードのインスタンスドメイン。データタイプ：文字列 | | sys_domain_path | 連絡先レコードのドメインパス。データタイプ：文字列最大長:255 デフォルト:/ (グローバル) | | sys_id | 関連付けられた連絡先レコードの一意の識別子。データタイプ：文字列 | | sys_mod_count | 関連付けられた連絡先レコードが変更された回数。データタイプ:数値 (整数) | | sys_updated_by | 関連する連絡先情報を最後に更新したユーザー。データタイプ：文字列最大長：40 | | sys_updated_on | 関連する連絡先情報が更新された日時。データタイプ:文字列 (日付/時刻) | | time_format | 時間を表示する形式。有効な値： * hh.mm.ss A:hh.mm.ss (12 時間) * hh:mm:ss a:hh:mm:ss (12 時間制) * HH.mm.ss:hh.mm.ss (24 時間) * HH:mm:ss: hh:mm:ss (24 時間制) データタイプ：文字列最大長：40 デフォルト:空 (システム時間形式) | | time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。データタイプ：文字列テーブル:タイムシートポリシー \[time_sheet_policy\] | | time_zone | カナダ/中部、米国/東部など、連絡先が存在するタイムゾーン。データタイプ：文字列最大長：40 | | タイトル | 連絡先の役職 (マネージャー、ソフトウェア開発者、請負業者など)。データタイプ：文字列最大長:60 | | user_name | 連絡先ユーザー ID。データタイプ：文字列最大長：40 | | VIP | 関連付けられた連絡先に VIP ステータスがあるかどうかを示すフラグ。可能な値： * true:VIP * false:VIP ではないデータタイプ：ブーリアンデフォルト値：false | | web_service_access_only | 連絡先が Web を介してのみサービスにアクセスできるかどうかを示すフラグ。可能な値： * true:Web アクセスのみ * false:利用可能なすべての方法でアクセスしますデータタイプ：ブーリアンデフォルト値：false | | zip | 連絡先の郵便番号。データタイプ：文字列最大長：40 | [ ] ### cURL 要求 curl "https://instance.servicenow.com/api/now/contact/ddce70866f9331003b3c498f5d3ee417 \ --request GET \ --header "Accept:application/json" \ --user "username":"password" { "result": { "country": "", "calendar_integration": "1", "last_position_update": "", "last_login_time": "2018-03-10 21:48:11", "last_login_device": "", "source": "", "sys_updated_on": "2019-01-03 05:49:34", "building": "", "web_service_access_only": "false", "notification": "2", "sys_updated_by": "system", "enable_multifactor_authn": "false", "sys_created_on": "2018-03-04 20:26:32", "sys_domain": "global", "agent_status": "", "state": "", "vip": "false", "sys_created_by": "admin", "longitude": "", "zip": "", "home_phone": "", "time_format": "", "last_login": "", "default_perspective": "", "geolocation_tracked": "false", "active": "true", "time_sheet_policy": "", "sys_domain_path": "/", "phone": "+1 858 287 7834", "cost_center": "", "name": "George Warren", "employee_number": "", "gender": "", "city": "", "user_name": "george.warren", "failed_attempts": "", "edu_status": "", "latitude": "", "roles": "", "title": "Network Administrator", "sys_class_name": "customer_contact", "sys_id": "ddce70866f9331003b3c498f5d3ee417", "internal_integration_user": "false", "ldap_server": "", "mobile_phone": "+1 858 867 7857", "street": "", "company": "86837a386f0331003b3c498f5d3ee4ca", "department": "", "first_name": "George", "preferred_language": "", "introduction": "", "email": "geo.warren@mailinator.com", "manager": "", "locked_out": "false", "sys_mod_count": "3", "last_name": "Warren", "photo": "", "sys_tags": "", "middle_name": "", "time_zone": "", "schedule": "", "on_schedule": "", "date_format": "", "location": "25ab8e460a0a0bb300857304ff811af5", "account": "86837a386f0331003b3c498f5d3ee4ca" } } ## 連絡先:POST /now/contact {#ariaid-title4} 新しいカスタマーサービス管理 (CSM) 連絡先を作成します。さらに、このエンドポイントを使用して連絡先のソーシャルメディアプロファイルを作成できます。プロファイルを作成するには、要求本文で次のパラメーターを指定する必要があります。 * social_channel * social_handle * social_handle_url {#contact-POST__ul_ntx_lg4_pgb} 警告: このエンドポイントでは、過剰なオーバーヘッドが発生する可能性があるため、パラメーターの検証は実行されません。要求パラメーターのスペルが間違っている、有効でない、またはエンドポイントでサポートされていない場合は、警告なしに無視されます。 ### URL 形式バージョニングされた URL: /api/now/{api_version}/contact デフォルト URL: /api/now/contact 注: 使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#contact-POST__entry__2}{#contact-POST__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。データタイプ：文字列 | [表 : 13. パスパラメーター] {#contact-POST__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 14. クエリパラメーター] {#contact-POST__entry__10}{#contact-POST__contacttable-account-enrty}{#contact-POST__contacttable-active-entry}{#contact-POST__contacttable-agent_status-entry}{#contact-POST__contacttable-building-entry}{#contact-POST__contacttable-calendar_integration-entry}{#contact-POST__contacttable-city-entry}{#contact-POST__contacttable-company-entry}{#contact-POST__contacttable-cost_center-entry}{#contact-POST__contacttable-country-entry}{#contact-POST__contacttable-date_format-entry}{#contact-POST__contacttable-default_perspective-entry}{#contact-POST__contacttable-department-entry}{#contact-POST__contacttable-edu_status-entry}{#contact-POST__contacttable-email-entry}{#contact-POST__contacttable-employee_number-entry}{#contact-POST__contacttable-enable_multifactor_authn-entry}{#contact-POST__contacttable-failed_attempts-entry}{#contact-POST__contacttable-first_name-entry}{#contact-POST__contacttable-gender-entry}{#contact-POST__contacttable-geolocation_tracked-entry}{#contact-POST__contacttable-home_phone-entry}{#contact-POST__contacttable-internal_integration_user-entry}{#contact-POST__contacttable-introduction-entry}{#contact-POST__contacttable-last_login_device-entry}{#contact-POST__contacttable-last_login_time-entry}{#contact-POST__contacttable-last_name-entry}{#contact-POST__contacttable-latitude-entry}{#contact-POST__contacttable-ldap_server-entry}{#contact-POST__contacttable-location-entry}{#contact-POST__contacttable-locked_out-entry}{#contact-POST__contacttable-longitude-entry}{#contact-POST__contacttable-manager-entry}{#contact-POST__contacttable-middle_name-entry}{#contact-POST__contacttable-mobile_phone-entry}{#contact-POST__contacttable-name-entry}{#contact-POST__contacttable-notification-entry}{#contact-POST__contacttable-on_schedule-entry}{#contact-POST__contacttable-phone-entry}{#contact-POST__contacttable-photo-entry}{#contact-POST__contacttable-preferred_language-entry}{#contact-POST__contacttable-roles-entry}{#contact-POST__contacttable-schedule-entry}{#contact-POST__contacttable-source-entry}{#contact-POST__contacttable-state-entry}{#contact-POST__contacttable-street-entry}{#contact-POST__contacttable-time_format-entry}{#contact-POST__contacttable-time_sheet_policy-entry}{#contact-POST__contacttable-time_zone-entry}{#contact-POST__contacttable-title-entry}{#contact-POST__contacttable-user_name-entry}{#contact-POST__contacttable-vip-entry}{#contact-POST__contacttable-web_service_access_only-entry}{#contact-POST__contacttable-zip-entry} | 要素 | 説明 | |-|-| | アカウント | 連絡先が関連付けられているアカウントレコードのSys_id。データタイプ：文字列テーブル:アカウント \[customer_account\] | | アクティブ | 連絡先がシステム内でアクティブかどうかを示すフラグ。可能な値： * true:連絡先はアクティブです * false:連絡先は非アクティブですデータタイプ：ブーリアンデフォルト：true | | agent_status | エージェントのステータス。可能な値： * 業務時間外 * ブレーク時 * 移動中 * 現地データタイプ：文字列最大長：40 | | 建物 | 連絡先が所在する建物を説明するレコードのSys_id。データタイプ：文字列テーブル:建物 \[cmn_building\] | | calendar_integration | 連絡先が使用するカレンダーアプリケーション。 1:Outlook データタイプ:数値 (整数) デフォルト値：1 | | city | 連絡先が所在する市区町村。データタイプ：文字列最大長：40 | | 会社 | 連絡先が関連付けられている会社レコードのSys_id。データタイプ：文字列テーブル:会社 \[core_company\] | | cost_center | 連絡先に関連付けられたコストセンターのSys_id。データタイプ：文字列テーブル:コストセンター \[cmn_cost_center\] | | country | 連絡先が所在する国の国コード。データタイプ：文字列最大長:3 | | date_format | 連絡先に日付を表示する形式。有効な値： * dd/mm/yyyy * dd-mm-yyyy * dd.mm.yyyy * mm-dd-yyyy * yyyy-mm-dd データタイプ：文字列最大長：40 デフォルト:空 (システムの日付形式) | | default_perspective | 連絡先のデフォルトの視点のSys_id。データタイプ：文字列テーブル:メニューリスト \[sys_perspective\] | | department | 連絡先に関連付けられている部門のSys_id。データタイプ：文字列テーブル:部門 \[cmn_department\] | | edu_status | 関連付けられた連絡先の教育ステータス。データタイプ：文字列最大長：40 デフォルト:faculty | | email | 連絡先のメールアドレス。データタイプ：文字列 | | employee_number | 連絡先の従業員番号。データタイプ：文字列 | | enable_multifactor_authn | 連絡先がサービスポータルにログインするためにマルチファクター認証が必要かどうかを示すフラグ。可能な値： * true:マルチファクター認証が有効 * false:多要素認証が無効ですデータタイプ：ブーリアンデフォルト値：false | | failed_attempts | ログイン試行の失敗回数。データタイプ:数値 (整数) | | first_name | 連絡先の名。データタイプ：文字列最大長:50 | | 性別 | 連絡先の性別。データタイプ：文字列最大長：40 | | geolocation_tracked | 連絡先の場所がジオトラッキングによって取得されているかどうかを示すフラグ。可能な値： * true:ジオトラッキングによって取得された連絡先の場所 * false:連絡先の場所がジオトラッキングによって取得されないデータタイプ：ブーリアンデフォルト値：false | | home_phone | 自宅の電話番号に連絡してください。データタイプ：文字列最大長：40 | | internal_integration_user | 連絡先が内部統合ユーザーであるかどうかを示すフラグ。可能な値： * true:内部統合ユーザー * false:その他のタイプのユーザーデータタイプ：ブーリアンデフォルト値：false | | はじめに | 導入データタイプ：文字列最大長：40 | | last_login_device | コンシューマーが前回システムにログインしたときに使用したデバイス。データタイプ：文字列最大長：40 | | last_login_time | 連絡先がシステムにログインした日時。データタイプ:文字列 (日付/時刻) | | last_name | 連絡先の姓。データタイプ：文字列最大長:50 | | 緯度 | 連絡先の緯度座標。データタイプ:数値 (浮動小数点) 最大長：40 | | ldap_server | 連絡先がシステムへの前回のログインに使用した LDAP サーバーのSys_id。データタイプ：文字列テーブル:LDAP サーバー \[ldap_server_config\] | | location | 連絡先の場所を説明するレコードのSys_id データタイプ：文字列テーブル:場所 \[cmn_location\] | | locked_out | 連絡先がロックアウトされているかどうかを示すフラグ。可能な値： * true:連絡先がロックアウトされています * false:連絡先がロックアウトされていませんデータタイプ：ブーリアンデフォルト値：false | | 経度 | 連絡先の経度座標。データタイプ:数値 (浮動小数点) 最大長：40 | | マネージャー | 連絡先の直属の上司を説明するレコードのSys_id。データタイプ：文字列テーブル：ユーザー \[sys_user\] | | middle_name | 連絡先のミドルネーム。データタイプ:数値 (浮動小数点) 最大長:50 | | mobile_phone | 連絡先の携帯電話番号。データタイプ：文字列最大長：40 | | name | 連絡先のフルネーム。データタイプ：文字列最大長:151 | | 通知 | 連絡先が通知を受信するかどうかを示します。有効な値： * 1:無効 * 2:有効データタイプ:数値 (整数) デフォルト値：2 | | on_schedule | 派遣されたサービス担当者の適時性を示します。有効な値： * 先行:予定より進んでいます。 * behind_less30:予定より遅れていますが、30 分未満です。 * behind_30to60:予定より 30 分から 60 分遅れます。 * behind_more60:予定より 60 分以上遅れています。 * on_time:スケジュール遵守。データタイプ：文字列最大長：40 | | phone | 連絡先の勤務先電話番号。データタイプ：文字列最大長：40 | | 写真 | 連絡先の写真画像。データタイプ：文字列 | | preferred_language | 連絡先の主要言語の国コード。データタイプ：文字列最大長:3 | | ロール | 連絡先に関連付けられているユーザーロールのリスト。データタイプ：文字列最大長：40 | | schedule | 関連付けられた連絡先の作業スケジュールを説明するレコードのSys_id。データタイプ：文字列テーブル:スケジュール \[cmn_schedule\] | | social_channel | 連絡先が関連付けられているソーシャルメディアチャネル (Twitter、Facebook、Instagram など)。データタイプ：文字列 | | social_handle | ソーシャルメディアチャネルのユーザーハンドル。データタイプ：文字列 | | social_handle_url | 連絡先のソーシャルチャネルプロファイルへの URL。データタイプ：文字列 | | ソース | 連絡先のソース。データタイプ：文字列最大長:255 | | 状況 | 連絡先が所在する都道府県。データタイプ：文字列最大長：40 | | street | 連絡先の番地。データタイプ：文字列最大長:255 | | time_format | 時間を表示する形式。有効な値： * hh.mm.ss A:hh.mm.ss (12 時間) * hh:mm:ss a:hh:mm:ss (12 時間制) * HH.mm.ss:hh.mm.ss (24 時間) * HH:mm:ss: hh:mm:ss (24 時間制) データタイプ：文字列最大長：40 デフォルト:空 (システム時間形式) | | time_sheet_policy | 関連付けられた連絡先のタイムシートポリシーを含むレコードのSys_id。データタイプ：文字列テーブル:タイムシートポリシー \[time_sheet_policy\] | | time_zone | カナダ/中部、米国/東部など、連絡先が存在するタイムゾーン。データタイプ：文字列最大長：40 | | タイトル | 連絡先の役職 (マネージャー、ソフトウェア開発者、請負業者など)。データタイプ：文字列最大長:60 | | user_name | 連絡先ユーザー ID。データタイプ：文字列最大長：40 | | VIP | 関連付けられた連絡先に VIP ステータスがあるかどうかを示すフラグ。可能な値： * true:VIP * false:VIP ではないデータタイプ：ブーリアンデフォルト値：false | | web_service_access_only | 連絡先が Web を介してのみサービスにアクセスできるかどうかを示すフラグ。可能な値： * true:Web アクセスのみ * false:利用可能なすべての方法でアクセスしますデータタイプ：ブーリアンデフォルト値：false | | zip | 連絡先の郵便番号。データタイプ：文字列最大長：40 | [表 : 15. 要求本文パラメーター (XML または JSON)] ### ヘッダー次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")を参照してください。 {#contact-POST__entry__124}{#contact-POST__accept-JSON-only-entry-RESTAPI}{#contact-POST__content_type-JSON-only-entry-RESTAPI} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。application/json のみをサポートします。 | | Content-Type | 要求本文のデータ形式。application/json のみをサポートします。 | [表 : 16. 要求ヘッダー] {#contact-POST__entry__130} | ヘッダー | 説明 | |-|-| | なし | | [表 : 17. 応答ヘッダー] ### ステータスコードこの HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューターシステム間の標準を提供するシンプルなステートレスアーキテクチャであり、コンピューターシステム間の通信を容易にします。")」を参照してください。 {#contact-POST__entry__134}{#contact-POST__entry-401-status-code} | ステータスコード | 説明 | |-|-| | 201 | 新しい連絡先レコードが正常に作成されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 500 | 内部サーバーエラー。サーバー側のコードでロジックエラーが発生しました。 | [表 : 18. ステータスコード] ### 応答本文のパラメーター (JSON または XML) {#contact-POST__entry__144} | 要素 | 説明 | |-|-| | result | 新しく作成された連絡先レコードのSys_id。データタイプ：文字列 | [ ] ### cURL 要求 curl -X POST "https://instance.servicenow.com/api/now/contact" \ -H 'Accept: application/json' \ -H 'Content-Type: application/json' \ -d '{ \ "country": "USA", \ "calendar_integration": "1", \ "last_login_time": "2018-03-10 21:48:11", \ "last_login_device": "tablet", \ "building": "Cardinal West", \ "web_service_access_only": "false", \ "notification": "1", \ "enable_multifactor_authn": "true", \ "agent_status": "Travelling", \ "state": "CA", \ "vip": "false", \ "longitude": "123.76", \ "zip": "92069", \ "home_phone": "(555)555-1234", \ "time_format": "hh:mm:ss", \ "geolocation_tracked": "false", \ "active": "true", \ "phone": "+1 858 287 7834", \ "cost_center": "1345", \ "name": "Dora Warren", \ "employee_number": "546", \ "gender": "Female", \ "city": "Orlando", \ "user_name": "dora.warren", \ "failed_attempts": "2", \ "edu_status": "current", \ "latitude": "57.6", \ "title": "Network Administrator", \ "internal_integration_user": "false", \ "ldap_server": "10.24.23.123", \ "mobile_phone": "+1 858 867 7857", \ "street": "123 Lagume", \ "company": "86837a386f0331003b3c498f5d3ee4ca", \ "department": "IT", \ "first_name": "Dora", \ "preferred_language": "Spanish", \ "email": "dora.warren@mailinator.com", \ "manager": "ddce70866f9331003b3c498f5d3ee417", \ "locked_out": "false", \ "last_name": "Warren", \ "middle_name": "Dell", \ "time_zone": "PST", \ "schedule": "9-5", \ "date_format": "MM/DD/YY", \ "location": "25ab8e460a0a0bb300857304ff811af5", \ "account": "86837a386f0331003b3c498f5d3ee4ca" \ }' --user 'username':'password' "result": "62fe1c97db76c3006b7a9646db961999"