---
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


---

# NowAttachmentService インターフェイス : Android

# NowAttachmentService インターフェイス : Android {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：7分

NowAttachmentService インターフェイスは、添付ファイルとそれに関連するメタデータの操作を有効にする関数を提供します。  
{#NowAttachServiceAndroidInterface__table_vx2_klw_5pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| 構成 | [NowServiceConfiguration](https://servicenow-prod.fluidtopics.net/kN3GoqTwJ7c0P7uFfos~Dg "NowServiceConfiguration クラスを使用すると、フィーチャ サービスのServiceNow インスタンス URL とパッケージ名を構成できます。") | サービスに関連付ける構成。 |
[表 : 1. プロパティ]

{#NowAttachServiceAndroidInterface__table_vx2_klw_5pb}

## NowAttachmentService - attachment(sysId: String, validateAttachment: Boolean = true) {#ariaid-title2}

指定されたsys_idの添付ファイルを取得し、オプションで、添付ファイルの計算されたハッシュを予想されるハッシュと比較して添付ファイルを検証します。
{#NAttServ-attachment_S_B__table_old_sp5_4pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | 取得する添付ファイルのSys_id。これは、 ServiceNow インスタンスの添付ファイルのsys_idです。 |
| validateAttachment | ブーリアン | 添付ファイルを検証するかどうかを示すフラグ。 有効な値： * true:添付ファイルを検証します。 * false:添付ファイルを検証しません。 {#NAttServ-attachment_S_B__ul_ftq_1q5_4pb} デフォルト：true |
[表 : 2. パラメーター]

{#NAttServ-attachment_S_B__table_old_sp5_4pb} {#NAttServ-attachment_S_B__table_pld_sp5_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| [呼び出し\<](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")[NowAttachment](https://servicenow-prod.fluidtopics.net/~KKFb_jiDxvRqhNWBmS1cw#NowAttachmentAndroidAPI "NowAttachment クラスは、添付ファイルとそれに関連するメタデータを含むオブジェクトを提供します。")\> | 要求された添付ファイルを含む NowAttachment オブジェクト。 |
[表 : 3. 返される内容]

{#NAttServ-attachment_S_B__table_pld_sp5_4pb}  
<br />

    fun getAttachment(sysId: String, isValidateAttachment: Boolean) { 
      val call = attachmentService.attachment(sysId, isValidateAttachment) 
      call.enqueue( 
        { response -> 
          val attachment: NowAttachment? = response.body 
        }, 
          { nowDataError -> handleError(nowDataError) } 
      ) 
    }

## NowAttachmentService:attachmentMetadata(sysId:文字列) {#ariaid-title3}

指定されたsys_idに関連付けられた添付ファイルのメタデータを取得します。
{#NAttServ-attachmentMetadata_S__table_bqq_1r5_4pb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | メタデータを取得する添付ファイルのSys_id。 |
[表 : 4. パラメーター]

{#NAttServ-attachmentMetadata_S__table_bqq_1r5_4pb} {#NAttServ-attachmentMetadata_S__table_cqq_1r5_4pb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/B5nMXq3XB5FfBi2SfEYR5g#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata クラスは、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")\> | 指定された添付ファイルのメタデータを含むオブジェクト。 |
[表 : 5. 返される内容]

{#NAttServ-attachmentMetadata_S__table_cqq_1r5_4pb}  

    fun fetchMetadata(sysId: String) { 
      val call = attachmentService.attachmentMetadata(sysId) 
      call.enqueue(
        { response -> 
          val metadata: NowAttachmentMetadata? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }

## NowAttachmentService - attachmentMetadata(filter: フィルター? = null, 制限: Int? = null) {#ariaid-title4}

指定された基準を満たすすべての添付ファイルのメタデータを取得します。
{#NAttServ-attachmentMetadata_S_I___table_ujt_zc1_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フィルター | [フィルター](https://servicenow-prod.fluidtopics.net/6Fd7SBHnjeKX0OmvHyi0yQ#FilterAndroidAPI "Filter クラスは、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成する機能を提供します。") | オプション。メタデータを返す添付ファイルをフィルタリングするために使用するクエリ文字列。 デフォルト:null - 利用可能なすべての添付ファイルのメタデータを返します。limitパラメーターを考慮します。 |
| limit | 整数 | オプション。返す添付ファイルのメタデータの最大数。 デフォルト:null - filter パラメーターの仕様を満たすすべてのメタデータを返します。 |
[表 : 6. パラメーター]

{#NAttServ-attachmentMetadata_S_I___table_ujt_zc1_ppb} {#NAttServ-attachmentMetadata_S_I___table_vjt_zc1_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[List](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-list/)\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/B5nMXq3XB5FfBi2SfEYR5g#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata クラスは、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")\>\> | 一致する添付ファイルのメタデータを含むオブジェクトのリスト。 |
[表 : 7. 返される内容]

{#NAttServ-attachmentMetadata_S_I___table_vjt_zc1_ppb}  

    fun fetchMultipleMetadata(filterQuery: String, limit: Int) { 
      val call = attachmentService.attachmentMetadata(Filter(filterQuery), limit) 
      call.enqueue( 
        { response -> 
          val metadataList: List<NowAttachmentMetadata>? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }

## NowAttachmentService - attachmentMetadataPaginator(filter: フィルター? = null, 制限: Int? = null) {#ariaid-title5}

指定された基準を満たすすべての添付ファイルのメタデータを取得し、返されたメタデータのページを反復処理するためのページネーターを作成します。
このページネーターを使用して、返されたメタデータ間を移動したり、最初、最後、前、または次のページのフェッチ、次または前のページがあるかどうかの確認などのナビゲーション操作を実行したりできます。
{#NAttServ-attachMetadataPaginat_S_I__table_npz_zf1_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| フィルター | [フィルター](https://servicenow-prod.fluidtopics.net/6Fd7SBHnjeKX0OmvHyi0yQ#FilterAndroidAPI "Filter クラスは、REST エンドポイントクエリの戻り結果で返すデータを定義するフィルターを構成する機能を提供します。") | オプション。メタデータを返す添付ファイルをフィルタリングするために使用するクエリ文字列。 デフォルト:null - 利用可能なすべての添付ファイルのメタデータを返します。limitパラメーターを考慮します。 |
| limit | 整数 | オプション。返す添付ファイルのメタデータの最大数。 デフォルト:null - filter パラメーターの仕様を満たすすべてのメタデータを返します。 |
[表 : 8. パラメーター]

{#NAttServ-attachMetadataPaginat_S_I__table_npz_zf1_ppb} {#NAttServ-attachMetadataPaginat_S_I__table_opz_zf1_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| paginator\<[NowAttachmentMetadata](https://servicenow-prod.fluidtopics.net/B5nMXq3XB5FfBi2SfEYR5g#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata クラスは、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。")\> | 成功:ページネーターオブジェクトと指定されたメタデータページ。 エラー:NowDataError オブジェクト。 |
[表 : 9. 返される内容]

{#NAttServ-attachMetadataPaginat_S_I__table_opz_zf1_ppb}  
次のコード例は、この関数を呼び出す方法を示しています。

    suspend fun createAttachmentMetadataPaginator() {
      val filterQuery: String = "content_type=text/plain"
      val filter = filterQuery.let(::Filter)
      val limit = 10
      val paginator = nowServiceManager.getNowAttachmentService()?.attachmentMetadataPaginator(filter, limit)
        ?.observe(object : PaginatorCallBack<NowAttachmentMetadata> {
          override fun onFailure(e: NowDataError) {
            handleError(e)
          }

          override fun onSuccess(response: Response<List<NowAttachmentMetadata>>) {
            handleResponse(response)
          }

        })
        ?: throw Exception("Response is null")
    }

## NowAttachmentService:削除 (sysId: 文字列) {#ariaid-title6}

指定されたsys_idの添付ファイルを削除します。
{#NAttServ-delete_S__table_dq4_dj1_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| sysId | 文字列 | 削除する添付ファイルのSys_id。 |
[表 : 10. パラメーター]

{#NAttServ-delete_S__table_dq4_dj1_ppb} {#NAttServ-delete_S__table_eq4_dj1_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Call](https://servicenow-prod.fluidtopics.net/f9MOJM5d6RJ30rx8bmji1w#CallAndroidInterface "呼び出しインターフェイスは、処理用に準備された要求を表します。")\<[ByteArray](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/)\> | 成功:何も返されません。 エラー:NowDataError が返されました。 |
[表 : 11. 返される内容]

{#NAttServ-delete_S__table_eq4_dj1_ppb}  
<br />

    fun deleteAttachment(sysId: String) { 
      val call = attachmentService.delete(sysId) 
      call.enqueue( 
        { response -> handleResponse(response) }, 
        { nowDataError -> handleError(nowDataError) } 
      )
    } 

## NowAttachmentService:upload(データ:ByteArray、構成:NowAttachmentUploadConfiguration) {#ariaid-title7}

指定された基準を満たすすべての添付ファイルのメタデータを取得し、返されたメタデータのページを反復処理するためのページネーターを作成します。
{#NAttServ-upload_A_O__table_fkj_3k1_ppb__entry__3}

| 名前 | タイプ | 説明 |
|-|-|-|
| データ | [バイトアレイ](https://kotlinlang.org/api/latest/jvm/stdlib/kotlin/-byte-array/) | アップロードし、構成オブジェクトで指定された添付ファイルに関連付けるメタデータ。 |
| 構成 | NowAttachmentUploadConfiguration | 設定パラメーターをアップロードします。 |
[表 : 12. パラメーター]

{#NAttServ-upload_A_O__table_fkj_3k1_ppb} {#NAttServ-upload_A_O__table_gkj_3k1_ppb__entry__2}

| タイプ | 説明 |
|-|-|
| [Now 添付メタデータ](https://servicenow-prod.fluidtopics.net/B5nMXq3XB5FfBi2SfEYR5g#NowAttachmentMetadataAndroidAPI "NowAttachmentMetadata クラスは、添付ファイルのメタデータをエンコードおよび管理できる関数を提供します。") | アップロードされたメタデータ。 |
[表 : 13. 返される内容]

{#NAttServ-upload_A_O__table_gkj_3k1_ppb}  

    fun uploadAttachment(tableName: String, recordSysId: String, fileName: String) { 
      val bitmap = BitmapFactory.decodeResource(resources, R.drawable.test_image) 
      val data = bitmap.compress(ImageType.JPEG) 
      val contentType = "image/jpg" 
      val config = NowAttachmentUploadConfiguration(tableName, recordSysId, fileName, contentType) 
      val call = attachmentService.upload(data, config) 
     
      call.enqueue( 
        { response -> 
          val uploadedAttachmentMetadata: NowAttachmentMetadata? = response.body 
        },
        { nowDataError -> handleError(nowDataError) } 
      )
    }