POST api/v1/group/Permission/export

特定のグループの権限関連情報をエクスポートすることで .zip ファイルを取得します。

http://hostname:port/api/v1/group/Permission/export

{

“Emails”: [“Group ID 1”, “Group ID 2”],

“siteUrls”: [

“https://yourcompany.sharepoint.com/sites/site01”,

“https://yourcompany.sharepoint.com/sites/site02”

“dataSources”: [“Microsoft Teams”, “SharePoint Online”],

“ExportOptionType”: 2,

“Language”: “en-US”

}

要素	説明	種類	必須
Emails	レポートをエクスポートしようとしているグループの IDを設定します。	String Array	はい
SiteUrl	グループのレポートをエクスポートするサイトコレクションを設定します。最大 100 件のサイトコレクションを設定できます。	String Array	いいえ
dataSources	グループのレポートをエクスポートするワークスペースを設定します。複数の値が許可されます。	String Array 有効な値は次のとおりです。 Microsoft Teams SharePoint Online OneDrive Microsoft 365 グループ	はい
ExportOptionType	エクスポートしようとしているレポートのエクスポートオプションを設定します。	Int 有効な値は次のとおりです。 1 (サマリーレポートとサイトコレクションレベルのアクセスレポートの両方をエクスポートします) 2 (サマリーレポートと構成済みデータ範囲内のすべてのオブジェクトに対するアクセスレポートの両方をエクスポートします) 3 (サマリーレポートのみをエクスポートします)	はい
Language	取得しようとしている情報の言語を設定します。	String 有効な値は次のとおりです。 en-US (英語) (既定) ja-JP (日本語) fr-FR (フランス語)	いいえ

^*注意: すべてのグループのレポートをエクスポートするには、emails を空にして、exportOptionType で 3 が設定されていることを確認してください。

この API を使用して .zip ファイルはエクスポートされます。定義したエクスポートオプションに基づいて、エクスポートされたレポートが異なります。

• サマリーレポートのみをエクスポートする場合、エクスポート範囲内のグループのサマリーレポートが .zip ファイルに含まれます。

• サマリーレポートとサイトコレクションレベルのアクセスレポートの両方をエクスポートする場合、エクスポート範囲内のすべてのグループのサマリーレポートと、構成済みデータ範囲内のサイトコレクションへのこれらのグループのアクセスレポートが .zip ファイルに含まれます。

• サマリーレポートとアクセスレポートの両方をエクスポートする場合、エクスポート範囲内のサマリーレポートと各グループの構成済みデータ範囲内のすべてのオブジェクトに対するアクセスレポートがそれぞれ .zip ファイルに含まれます。

要素	説明	種類
getFileUrl	エクスポートされた権限レポートファイルを取得する API URL です。	String
id	エクスポートされた権限レポートファイルの固有 ID です。	Int