SpecialFolder リソースの種類

SpecialFolderリソースは、特殊フォルダー関連のデータ項目を単一の構造にグループ化します。

DriveItem が null 以外の specialFolder ファセットを持つ場合、その項目は特殊な (名前が付けられた) フォルダーを示します。 特殊なフォルダーは 特殊なフォルダーのコレクション 経由で直接アクセスできます。

特殊なフォルダーは、フォルダーを (ローカライズが必要となる) パスで探したり、ID を持つフォルダーを参照したりせずに、既知のフォルダーにアクセスするための、単純なエイリアスを提供します。 特殊なフォルダーが名前変更されたりドライブ内の別の場所に移動されたりした場合、この構文はそのフォルダーを返し続けます。

特殊なフォルダーは、まだ存在していない場合、アプリケーションが最初に書き込みを試行したときに自動的に作成されます。 ユーザーが削除した場合は、もう一度書き込まれたときに再作成されます。

注: アプリが Files.Read スコープのみを要求していて、存在しない特殊なフォルダーを要求する場合、返答は 403 Forbidden エラーになります。

JSON 表記

{
  "name": "string"
}

プロパティ

プロパティ 説明
name string /drive/special コレクション内のこの項目の一意識別子

特殊なフォルダー

OneDrive と OneDrive for Businessで使用できる特別なフォルダーを次に示します。

名前 フォルダー ID 説明
App Root approot そのアプリケーションの個人用フォルダー。 通常は /Apps/{Application Name}
Camera Roll cameraroll カメラ ロールのバックアップ フォルダー。
デスクトップ desktop デスクトップ フォルダー。
Documents documents ドキュメント フォルダー。
Music music ミュージック フォルダー。
Photos photos フォト フォルダーです。

備考

DriveItem のファセットの詳細については、「DriveItem」を参照してください。