macOsVppApp を作成する

[アーティクル]
07/05/2024

名前空間: microsoft.graph

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

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

この 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

要求本文

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

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

プロパティ	型	説明
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	ブール型	アプリが少なくとも 1 つのグループに割り当てられているかどうかを示す値。このプロパティは読み取り専用です。 mobileApp から継承します
roleScopeTagIds	String collection	このモバイルアプリのスコープタグ ID の一覧。 mobileApp から継承します
dependentAppCount	Int32	子アプリに含まれる依存関係の合計数。このプロパティは読み取り専用です。 mobileApp から継承します
supersedingAppCount	Int32	このアプリが直接的または間接的に置き換わるアプリの合計数。このプロパティは読み取り専用です。 mobileApp から継承します
置き換えAppCount	Int32	このアプリが直接または間接的に置き換えられるアプリの合計数。このプロパティは読み取り専用です。 mobileApp から継承します
usedLicenseCount	Int32	使用中の VPP ライセンスの数。
totalLicenseCount	Int32	VPP ライセンスの総数。
releaseDateTime	DateTimeOffset	VPP アプリケーションのリリースの日時。
appStoreUrl	String	ストアの URL。
licensingType	vppLicensingType	サポートされているライセンスの種類。
vppTokenOrganizationName	String	Apple ボリューム購入プログラムのトークンに関連付けられている組織
vppTokenAccountType	vppTokenAccountType	特定の Apple ボリューム購入プログラムのトークンが関連付けられている、ボリューム購入プログラムの種類。可能な値は、`business`、`education` です。可能な値は、`business`、`education` です。
vppTokenAppleId	String	特定の Apple ボリューム購入プログラムのトークンに関連付けられている Apple ID。
bundleId	String	ID 名。
vppTokenId	String	このアプリに関連付けられている VPP トークンの識別子。
revokeLicenseActionResults	macOsVppAppRevokeLicensesActionResult コレクション	このアプリでのライセンスの取り消しアクションの結果。

応答

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

例

要求

以下は、要求の例です。

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

{
  "@odata.type": "#microsoft.graph.macOsVppApp",
  "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,
  "usedLicenseCount": 0,
  "totalLicenseCount": 1,
  "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
  "appStoreUrl": "https://example.com/appStoreUrl/",
  "licensingType": {
    "@odata.type": "microsoft.graph.vppLicensingType",
    "supportUserLicensing": true,
    "supportDeviceLicensing": true,
    "supportsUserLicensing": true,
    "supportsDeviceLicensing": true
  },
  "vppTokenOrganizationName": "Vpp Token Organization Name value",
  "vppTokenAccountType": "education",
  "vppTokenAppleId": "Vpp Token Apple Id value",
  "bundleId": "Bundle Id value",
  "vppTokenId": "Vpp Token Id value",
  "revokeLicenseActionResults": [
    {
      "@odata.type": "microsoft.graph.macOsVppAppRevokeLicensesActionResult",
      "userId": "User Id value",
      "managedDeviceId": "Managed Device Id value",
      "totalLicensesCount": 2,
      "failedLicensesCount": 3,
      "actionFailureReason": "appleFailure",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ]
}

応答

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

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

{
  "@odata.type": "#microsoft.graph.macOsVppApp",
  "id": "10b95265-5265-10b9-6552-b9106552b910",
  "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,
  "usedLicenseCount": 0,
  "totalLicenseCount": 1,
  "releaseDateTime": "2017-01-01T00:01:34.7470482-08:00",
  "appStoreUrl": "https://example.com/appStoreUrl/",
  "licensingType": {
    "@odata.type": "microsoft.graph.vppLicensingType",
    "supportUserLicensing": true,
    "supportDeviceLicensing": true,
    "supportsUserLicensing": true,
    "supportsDeviceLicensing": true
  },
  "vppTokenOrganizationName": "Vpp Token Organization Name value",
  "vppTokenAccountType": "education",
  "vppTokenAppleId": "Vpp Token Apple Id value",
  "bundleId": "Bundle Id value",
  "vppTokenId": "Vpp Token Id value",
  "revokeLicenseActionResults": [
    {
      "@odata.type": "microsoft.graph.macOsVppAppRevokeLicensesActionResult",
      "userId": "User Id value",
      "managedDeviceId": "Managed Device Id value",
      "totalLicensesCount": 2,
      "failedLicensesCount": 3,
      "actionFailureReason": "appleFailure",
      "actionName": "Action Name value",
      "actionState": "pending",
      "startDateTime": "2016-12-31T23:58:46.7156189-08:00",
      "lastUpdatedDateTime": "2017-01-01T00:00:56.8321556-08:00"
    }
  ]
}

次の方法で共有

macOsVppApp を作成する

アクセス許可

HTTP 要求

要求ヘッダー

要求本文

応答

例

要求

応答

フィードバック

その他のリソース