officeSuiteApp の更新

[アーティクル]
09/13/2021

名前空間: microsoft.graph

重要: Microsoft Graph /beta バージョンの API は変更される場合があります。実稼働での使用はサポートされていません。

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

前提条件

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

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

HTTP 要求

PATCH /deviceAppManagement/mobileApps/{mobileAppId}
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/userStatuses/{userAppInstallStatusId}/app
PATCH /deviceAppManagement/mobileApps/{mobileAppId}/deviceStatuses/{mobileAppInstallStatusId}/app

要求ヘッダー

ヘッダー	値
Authorization	ベアラー <トークン> が必要です。
承諾	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 から継承されます。可能な値は、`notPublished`、`processing`、`published` です。
isAssigned	Boolean	アプリが少なくとも 1 つのグループに割り当てられているかどうかを示す値。 mobileApp から継承します
roleScopeTagIds	String collection	このモバイルアプリのスコープタグ ID の一覧。 mobileApp から継承します
dependentAppCount	Int32	子アプリが持つ依存関係の総数。 mobileApp から継承します
supersedingAppCount	Int32	このアプリが直接または間接的に取って代用されるアプリの総数。 mobileApp から継承します
supersededAppCount	Int32	このアプリが直接または間接的に取って代用されるアプリの総数。 mobileApp から継承します
autoAcceptEula	Boolean	エンドユーザーのデバイスで EULA を自動的に受け入れる値。
productIds	officeProductId コレクション	Office365 スイート SKU を表す製品 ID。使用可能な値: `o365ProPlusRetail`、`o365BusinessRetail`、`visioProRetail`、`projectProRetail`。
excludedApps	excludedApps	選択した Office365 製品 ID から除外されるアプリを表すプロパティ。
useSharedComputerActivation	Boolean	共有コンピューターのライセンス認証が Office365 アプリスイートに使用されていないかどうかを表すプロパティ。
updateChannel	officeUpdateChannel	Office365 更新チャネルを表すプロパティ。使用可能な値: `none`、`current`、`deferred`、`firstReleaseCurrent`、`firstReleaseDeferred`、`monthlyEnterprise`。
officePlatformArchitecture	windowsArchitecture	Office365 アプリスイートのバージョンを表すプロパティ。使用可能な値: `none`、`x86`、`x64`、`arm`、`neutral`、`arm64`。
localesToInstall	String collection	Office365 のアプリがインストールされている場合にインストールされる場所を表すプロパティ。標準の RFC 6033 を使用します。 Ref: https://technet.microsoft.com/library/cc179219(v=office.16).aspx\|
installProgressDisplayLevel	officeSuiteInstallProgressDisplayLevel	デバイスのインストールの進行状況のセットアップ UI の表示レベルを指定します。可能な値は、`none`、`full` です。
shouldUninstallOlderVersionsOfOffice	Boolean	Office365 アプリスイートがデバイスに展開Office既存のアプリケーションをアンインストールするかどうかを決定するプロパティ。
targetVersion	String	デバイスに展開する必要がある Office365 アプリスイートの特定のターゲットバージョンを表すプロパティ。
updateVersion	String	Office365 アプリスイートで特定のターゲットバージョンを使用できる更新プログラムのバージョンを表すプロパティ。
officeConfigurationXml	Binary	ProPlus Apps で指定できる XML 構成ファイルを表Officeプロパティです。他のすべてのプロパティよりも優先されます。存在する場合は、XML 構成ファイルを使用してアプリを作成します。

応答

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

例

要求

以下は、要求の例です。

PATCH https://graph.microsoft.com/beta/deviceAppManagement/mobileApps/{mobileAppId}
Content-type: application/json
Content-length: 1675

{
  "@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",
  "officePlatformArchitecture": "x86",
  "localesToInstall": [
    "Locales To Install value"
  ],
  "installProgressDisplayLevel": "full",
  "shouldUninstallOlderVersionsOfOffice": true,
  "targetVersion": "Target Version value",
  "updateVersion": "Update Version value",
  "officeConfigurationXml": "b2ZmaWNlQ29uZmlndXJhdGlvblhtbA=="
}

応答

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

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

{
  "@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",
  "officePlatformArchitecture": "x86",
  "localesToInstall": [
    "Locales To Install value"
  ],
  "installProgressDisplayLevel": "full",
  "shouldUninstallOlderVersionsOfOffice": true,
  "targetVersion": "Target Version value",
  "updateVersion": "Update Version value",
  "officeConfigurationXml": "b2ZmaWNlQ29uZmlndXJhdGlvblhtbA=="
}

officeSuiteApp の更新

前提条件

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック