--- 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 --- # CCCIF メディアリソース API # CCCIF メディアリソース API {#ariaid-title1} * リリースバージョン: Australia * * 更新日 2026年03月12日 * * ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分 カスタムチャットチャットボット相互運用性フレームワーク (CCCIF) メディアリソース API は、プライマリボットが関連する ServiceNow インスタンスに添付ファイルをアップロードできるようにするエンドポイントを提供します。 プライマリボットでこの API を呼び出して、 仮想エージェント (VA) を介して会話しているユーザーからプライベート添付ファイルをアップロードします。次に、この API によって返される mediaUrl パラメーターを VA API に送信する必要があります。 添付ファイルが公開されている場合は、 [仮想エージェントボット統合](https://servicenow-prod.fluidtopics.net/zUBz_BLPqzQJirmpuIOZiA#bot-api "仮想エージェントボット統合 API は、ユーザーがチャットインターフェイスまたはボットエコシステムをServiceNow 仮想エージェントやライブエージェントと統合できるようにするエンドポイントを提供します。") コールの要求本文で添付ファイルの URL を送信するだけです。 この API にアクセスするには、会話型カスタムチャット統合 (com.glide.cs.custom.adapter) プラグインを有効にする必要があります。さらに、添付ファイルのシステムプロパティを設定する必要があります。 仮想エージェント API の機能の詳細については、「[Virtual Agent API](https://www.servicenow.com/docs/access?context=virtual-agent-api-landing-page&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)」を参照してください。 ## CCCIF - POST /cccif/media/upload {#ariaid-title2} 呼び出し側の ServiceNow インスタンスにプライベート添付ファイルをアップロードします。このインスタンスは添付ファイル \[sys_attachment\] テーブルに添付ファイルを保存します。 プライマリボットでこのメソッドを呼び出して、 仮想エージェント (VA) を介して会話しているユーザーからプライベート添付ファイルをアップロードします。次に、このメソッドによって返された mediaUrl パラメーターを、 [仮想エージェントボット統合 API](https://servicenow-prod.fluidtopics.net/zUBz_BLPqzQJirmpuIOZiA#bot-api "仮想エージェントボット統合 API は、ユーザーがチャットインターフェイスまたはボットエコシステムをServiceNow 仮想エージェントやライブエージェントと統合できるようにするエンドポイントを提供します。") を使用して VA API に送信する必要があります。 ### URL 形式 バージョニングされた URL: /api/now/{api_version}/cccif/media/upload デフォルト URL: /api/now/cccif/media/upload 注: 使用可能なバージョン [は、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 をビルドできます。")に追加のバージョン情報があります。 ### サポートされている要求パラメーター {#cccif-media-upload__entry__2}{#cccif-media-upload__version-not_optional-RESTAPI} | 名前 | 説明 | |-|-| | api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 | [表 : 1. パスパラメーター] {#cccif-media-upload__entry__6} | 名前 | 説明 | |-|-| | なし | | [表 : 2. クエリパラメーター] {#cccif-media-upload__entry__10} | 名前 | 説明 | |-|-| | ファイル | 必須です。アップロードするファイルのパス。 データタイプ:@Fileパス\などの文字列 | | provider_application_id | VA ボットとやり取りするsys_cs_provider_applicationのSys_id。 デフォルト:VA ボット間ボットプロバイダーアプリケーションのSys_id | | user_id | 必須です。VA ボットとやり取りするユーザーの一意のユーザー識別子。これは、ユーザーごとに一意の任意の文字列にすることができます。 データタイプ：文字列 | [表 : 3. 要求本文のパラメーター] ### ヘッダー 次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。 {#cccif-media-upload__entry__18} | ヘッダー | 説明 | |-|-| | 承認 | 応答本文のデータフォーマット。サポートされているタイプ: multipart/form-data。 | [表 : 4. 要求ヘッダー] {#cccif-media-upload__entry__22} | ヘッダー | 説明 | |-|-| | Content-Type | 応答本文のデータフォーマット。application/json のみをサポートします。 | [表 : 5. 応答ヘッダー] ### ステータスコード この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。 {#cccif-media-upload__entry__26}{#cccif-media-upload__entry-400-status-code}{#cccif-media-upload__entry-401-status-code}{#cccif-media-upload__entry-404-status-code}{#cccif-media-upload__entry-500-status-code} | ステータスコード | 説明 | |-|-| | 201 | 成功。要求が正常に処理されました。 | | 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 | | 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 | | 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 | | 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 | [表 : 6. ステータスコード] ### 応答本文のパラメーター (JSON) {#cccif-media-upload__entry__38} | 名前 | 説明 | |-|-| | attachmentId | 保存されていた添付ファイルのSys_id。 データタイプ：文字列 | | エラー | 要求の処理中に検出されたエラーの説明。 データタイプ: オブジェクト "error": { "detail": "String", "message": "String" } | | error.detail | 発生したエラーの詳細。 データタイプ：文字列 | | error.message | スローされたエラーを説明するメッセージ。 データタイプ：文字列 | | mediaUrl | 添付ファイルにアクセスするためにプライマリボットに送信する添付ファイルの URL。プライマリボットは、POST /sn_va_as_service/bot/integration エンドポイントの要求本文の message.attachment.url パラメーターでこの URL を送信する必要があります。 データタイプ：文字列 | | name | 添付ファイルのファイル名。 データタイプ：文字列 | | 状況 | 添付ファイルテーブル内の添付ファイルのステータス。 可能な値： * 利用可能 * 条件付きで利用可能 * 利用できません * 保留中 {#cccif-media-upload__ul_mxv_yjp_trb} データタイプ：文字列 | [ ] ### cURL 要求 この例では、.pngファイルの添付ファイルをアップロードする方法を示します。 curl --location --request POST 'https://instance.servicenow.com/api/now/v1/cccif/media/upload' \ --header 'Authorization: Basic xxxxxxxxxxxxx' \ --header 'Content-Type:multipart/form-data' \ --form 'user_id="lincoln"' \ --form 'file=@"/Users/Desktop/Screenshot 2021-10-25 at 5.08.14 PM.png"' 応答： Response :{ "result": { "mediaUrl": "https://instance.servicenow.com/api/now/v1/cs/media/vGfewkfAv0VBo2RxmlTM448L789Pp6rqLFLUNYQxZsUUFrsgMA8aW9W0zWx1a5fG", "name": "Screenshot 2021-10-25 at 5.08.14 PM.png", "state": "pending", "attachmentId": "299c648887b73c1022b6a6cd0ebb3534" }