機械翻訳について
  1. ドキュメント用REST API
  2. タスク
  3. フォルダ

特定フォルダIDのフォルダまたはファイルの検索

get

/documents/api/1.2/folders/{folderId}/search/items

特定のフォルダIDまたはselfフォルダ・ディレクトリのfulltextまたはquerytextでフォルダまたはファイルを検索します。 これにより、特定のフォルダIDまたはselfフォルダ・ディレクトリの下のディレクトリ・ツリー全体が検索されます。 共有フォルダも検索します。 検索には、10000アイテム(フォルダおよびファイル)の制限があります。

リクエスト

サポートされるメディア・タイプ
パス・パラメータ

  • フォルダのグローバル一意識別子(GUID)。 参照されるフォルダがユーザーのホーム・フォルダの場合、folderIdの値はselfです。

問合せパラメータ

  • 返される追加フィールドを指定します。 現在サポートされている値はmetadataのみで、検索結果によって返されるアイテムに関連付けられたメタデータがレスポンスに追加されます。 デフォルトでは、検索結果にメタデータは返されません。 メタデータを返すには、次を使用 

    fields=metadata

  • フォルダまたはファイルの一致に使用される検索文字列。 次の場所を検索します: itemName、contents、extension、ownerName、lastModifiedName,およびfolderDescription。

    検索APIにfulltextまたはquerytextを指定する必要があります。

  • 返されるアイテムの最大数を指定します。 1ページの結果に含めるアイテム数を指定する場合は、このパラメータを使用します。 デフォルトは20で、最大は10000です。 次の例では、返されるアイテムの数を10に制限しています。 

    limit=10

  • アクションで返されるアイテムの全セットの中で、アイテムのリストを始める位置を指定します。 offsetを指定しない場合、返されるアイテムはリストの最初のアイテムで始まります(offset=0)。

    返されるアイテムの全セットから、特定ページの結果について開始地点を指定する場合は、このパラメータを使用します。 次の例では、1ページあたりのアイテム数を10に制限し、2ページ目の結果を表示します(アイテム11-20): 

    limit=10&offset=10

  • 取得されたアイテムを、指定したフィールドおよびソート順で並べ替えます。 name、size、lastModifiedNameおよびlastModifiedDateフィールドを使用でき、昇順(asc)ソートまたは降順(desc)ソートを使用できます。 たとえば、デフォルトは次のようになります。 

    orderby=name:asc

  • 下記のターゲットを使用してフォルダまたはファイルを検索するための検索文字列。 同時に複数のターゲットを利用して、fulltextを置き換えることができます。

    検索APIには、fulltextまたはquerytextパラメータを指定する必要があります。

    querytextパラメータは、次の文字列フィールドまたは番号フィールドに対して検索を対象とすることができます。 検索問合せの形式は次のとおりです: 

    searchField<operation>searchValue

    複数の検索を<AND>および<OR>と組み合わせることができます。 検索では大文字と小文字は区別されません。


    次の文字列フィールドがサポートされています:
    • xTags: タグを検索
    • fItemType: アイテム・タイプのみで検索するか、Fileでファイル・アイテムのみを返すか、Folderでフォルダ・アイテムのみを返す。
    • fItemName: アイテムの名前を検索します。
      レスポンスでは、これはnameフィールドです。
    • fCreator: アイテムの作成者のIDで検索します。
      レスポンスでは、これはcreatedBy.idフィールドです。
    • fCreatorFullName: アイテムの作成者の完全な表示名で検索します。
      レスポンスでは、これはcreatedBy.displayNameフィールドです。
    • fCreatorLoginName: アイテムの作成者のログイン名で検索します。
      レスポンスでは、これはcreatedBy.loginNameフィールドです。
    • fOwner: 品目の所有者のIDで検索します。
      レスポンスでは、これはownedBy.idフィールドです。
    • fOwnerFullName: 品目の所有者の完全な表示名で検索します。
      レスポンスでは、これはownedBy.displayNameフィールドです。
    • fOwnerLoginName: アイテムの所有者のログイン名で検索します。
      レスポンスでは、これはownedBy.loginNameフィールドです。
    • fLastModifier: ユーザーのIDで検索してアイテムを最後に変更します。
      レスポンスでは、これはmodifiedBy.idフィールドです。
    • fLastModifierFullName: アイテムを最後に変更するユーザーの完全な表示名で検索します。
      レスポンスでは、これはmodifiedBy.displayNameフィールドです。
    • fLastModifierLoginName: ユーザーのログイン名で検索し、最後にアイテムを変更します。
      レスポンスでは、これはmodifiedBy.loginNameフィールドです。
    • 検索可能なメタデータ・フィールドは、文字列検索ターゲットとしても検索できますが、メタデータ・フィールド値は検索によって戻されません。 メタデータ・フィールドで検索すると、ターゲットはMetadataCollectionName.metadataFieldNameになります。 メタデータの詳細については、「メタデータ・コレクションRESTエンドポイント」を参照してください

    文字列検索では、<CONTAINS>および<MATCHES>の操作がサポートされます。

    • <CONTAINS>演算子は、指定されたワードを含む検索対象のテキスト・フィールドを検索するように検索に指示します。 単語は、空白やピリオドなどのトークンで区切る必要があります。
    • <MATCHES>演算子は、空白やピリオドなど、フィールド値の完全一致(大/小文字を区別しない)を検索するように検索に指示します。


    次の日付フィールドがサポートされています:
    • fCreateDate: 作成されたタイムスタンプで検索します。 yyyy-mm-ddThh:mm:ssZ形式(2020-03-25T10:10:10Zなど)である必要があります。
      レスポンスでは、これはcreatedTimeフィールドです。
    • fLastModifiedDate: 最終変更タイムスタンプで検索します。 yyyy-mm-ddThh:mm:ssZ形式(2020-03-25T10:10:10Zなど)である必要があります。
      レスポンスでは、これはmodifiedTimeフィールドです。
    • 検索可能なメタデータ・フィールドを日付検索ターゲットとして検索することもできますが、メタデータ・フィールド値は検索で返されません。 メタデータ・フィールドで検索すると、ターゲットはMetadataCollectionName.metadataFieldNameになります。 メタデータの詳細については、「メタデータ・コレクションRESTエンドポイント」を参照してください

    次の番号フィールドがサポートされています:
    • dSize: アイテムのバイト単位のサイズで検索します。

    数値および日付の検索ターゲットでは、次の操作がサポートされます。

    • <を使用して、検索値より小さい値を検索します。< span>
    • =を使用して、検索値と等しい値を検索します。
    • >を使用して、検索値より大きい値を検索します。
    • 検索値以下の値を検索するには、& lt =を使用します。
    • >=を使用して、検索値以上の値を検索します。

ヘッダー・パラメータ

  • 現在のユーザーにこのフォルダへのアクセスを許可するApplinkアクセス・トークン。 このパラメータは、appLinkIDが使用されている場合は必須です。 これはaccessTokenまたはAccessTokenとして使用できます。

  • 現在のユーザーにこのフォルダへのアクセスを許可するApplink ID。 パラメータappLinkIDが使用されるときはいつでも、パラメータaccessTokenも提供されなければなりません。 appLinkIDまたはAppLinkIDとして使用できます。

  • 保護されたパブリック・リンクを使用するために必要なアクセス・コード。 次の形式のCookieヘッダーの一部として送信する必要があります: dAccessCode-<linkID>=<passcodeValue>

  • 現在のユーザーにこのフォルダへのアクセスを許可する、パブリック・リンクのパブリック・リンクID。 機能させるには、このパブリック・リンクにコントリビュータ・ロールが付与されている必要があります。 linkIDまたはLinkIDとして使用できます。

トップに戻る

レスポンス

サポートされるメディア・タイプ

200レスポンス

リクエストが処理されました。

本文 ()
ルート・スキーマ: SearchSpecificFolderContents
タイプ: object
ソースを表示
ネストされたスキーマ: items
タイプ: array
フォルダ階層内のファイルおよびサブフォルダ。
ソースを表示
ネストされたスキーマ : FileAndSubFoldersItemsDefinition
タイプ: object
フォルダ内のファイルおよびサブフォルダ。
ソースを表示
ネストされたスキーマ: User
タイプ: object
ユーザー情報
ソースを表示
レスポンスの例(application/json)
{
    "count":"2",
    "errorCode":"0",
    "offset":"1",
    "totalCount":"2",
    "items":[
        {
            "type":"file",
            "id":"DB4C832D0F144C0DD6310F451212FF6185DE5A6F9E67",
            "name":"textData13.txt",
            "parentID":"F9363F588099E137C5B2939E1212FF6185DE5A6F9E67",
            "createdTime":"2015-12-07T23:19:13Z",
            "modifiedTime":"2015-12-07T23:19:13Z",
            "createdBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "ownedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "modifiedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "metadata":{
                "items":[
                    {
                        "name":"MyMetaCollection",
                        "fields":{
                            "items":[
                                {
                                    "name":"IntField",
                                    "type":"integer",
                                    "value":"246"
                                },
                                {
                                    "name":"DateField",
                                    "type":"date",
                                    "value":"2019-02-22T17:03:00.000Z"
                                }
                            ]
                        }
                    }
                ]
            },
            "size":"38",
            "version":"1"
        },
        {
            "type":"file",
            "id":"D242D99558418023F547247DB5D17B95F470BB4C11B8",
            "name":"textData15.txt",
            "parentID":"F9363F588099E137C5B2939E1212FF6185DE5A6F9E67",
            "createdTime":"2015-12-09T20:51:53Z",
            "modifiedTime":"2015-12-09T20:51:53Z",
            "createdBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "ownedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "modifiedBy":{
                "displayName":"User AA",
                "id":"U0EAA20910FAF3052ACB79E4T00000000001",
                "loginName":"userAALoginName",
                "type":"user"
            },
            "metadata":{
                "items":[
                ]
            },
            "size":"50"
        }
    ]
}

400レスポンス

リクエスト・パラメータが正しい形式ではありません。

トップに戻る

例

次の例では、ルート・フォルダIDで指定された特定のディレクトリで、fulltextによってフォルダまたはファイルを検索します。 これは、特定のフォルダIDまたはselfフォルダにすることができます。 フォルダIDがselfの場合でも、この検索には共有フォルダは含まれません。 

GET .../folders/F9363F588099E137C5B2939E1212FF6185DE5A6F9E67/search/items?fulltext=txt&orderby=modifiedTime:asc&limit=2&offset=1

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "1",
    "errorCode": "0",
    "offset": "1",
    "totalCount": "1",
    "items": [
		{
            "type": "file",
            "id": "DB4C832D0F144C0DD6310F451212FF6185DE5A6F9E67",
            "name": "textData13.txt",
            "parentID": "F9363F588099E137C5B2939E1212FF6185DE5A6F9E67",
            "createdTime": "2015-12-07T23:19:13Z",
            "modifiedTime": "2015-12-07T23:19:13Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "38",
            "version": "1"
        }
    ]
}

例2

次の例では、無効なorderbyソート・フィールドを使用してフォルダまたはファイルを検索します。 

GET .../folders/F9363F588099E137C5B2939E1212FF6185DE5A6F9E67/search/items?fulltext=three&orderby=date

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 400

JSONレスポンス

{
    "count": "0",
    "errorCode": "-96",
    "errorKey": "!csUnableToRetrieveSearchResults!csCloudOTSSearchInvalidSortField",
    "errorMessage": "Unable to retrieve search results. SortField is not valid.",
    "title": "Unable to retrieve search results. SortField is not valid.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

例3

次の例では、無効なorderbyソート順序を使用してフォルダまたはファイルを検索します。 

GET .../folders/F9363F588099E137C5B2939E1212FF6185DE5A6F9E67/search/items?fulltext=three&orderby=name:descending

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 400

JSONレスポンス

{
    "count": "0",
    "errorCode": "-96",
    "errorKey": "!csUnableToRetrieveSearchResults!csSortOrderInvalid,descending",
    "errorMessage": "Unable to retrieve search results. Sort order 'descending' is invalid. Should be \"DESC\" or \"ASC\".",
    "title": "Unable to retrieve search results. Sort order 'descending' is invalid. Should be \"DESC\" or \"ASC\".",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

例4

次の例では、fulltext検索基準のないフォルダまたはファイルを検索します。 

GET .../folders/F9363F588099E137C5B2939E1212FF6185DE5A6F9E67/search/items

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 400

JSONレスポンス

{
    "count": "0",
    "errorCode": "-97",
    "errorKey": "!csUnableToRetrieveSearchResults!csSearchMissingQueryText",
    "errorMessage": "Unable to retrieve search results. QueryText is missing.",
    "title": "Unable to retrieve search results. QueryText is missing.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

例5

次の例では、無効な限度を使用してフォルダまたはファイルを検索します。

GET .../folders/F9363F588099E137C5B2939E1212FF6185DE5A6F9E67/search/items?fulltext=test&orderby=size:asc&limit=0

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 400

JSONレスポンス

{
    "count": "0",
    "errorCode": "-1",
    "errorKey": "!csUnableToRetrieveSearchResults!csSearchItemNotPositive,ResultCount",
    "errorMessage": "Unable to retrieve search results. ResultCount must be greater than 0.",
    "title": "Unable to retrieve search results. ResultCount must be greater than 0.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

例6

次の例では、ルート・フォルダIDで指定された特定のディレクトリで、fulltextによってフォルダまたはファイルを検索します。 これは、特定のフォルダIDまたはselfフォルダにすることができます。 フォルダIDがselfの場合でも、この検索には共有フォルダは含まれません。 このフォルダは現在のユーザーに所有または共有されていないフォルダ構造にあるため、この例では、パブリック・リンクIDを使用します。 

GET .../folders/F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518/search/items?fulltext=txt&orderby=modifiedTime:asc&limit=2&offset=1

リクエスト・ヘッダー

LinkID: LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "2",
    "errorCode": "0",
    "offset": "1",
    "totalCount": "3",
    "items": [
        {
            "type": "file",
            "id": "DBEB2E535903F1EE642C08A4B5D17B95F47087F4E518",
            "name": "idcTestNewFileRESTNewNew.txt",
            "parentID": "F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518",
            "createdTime": "2016-07-01T00:24:38Z",
            "modifiedTime": "2016-07-01T00:24:38Z",
            "createdBy": {
                "displayName": "User BB",
                "loginName": "userBBLoginName",
                "id": "U0EBB20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User BB",
                "loginName": "userBBLoginName",
                "id": "U0EBB20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User BB",
                "loginName": "userBBLoginName",
                "id": "U0EBB20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "39",
            "version": "1"
        },
        {
            "type": "file",
            "id": "DBFC40982617C949CA373B08B5D17B95F47087F4E518",
            "name": "idcTestNewFile1KB.txt",
            "parentID": "F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518",
            "createdTime": "2016-06-27T22:47:34Z",
            "modifiedTime": "2016-07-06T23:39:08Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "33",
            "version": "9"
        }
    ]
}

例7

次の例では、ルート・フォルダIDで指定された特定のディレクトリで、fulltextによってフォルダまたはファイルを検索します。 これは、特定のフォルダIDまたはselfフォルダにすることができます。 フォルダIDがselfの場合でも、この検索には共有フォルダは含まれません。 このフォルダは現在のユーザーに所有または共有されていないフォルダ構造にあるため、この例では、アクセス・コードで保護されているパブリック・リンクIDを使用します。 アクセス・コード( test12345)は、Cookieの一部としてリクエスト・ヘッダーに発行されます。 

GET .../folders/F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518/search/items?fulltext=txt&orderby=modifiedTime:asc&limit=2&offset=1

リクエスト・ヘッダー

LinkID: LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518
Cookie: dAccessCode-LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518=test12345

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "2",
    "errorCode": "0",
    "offset": "1",
    "totalCount": "3",
    "items": [
        {
            "type": "file",
            "id": "DBEB2E535903F1EE642C08A4B5D17B95F47087F4E518",
            "name": "idcTestNewFileRESTNewNew.txt",
            "parentID": "F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518",
            "createdTime": "2016-07-01T00:24:38Z",
            "modifiedTime": "2016-07-01T00:24:38Z",
            "createdBy": {
                "displayName": "User BB",
                "loginName": "userBBLoginName",
                "id": "U0EBB20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User BB",
                "loginName": "userBBLoginName",
                "id": "U0EBB20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "39",
            "version": "1"
        },
        {
            "type": "file",
            "id": "DBFC40982617C949CA373B08B5D17B95F47087F4E518",
            "name": "idcTestNewFile1KB.txt",
            "parentID": "F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518",
            "createdTime": "2016-06-27T22:47:34Z",
            "modifiedTime": "2016-07-06T23:39:08Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "33",
            "version": "9"
        }
    ]
}

例8

次の例では、ルート・フォルダIDで指定された特定のディレクトリで、fulltextによるフォルダまたはファイル検索をリクエストします。 このフォルダは現在のユーザーに所有または共有されていないフォルダ構造にあるため、アクセス拒否エラー・メッセージが返されます。 

GET .../folders/F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518/search/items?fulltext=txt&orderby=modifiedTime:asc&limit=2&offset=1

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 403

JSONレスポンス

{
    "count": "0",
    "errorCode": "-20",
    "errorKey": "!csUnableToRetrieveSearchResults!csCloudItemInsufficientPrivileges,User BB,fFolderGUID:F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518,GET_SEARCH_RESULTS",
    "errorMessage": "Unable to retrieve search results. User 'User BB' has insufficient privilege to access fFolderGUID:F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518 with service GET_SEARCH_RESULTS.",
    "errorType": "folder",
    "id": "F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518",
    "limit": "2",
    "offset": "1",
    "querytext": "<ftx>txt</ftx>",
    "title": "Unable to retrieve search results. User 'User BB' has insufficient privilege to access fFolderGUID:F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518 with service GET_SEARCH_RESULTS.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

例9

次の例では、ルート・フォルダIDで指定された特定のディレクトリで、fulltextによるフォルダまたはファイル検索をリクエストします。 このフォルダは現在のユーザーに所有または共有されていないフォルダ構造にあります。また、アクセス・コードで保護されているパブリック・リンクのみを使用可能です。 アクセス・コードがリクエストの一部として送信されなかったため、エラーが返されます。 

GET .../folders/F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518/search/items?fulltext=txt&orderby=modifiedTime:asc&limit=2&offset=1

リクエスト・ヘッダー

LinkID: LF8D36FAFAB4388BECEAC4AEB5D17B95F47087F4E518

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 403

JSONレスポンス

{
    "count": "0",
    "errorCode": "-18",
    "errorKey": "!csUnableToRetrieveSearchResults!csAccessCodeRequiredForLinkAccess",
    "errorMessage": "Unable to retrieve search results. The access code must be provided to access the link.",
    "errorType": "folder",
    "id": "F4AB9FC75860ECB429D36BA2B5D17B95F47087F4E518",
    "limit": "2",
    "offset": "1",
    "querytext": "<ftx>txt</ftx>",
    "title": "Unable to retrieve search results. The access code must be provided to access the link.",
    "type": "https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html"
}

例10

次の例では、特定のフォルダ内の特定のタグがあるフォルダまたはファイルを検索します。 この検索には、指定したフォルダの下のディレクトリ・ツリー全体が含まれます。 タグ値は、%60で表される`のエンコードされた値で区切る必要があります。 フォルダIDがselfの場合でも、この検索には共有フォルダは含まれません。 

GET .../folders/F9363F588099E137C5B2939E1212FF6185DE5A6F9E67/search/items?querytext=xtags<CONTAINS>%60personal%60

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "2",
    "errorCode": "0",
    "offset": "0",
    "totalCount": "2",
    "items": [
        {
            "type": "folder",
            "id": "FF4321BD2656077C897A0E701212FF6185DE5A6F9E68",
            "name": "subFolderTest",
            "parentID": "F9363F588099E137C5B2939E1212FF6185DE5A6F9E67",
            "createdTime": "2015-12-09T20:51:53Z",
            "modifiedTime": "2015-12-09T20:51:53Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "-1"
        },
        {
            "type": "file",
            "id": "DB4C832D0F144C0DD6310F451212FF6185DE5A6F9E67",
            "name": "textData13.txt",
            "parentID": "F9363F588099E137C5B2939E1212FF6185DE5A6F9E67",
            "createdTime": "2015-12-07T23:19:13Z",
            "modifiedTime": "2015-12-07T23:19:13Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "38",
            "version": "1"
        }
    ]
}

例11

次の例では、同時にテキスト・ファイル検索を使用して、特定のフォルダ内の特定のタグがあるフォルダまたはファイルを検索します。 この検索には、指定したフォルダの下のディレクトリ・ツリー全体が含まれます。 タグ値は、%60で表される`のエンコードされた値で区切る必要があります。 フォルダIDがselfの場合でも、この検索には共有フォルダは含まれません。 

GET .../folders/F9363F588099E137C5B2939E1212FF6185DE5A6F9E67/search/items?querytext=xtags<CONTAINS>%60personal%60<AND><ftx>txt</ftx>

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "1",
    "errorCode": "0",
    "offset": "0",
    "totalCount": "1",
    "items": [
        {
            "type": "file",
            "id": "DB4C832D0F144C0DD6310F451212FF6185DE5A6F9E67",
            "name": "textData13.txt",
            "parentID": "F9363F588099E137C5B2939E1212FF6185DE5A6F9E67",
            "createdTime": "2015-12-07T23:19:13Z",
            "modifiedTime": "2015-12-07T23:19:13Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "38",
            "version": "1"
        }
    ]
}

例12

次の例では、特定のメタデータ値を持つフォルダまたはファイルを検索します。 この検索には、指定したフォルダの下のディレクトリ・ツリー全体が含まれます。 メタデータ値は、%60で表される`の符号化された値によって区切られなければなりません。 フォルダIDがselfの場合でも、この検索には共有フォルダは含まれません。 

GET .../folders/F454F4DE5EF397E880FFA186B5D17B95F47087F4E518/search/items?querytext=SearchableCollection.searchField1<CONTAINS>%60searchValue1%60

リクエスト・ヘッダー

なし。

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "5",
    "errorCode": "0",
    "offset": "0",
    "totalCount": "5",
    "items": [
        {
            "type": "folder",
            "id": "F454F4DE5EF397E880FFA186B5D17B95F47087F4E518",
            "name": "subFolder",
            "parentID": "FECEAA81A82C83700E64B43EB5D17B95F47087F4E518",
            "createdTime": "2016-10-10T13:54:09Z",
            "modifiedTime": "2016-10-10T13:54:09Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "-1"
        },
        {
            "type": "file",
            "id": "D93A34CA721F82C77031708DB5D17B95F47087F4E518",
            "name": "file4.txt",
            "parentID": "FECEAA81A82C83700E64B43EB5D17B95F47087F4E518",
            "createdTime": "2016-09-21T14:08:54Z",
            "modifiedTime": "2016-09-21T14:08:54Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "25",
            "version": "1"
        },
        {
            "type": "file",
            "id": "DCDBEBB4803B7EE48E4B073AB5D17B95F47087F4E518",
            "name": "file3.txt",
            "parentID": "FECEAA81A82C83700E64B43EB5D17B95F47087F4E518",
            "createdTime": "2016-09-21T14:08:13Z",
            "modifiedTime": "2016-09-21T14:08:13Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "25",
            "version": "1"
        },
        {
            "type": "file",
            "id": "D8E8B2ABABAA0E42D3E4964CB5D17B95F47087F4E518",
            "name": "file2.txt",
            "parentID": "FECEAA81A82C83700E64B43EB5D17B95F47087F4E518",
            "createdTime": "2016-09-21T14:08:00Z",
            "modifiedTime": "2016-09-21T14:08:00Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "25",
            "version": "1"
        },
        {
            "type": "file",
            "id": "D1A21D80F7FDD74E9FD93695B5D17B95F47087F4E518",
            "name": "file1.txt",
            "parentID": "FECEAA81A82C83700E64B43EB5D17B95F47087F4E518",
            "createdTime": "2016-09-21T14:07:06Z",
            "modifiedTime": "2016-09-21T14:07:06Z",
            "createdBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User AA",
                "loginName": "userAALoginName",
                "id": "U0EAA20910FAF3052ACB79E4T00000000001",
                "type": "user"
            },
            "size": "25",
            "version": "1"
        }
    ]
}

例13

次の例では、ルート・フォルダIDで指定された特定ディレクトリで、フォルダまたはファイルをfulltextで検索します。 この検索には共有フォルダは含まれません。 現在のユーザーが所有していない、または共有していないフォルダ構造の下にあるため、この例ではapplink IDを使用しています。 applink IDとアクセス・トークンはリクエスト・ヘッダーに送信されます。 

GET .../folders/FAD7A87F0613A0CBDD4DA521B5D17B95F47087F4E518/search/items?fulltext=subFolderTestByUserB&orderby=modifiedTime:asc

リクエスト・ヘッダー

appLinkID: LF5Bxj4TPo_p4n4qWn0tbKTicR2cTUJKv7X_ng9E7ry93rRuDokPqS1d6-wKwhb_wtcGYFDsI_cNMxeKQ-HR-FXQhiVoGRTYM_MPZY8qpICfYU94mmnMjM_cvsRhKMzc0NJgvwEJfqqDwPsAVrhc8cmg==
accessToken: 352FpiMmW66PeYI1Gh5b83I9CXRwZhLfYAu4TXdqpzD8uNKUBMZVVJ3ZvivUW8kQ

リクエスト本文

なし。

HTTPステータス・コード

HTTP_STATUS = 200

JSONレスポンス

{
    "count": "2",
    "errorCode": "0",
    "offset": "0",
    "totalCount": "2",
    "items": [
        {
            "type": "folder",
            "id": "F62E96098A6F9186F94730C1B5D17B95F47087F4E518",
            "name": "subFolderTestByUserB(2)",
            "parentID": "F64529EF770DCF96F029ED82B5D17B95F47087F4E518",
            "createdTime": "2017-06-16T20:37:03Z",
            "modifiedTime": "2017-06-16T20:45:01Z",
            "createdBy": {
                "displayName": "User BB",
                "id": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "loginName": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "id": "UEB6AD431E4357AE752CE3F2B5D17B95F470",
                "loginName": "userAALoginName",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User BB",
                "id": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "loginName": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "type": "user"
            },
            "size": "-1",
            "description": "subFolderTestByUserB CONTRIBUTOR applink - EDITED"
        },
        {
            "type": "folder",
            "id": "F64529EF770DCF96F029ED82B5D17B95F47087F4E518",
            "name": "subFolderTestByUserB",
            "parentID": "FAD7A87F0613A0CBDD4DA521B5D17B95F47087F4E518",
            "createdTime": "2017-06-16T18:10:05Z",
            "modifiedTime": "2017-06-19T20:11:33Z",
            "createdBy": {
                "displayName": "User BB",
                "id": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "loginName": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "type": "user"
            },
            "ownedBy": {
                "displayName": "User AA",
                "id": "UEB6AD431E4357AE752CE3F2B5D17B95F470",
                "loginName": "userAALoginName",
                "type": "user"
            },
            "modifiedBy": {
                "displayName": "User BB",
                "id": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "loginName": "U5083EA1954687218BA6C3D9B5D17B95F470",
                "type": "user"
            },
            "size": "-1",
            "description": "subFolderTestByUserB CONTRIBUTOR applink - EDITED"
        }
    ]
}
先頭に戻る