次の方法で共有

設定を更新する

  • [アーティクル]

名前空間: microsoft.graph

SharePoint と OneDrive の 1 つ以上のテナント レベル の設定 を更新します。

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

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

アクセス許可

この API の最小特権としてマークされているアクセス許可またはアクセス許可を選択します。 アプリで必要な場合にのみ、より高い特権のアクセス許可またはアクセス許可を使用します。 委任されたアクセス許可とアプリケーションのアクセス許可の詳細については、「アクセス許可の種類」を参照してください。 これらのアクセス許可の詳細については、「アクセス許可のリファレンス」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) SharePointTenantSettings.ReadWrite.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション SharePointTenantSettings.ReadWrite.All 注意事項なし。

ユーザーの代わりにを呼び出す場合、ユーザーは SharePoint 管理者ロールに属している必要があります。 管理者ロールの詳細については、「Microsoft 365 管理センターの管理者ロールについて」を参照してください。

HTTP 要求

PATCH /admin/sharepoint/settings

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
Content-Type application/json. 必須です。

要求本文

要求本文で、更新するプロパティの値 のみを 指定します。 要求本文に含まれていない既存のプロパティは、以前の値を維持するか、他のプロパティ値の変更に基づいて再計算されます。

次の表に、更新できるプロパティを示します。

プロパティ 型 説明
allowedDomainGuidsForSyncApp GUID コレクション OneDrive 同期 アプリの信頼されたドメイン GUID のコレクション。
deletedUserPersonalSiteRetentionPeriodInDays Int32 削除されたユーザーの OneDrive を保持するための日数。
excludedFileExtensionsForSyncApp String collection OneDrive 同期 アプリによってアップロードされていないファイル拡張子のコレクション。
idleSessionSignOut microsoft.graph.idleSessionSignOut テナントのアイドル セッション サインアウト ポリシーを指定します。
imageTaggingOption imageTaggingChoice テナントのイメージタグ付けオプションを指定します。 可能な値は disabled、basic、enhanced です。
isCommentingOnSitePagesEnabled ブール型 SharePoint のモダン サイト ページでコメントを許可するかどうかを示します。
isFileActivityNotificationEnabled ブール型 OneDrive イベントに対してプッシュ通知が有効かどうかを示します。
isLegacyAuthProtocolsEnabled ブール型 テナントに対してレガシ認証プロトコルが有効になっているかどうかを示します。
isLoopEnabled ブール型 SharePoint サイトで Fluid Framework が許可されているかどうかを示します。
isMacSyncAppEnabled ブール型 mac 用OneDrive 同期 アプリを使用してファイルを同期できるかどうかを示します。
isRequireAcceptingUserToMatchInvitedUserEnabled ブール型 ゲストが、共有の招待が送信されるのと同じアカウントを使用してサインインする必要があるかどうかを示します。
isResharingByExternalUsersEnabled ブール型 ゲストが所有していないファイル、フォルダー、サイトを再共有できるかどうかを示します。
isSharePointMobileNotificationEnabled ブール型 モバイル プッシュ通知が SharePoint に対して有効になっているかどうかを示します。
isSharePointNewsfeedEnabled ブール型 SharePoint のモダン サイト ページでニュースフィードを許可するかどうかを示します。
isSiteCreationEnabled ブール型 ユーザーがサイトの作成を許可されているかどうかを示します。
isSiteCreationUIEnabled ブール型 サイトを作成するための UI コマンドを表示するかどうかを示します。
isSitePagesCreationEnabled ブール型 SharePoint サイトで新しいモダン ページの作成を許可するかどうかを示します。
isSitesStorageLimitAutomatic ブール型 サイトのストレージ領域が自動的に管理されるかどうか、またはサイトごとに特定のストレージ制限が設定されているかどうかを示します。
isSyncButtonHiddenOnPersonalSite ブール型 OneDrive の同期ボタンが非表示かどうかを示します。
isUnmanagedSyncAppForTenantRestricted ブール型 ユーザーが特定のドメインに参加している PC でのみファイルを同期できるかどうかを示します。
personalSiteDefaultStorageLimitInMB Int64 対象となるライセンスが割り当てられているすべての新規ユーザーと既存ユーザーの既定の OneDrive ストレージ制限。 メガバイト (MB) 単位で測定されます。
sharingAllowedDomainList String collection organizationの外部で共有できる電子メール ドメインのコレクション。
sharingBlockedDomainList String collection organizationの外部で共有するためにブロックされている電子メール ドメインのコレクション。
sharingCapability sharingCapabilities テナントの共有機能。 使用可能な値は、disabled、externalUserSharingOnly、externalUserAndGuestSharing、existingExternalUserSharingOnly です。
sharingDomainRestrictionMode sharingDomainRestrictionMode ドメインの外部への共有モードを指定します。 可能な値は none、allowList、blockList です。
siteCreationDefaultManagedPath String チーム サイトの管理パスの値。 これは、新しいチーム サイトが作成されるパスです。
siteCreationDefaultStorageLimitInMB Int32 作成時の新しいサイトの既定のストレージ クォータ。 メガバイト (MB) 単位で測定されます。
tenantDefaultTimezone String 新しく作成されたサイトのテナントの既定のタイムゾーン。 使用可能な値の一覧については、「 SPRegionalSettings.TimeZones プロパティ」を参照してください。

応答

成功した場合、このメソッドは 200 OK 応答コードと、応答本文で更新された 設定 オブジェクトを返します。

例

要求

次の例は要求を示しています。

PATCH https://graph.microsoft.com/v1.0/admin/sharepoint/settings
Content-Type: application/json
Content-length: 1323

{
    "deletedUserPersonalSiteRetentionPeriodInDays": 365,
    "excludedFileExtensionsForSyncApp": [".mp3"],
    "imageTaggingOption": "enhanced",
    "isLegacyAuthProtocolsEnabled": true,
    "isSitesStorageLimitAutomatic": false,
    "isSyncButtonHiddenOnPersonalSite": false,
    "isUnmanagedSyncAppForTenantRestricted": false,
    "personalSiteDefaultStorageLimitInMB": 120000
}

応答

次の例は応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

{
    "@odata.type": "#microsoft.graph.sharepointSettings",
    "allowedDomainGuidsForSyncApp": [
        "bdd1ab9b-3fd0-4def-a761-ec8d7471732c", 
        "ad31vb6b-5zd0-7tyg-m231-kj8d6578432c"
    ],
    "availableManagedPathsForSiteCreation": [
        "/sites/",
        "/teams/"
    ],
    "deletedUserPersonalSiteRetentionPeriodInDays": 365,
    "excludedFileExtensionsForSyncApp": [
        ".mp3"
    ],
    "idleSessionSignOut": {
        "isEnabled": true,
        "warnAfterInSeconds": 120,
        "signOutAfterInSeconds": 300
    },
    "imageTaggingOption": "basic",
    "isCommentingOnSitePagesEnabled": true,
    "isFileActivityNotificationEnabled": true,
    "isLegacyAuthProtocolsEnabled": true,
    "isLoopEnabled": true,
    "isMacSyncAppEnabled": false,
    "isRequireAcceptingUserToMatchInvitedUserEnabled": true,
    "isResharingByExternalUsersEnabled": true,
    "isSharePointMobileNotificationEnabled": true,
    "isSharePointNewsfeedEnabled": true,
    "isSiteCreationEnabled": true,
    "isSiteCreationUIEnabled": true,
    "isSitePagesCreationEnabled": true,
    "isSitesStorageLimitAutomatic": false,
    "isSyncButtonHiddenOnPersonalSite": false,
    "isUnmanagedSyncAppForTenantRestricted": false,
    "personalSiteDefaultStorageLimitInMB": 120000,
    "sharingAllowedDomainList" : [
        "contoso.com",
        "fabrikam.com"
    ],
    "sharingBlockedDomainList" : [
        "contoso.com",
        "fabrikam.com"
    ],
    "sharingCapability": "externalUserAndGuestSharing",
    "sharingDomainRestrictionMode": "allowList",
    "siteCreationDefaultManagedPath": "/sites/",
    "siteCreationDefaultStorageLimitInMB": 808034,
    "tenantDefaultTimezone": "(UTC-05:00) Eastern Time (US and Canada)"
}