次の方法で共有


officeSuiteApp を作成する

名前空間: microsoft.graph

大事な: /beta バージョンの Microsoft Graph API は変更される可能性があります。運用環境での使用はサポートされていません。

注:Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンスが必要です。

新しい officeSuiteApp オブジェクトを 作成します。

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

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

アクセス許可

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

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

HTTP 要求

POST /deviceAppManagement/mobileApps

要求ヘッダー

ヘッダー
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。
承諾 application/json

要求本文

要求本文で、officeSuiteApp オブジェクトの JSON 表現を指定します。

次の表は、officeSuiteApp を作成するときに必要なプロパティを示しています。

プロパティ 説明
id String エンティティのキー。 このプロパティは読み取り専用です。 mobileApp から継承します
displayName String 管理者が提供またはインポートしたアプリのタイトル。 mobileApp から継承します
description String アプリの説明。 mobileApp から継承します
publisher String アプリの発行元。 mobileApp から継承します
largeIcon mimeContent アプリの詳細に表示され、アイコンのアップロードに使用される大きいアイコン。 mobileApp から継承します
createdDateTime DateTimeOffset アプリが作成された日時。 このプロパティは読み取り専用です。 mobileApp から継承します
lastModifiedDateTime DateTimeOffset アプリが最後に変更された日時。 このプロパティは読み取り専用です。 mobileApp から継承します
isFeatured Boolean アプリが管理者のおすすめとしてマークされたかどうかを示す値。mobileApp から継承します
privacyInformationUrl String プライバシーに関する声明の URL。 mobileApp から継承します
informationUrl String 詳細情報の URL。 mobileApp から継承します
owner String アプリの所有者。 mobileApp から継承します
developer String アプリの開発者。 mobileApp から継承します
notes String アプリ用のメモ。 mobileApp から継承します
uploadState Int32 アップロードの状態。 使用可能な値は、0 - Not Ready、1 - Ready、2 - Processingです。 このプロパティは読み取り専用です。 mobileApp から継承します
publishingState mobileAppPublishingState アプリの発行の状態。 アプリが発行されていない限り、アプリを割り当てることができません。 このプロパティは読み取り専用です。 mobileApp から継承されます。 可能な値は notPublishedprocessingpublished です。
isAssigned ブール型 アプリが少なくとも 1 つのグループに割り当てられているかどうかを示す値。 このプロパティは読み取り専用です。 mobileApp から継承します
roleScopeTagIds String collection このモバイル アプリのスコープ タグ ID の一覧。 mobileApp から継承します
dependentAppCount Int32 子アプリに含まれる依存関係の合計数。 このプロパティは読み取り専用です。 mobileApp から継承します
supersedingAppCount Int32 このアプリが直接的または間接的に置き換わるアプリの合計数。 このプロパティは読み取り専用です。 mobileApp から継承します
置き換えAppCount Int32 このアプリが直接または間接的に置き換えられるアプリの合計数。 このプロパティは読み取り専用です。 mobileApp から継承します
autoAcceptEula ブール型 エンドユーザーのデバイスで EULA を自動的に受け入れる値。
productIds officeProductId コレクション Office365 Suite SKU を表す製品 ID。 使用可能な値: o365ProPlusRetailo365BusinessRetailvisioProRetailprojectProRetail
excludedApps excludedApps 選択した Office365 製品 ID から除外されるアプリを表す プロパティ。
useSharedComputerActivation ブール型 共有コンピューターのライセンス認証が Office365 アプリ スイートに対して使用されていないかどうかを表す プロパティ。
updateChannel officeUpdateChannel Office365 更新プログラム チャネルを表す プロパティ。 使用可能な値: nonecurrentdeferredfirstReleaseCurrentfirstReleaseDeferredmonthlyEnterprise
officeSuiteAppDefaultFileFormat officeSuiteDefaultFileFormatType Office365 の既定のファイル形式の種類を表す プロパティ。 使用可能な値: notConfiguredofficeOpenXMLFormatofficeOpenDocumentFormatunknownFutureValue
officePlatformArchitecture windowsArchitecture Office365 アプリ スイートバージョンを表す プロパティ。 使用可能な値: nonex86x64armneutralarm64
localesToInstall String collection Office365 のアプリのインストール時にインストールされるロケールを表す プロパティ。 標準 RFC 6033 を使用します。 参照: https://technet.microsoft.com/library/cc179219(v=office.16).aspx|
installProgressDisplayLevel officeSuiteInstallProgressDisplayLevel デバイスのインストール進行状況セットアップ UI の表示レベルを指定します。 可能な値は、nonefull です。
shouldUninstallOlderVersionsOfOffice ブール型 Office365 アプリ スイートがデバイスに展開されている場合に、既存の Office MSI をアンインストールするかどうかを決定するプロパティ。
targetVersion String デバイスに展開したままにする必要がある Office365 アプリ スイートの特定のターゲット バージョンを表す プロパティ。
updateVersion String 特定のターゲット バージョンが Office365 アプリ スイートで使用できる更新プログラムのバージョンを表す プロパティ。
officeConfigurationXml Binary Office ProPlus Apps に指定できる XML 構成ファイルを表す プロパティ。 その他のすべてのプロパティよりも優先されます。 存在する場合、XML 構成ファイルを使用してアプリが作成されます。

応答

成功した場合、このメソッドは応答コードを 201 Created し、応答本文に officeSuiteApp オブジェクトを返します。

要求

以下は、要求の例です。

POST https://graph.microsoft.com/beta/deviceAppManagement/mobileApps
Content-type: application/json
Content-length: 1736

{
  "@odata.type": "#microsoft.graph.officeSuiteApp",
  "displayName": "Display Name value",
  "description": "Description value",
  "publisher": "Publisher value",
  "largeIcon": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "isFeatured": true,
  "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
  "informationUrl": "https://example.com/informationUrl/",
  "owner": "Owner value",
  "developer": "Developer value",
  "notes": "Notes value",
  "uploadState": 11,
  "publishingState": "processing",
  "isAssigned": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "dependentAppCount": 1,
  "supersedingAppCount": 3,
  "supersededAppCount": 2,
  "autoAcceptEula": true,
  "productIds": [
    "o365BusinessRetail"
  ],
  "excludedApps": {
    "@odata.type": "microsoft.graph.excludedApps",
    "access": true,
    "bing": true,
    "excel": true,
    "groove": true,
    "infoPath": true,
    "lync": true,
    "oneDrive": true,
    "oneNote": true,
    "outlook": true,
    "powerPoint": true,
    "publisher": true,
    "sharePointDesigner": true,
    "teams": true,
    "visio": true,
    "word": true
  },
  "useSharedComputerActivation": true,
  "updateChannel": "current",
  "officeSuiteAppDefaultFileFormat": "officeOpenXMLFormat",
  "officePlatformArchitecture": "x86",
  "localesToInstall": [
    "Locales To Install value"
  ],
  "installProgressDisplayLevel": "full",
  "shouldUninstallOlderVersionsOfOffice": true,
  "targetVersion": "Target Version value",
  "updateVersion": "Update Version value",
  "officeConfigurationXml": "b2ZmaWNlQ29uZmlndXJhdGlvblhtbA=="
}

応答

以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。

HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 1908

{
  "@odata.type": "#microsoft.graph.officeSuiteApp",
  "id": "9b263b46-3b46-9b26-463b-269b463b269b",
  "displayName": "Display Name value",
  "description": "Description value",
  "publisher": "Publisher value",
  "largeIcon": {
    "@odata.type": "microsoft.graph.mimeContent",
    "type": "Type value",
    "value": "dmFsdWU="
  },
  "createdDateTime": "2017-01-01T00:02:43.5775965-08:00",
  "lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
  "isFeatured": true,
  "privacyInformationUrl": "https://example.com/privacyInformationUrl/",
  "informationUrl": "https://example.com/informationUrl/",
  "owner": "Owner value",
  "developer": "Developer value",
  "notes": "Notes value",
  "uploadState": 11,
  "publishingState": "processing",
  "isAssigned": true,
  "roleScopeTagIds": [
    "Role Scope Tag Ids value"
  ],
  "dependentAppCount": 1,
  "supersedingAppCount": 3,
  "supersededAppCount": 2,
  "autoAcceptEula": true,
  "productIds": [
    "o365BusinessRetail"
  ],
  "excludedApps": {
    "@odata.type": "microsoft.graph.excludedApps",
    "access": true,
    "bing": true,
    "excel": true,
    "groove": true,
    "infoPath": true,
    "lync": true,
    "oneDrive": true,
    "oneNote": true,
    "outlook": true,
    "powerPoint": true,
    "publisher": true,
    "sharePointDesigner": true,
    "teams": true,
    "visio": true,
    "word": true
  },
  "useSharedComputerActivation": true,
  "updateChannel": "current",
  "officeSuiteAppDefaultFileFormat": "officeOpenXMLFormat",
  "officePlatformArchitecture": "x86",
  "localesToInstall": [
    "Locales To Install value"
  ],
  "installProgressDisplayLevel": "full",
  "shouldUninstallOlderVersionsOfOffice": true,
  "targetVersion": "Target Version value",
  "updateVersion": "Update Version value",
  "officeConfigurationXml": "b2ZmaWNlQ29uZmlndXJhdGlvblhtbA=="
}