次の方法で共有


driveItem の子を一覧表示する

名前空間: microsoft.graph

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

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

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この 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 クエリ パラメーター をサポートします。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
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 https://graph.microsoft.com/v1.0/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 も提供されます。

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

エラー応答

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