driveItem の子を一覧表示する

DriveItem の子リレーションシップで DriveItems のコレクションを返します。

NULL でない folder または package ファセットがある DriveItems は、1 つ以上の子 DriveItems を持つことができます。

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類	アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)	Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All
委任 (個人用 Microsoft アカウント)	Files.Read、Files.ReadWrite、Files.Read.All、Files.ReadWrite.All
アプリケーション	Files.Read.All、Files.ReadWrite.All、Sites.Read.All、Sites.ReadWrite.All

HTTP 要求

GET /drives/{drive-id}/items/{item-id}/children
GET /groups/{group-id}/drive/items/{item-id}/children
GET /me/drive/items/{item-id}/children
GET /sites/{site-id}/drive/items/{item-id}/children
GET /users/{user-id}/drive/items/{item-id}/children

オプションのクエリ パラメーター

このメソッドは、応答を $expandカスタマイズするために、、 $select、 $skipToken、 $top および $orderbyOData クエリ パラメーター をサポートします。

オプションの要求ヘッダー

名前	値	説明
if-none-match	etag	この要求ヘッダーが含まれている場合、指定された eTag (または cTag) がファイルの現在のタグに一致すると、HTTP 304 Not Modified 応答が返されます。

例

現在のユーザーのドライブのルートの子を一覧表示する

ドライブのルートのファイルを取得するには、ドライブ上の root リレーションシップを使用して、子のリレーションシップにアクセスします。

GET /me/drive/root/children

既知の ID を持つ DriveItem の子を一覧表示する

ドライブのルートのファイルを取得するには、ドライブ上の root リレーションシップを使用して、子のリレーションシップにアクセスします。

GET /drives/{drive-id}/items/{item-id}/children

既知のパスを持つ DriveItem の子を一覧表示する

GET /drives/{drive-id}/root:/{path-relative-to-root}:/children

応答

成功すると、このメソッドはターゲット アイテムの子コレクション内にあるアイテムの一覧を返します。 子コレクションは、driveItem リソースで構成されます。

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {"name": "myfile.jpg", "size": 2048, "file": {} },
    {"name": "Documents", "folder": { "childCount": 4} },
    {"name": "Photos", "folder": { "childCount": 203} },
    {"name": "my sheet(1).xlsx", "size": 197 }
  ],
  "@odata.nextLink": "https://..."
}

注:コレクションが既定のページ サイズ (200 アイテム) を超えた場合は、応答で @odata.nextLink プロパティが返され、より多くのアイテムが使用できることが示されます。また、アイテムの次のページの要求 URL も提供されます。

ページ サイズはオプションのクエリ文字列パラメーターで制御できます。

エラー応答

エラーがどのように返されるかについては、「エラー応答」を参照してください。