eBookInstallSummary の更新
[アーティクル]
12/04/2023
11 人の共同作成者
フィードバック
この記事の内容
名前空間: microsoft.graph
注: Intune 用 Microsoft Graph API には、テナントの有効な Intune ライセンス が必要です。
eBookInstallSummary オブジェクトのプロパティを更新します。
この API は、次の国内クラウド展開 で使用できます。
グローバル サービス
米国政府機関 L4
米国政府機関 L5 (DOD)
21Vianet が運営する中国
✅
✅
✅
✅
アクセス許可
この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可 」を参照してください。
アクセス許可の種類
アクセス許可 (特権の小さいものから大きいものへ)
委任 (職場または学校のアカウント)
DeviceManagementApps.ReadWrite.All
委任 (個人用 Microsoft アカウント)
サポートされていません。
アプリケーション
DeviceManagementApps.ReadWrite.All
HTTP 要求
PATCH /deviceAppManagement/managedEBooks/{managedEBookId}/installSummary
ヘッダー
値
Authorization
ベアラー {token}。 必須です。 認証と承認 の詳細については、こちらをご覧ください。
承諾
application/json
要求本文
要求本文で、eBookInstallSummary オブジェクトの JSON 表記を指定します。
次の表に、eBookInstallSummary の作成時に必要なプロパティを示します。
プロパティ
型
説明
id
String
エンティティのキー。
installedDeviceCount
Int32
このブックが正常にインストールされたデバイスの数。
failedDeviceCount
Int32
このブックのインストールが失敗したデバイスの数。
notInstalledDeviceCount
Int32
このブックがインストールされていないデバイスの数。
installedUserCount
Int32
このブックがすべて正常にインストールされたデバイスを所有しているユーザーの数。
failedUserCount
Int32
このブックのインストールが失敗したデバイスを 1 台以上所有しているユーザーの数。
notInstalledUserCount
Int32
このブックをインストールしていないユーザーの数。
応答
成功した場合、このメソッドは 200 OK
応答コードと、更新された eBookInstallSummary オブジェクトを応答本文で返します。
例
要求
以下は、要求の例です。
PATCH https://graph.microsoft.com/v1.0/deviceAppManagement/managedEBooks/{managedEBookId}/installSummary
Content-type: application/json
Content-length: 236
{
"@odata.type": "#microsoft.graph.eBookInstallSummary",
"installedDeviceCount": 4,
"failedDeviceCount": 1,
"notInstalledDeviceCount": 7,
"installedUserCount": 2,
"failedUserCount": 15,
"notInstalledUserCount": 5
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new EBookInstallSummary
{
OdataType = "#microsoft.graph.eBookInstallSummary",
InstalledDeviceCount = 4,
FailedDeviceCount = 1,
NotInstalledDeviceCount = 7,
InstalledUserCount = 2,
FailedUserCount = 15,
NotInstalledUserCount = 5,
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceAppManagement.ManagedEBooks["{managedEBook-id}"].InstallSummary.PatchAsync(requestBody);
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc device-app-management managed-ebooks install-summary patch --managed-ebook-id {managedEBook-id} --body '{\
"@odata.type": "#microsoft.graph.eBookInstallSummary",\
"installedDeviceCount": 4,\
"failedDeviceCount": 1,\
"notInstalledDeviceCount": 7,\
"installedUserCount": 2,\
"failedUserCount": 15,\
"notInstalledUserCount": 5\
}\
'
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
import (
"context"
msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
graphmodels "github.com/microsoftgraph/msgraph-sdk-go/models"
//other-imports
)
graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)
requestBody := graphmodels.NewEBookInstallSummary()
installedDeviceCount := int32(4)
requestBody.SetInstalledDeviceCount(&installedDeviceCount)
failedDeviceCount := int32(1)
requestBody.SetFailedDeviceCount(&failedDeviceCount)
notInstalledDeviceCount := int32(7)
requestBody.SetNotInstalledDeviceCount(¬InstalledDeviceCount)
installedUserCount := int32(2)
requestBody.SetInstalledUserCount(&installedUserCount)
failedUserCount := int32(15)
requestBody.SetFailedUserCount(&failedUserCount)
notInstalledUserCount := int32(5)
requestBody.SetNotInstalledUserCount(¬InstalledUserCount)
installSummary, err := graphClient.DeviceAppManagement().ManagedEBooks().ByManagedEBookId("managedEBook-id").InstallSummary().Patch(context.Background(), requestBody, nil)
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
EBookInstallSummary eBookInstallSummary = new EBookInstallSummary();
eBookInstallSummary.setOdataType("#microsoft.graph.eBookInstallSummary");
eBookInstallSummary.setInstalledDeviceCount(4);
eBookInstallSummary.setFailedDeviceCount(1);
eBookInstallSummary.setNotInstalledDeviceCount(7);
eBookInstallSummary.setInstalledUserCount(2);
eBookInstallSummary.setFailedUserCount(15);
eBookInstallSummary.setNotInstalledUserCount(5);
EBookInstallSummary result = graphClient.deviceAppManagement().managedEBooks().byManagedEBookId("{managedEBook-id}").installSummary().patch(eBookInstallSummary);
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
const options = {
authProvider,
};
const client = Client.init(options);
const eBookInstallSummary = {
'@odata.type': '#microsoft.graph.eBookInstallSummary',
installedDeviceCount: 4,
failedDeviceCount: 1,
notInstalledDeviceCount: 7,
installedUserCount: 2,
failedUserCount: 15,
notInstalledUserCount: 5
};
await client.api('/deviceAppManagement/managedEBooks/{managedEBookId}/installSummary')
.update(eBookInstallSummary);
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\EBookInstallSummary;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new EBookInstallSummary();
$requestBody->setOdataType('#microsoft.graph.eBookInstallSummary');
$requestBody->setInstalledDeviceCount(4);
$requestBody->setFailedDeviceCount(1);
$requestBody->setNotInstalledDeviceCount(7);
$requestBody->setInstalledUserCount(2);
$requestBody->setFailedUserCount(15);
$requestBody->setNotInstalledUserCount(5);
$result = $graphServiceClient->deviceAppManagement()->managedEBooks()->byManagedEBookId('managedEBook-id')->installSummary()->patch($requestBody)->wait();
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
Import-Module Microsoft.Graph.Devices.CorporateManagement
$params = @{
"@odata.type" = "#microsoft.graph.eBookInstallSummary"
installedDeviceCount = 4
failedDeviceCount = 1
notInstalledDeviceCount = 7
installedUserCount = 2
failedUserCount = 15
notInstalledUserCount = 5
}
Update-MgDeviceAppManagementManagedEBookInstallSummary -ManagedEBookId $managedEBookId -BodyParameter $params
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
from msgraph import GraphServiceClient
from msgraph.generated.models.e_book_install_summary import EBookInstallSummary
graph_client = GraphServiceClient(credentials, scopes)
request_body = EBookInstallSummary(
odata_type = "#microsoft.graph.eBookInstallSummary",
installed_device_count = 4,
failed_device_count = 1,
not_installed_device_count = 7,
installed_user_count = 2,
failed_user_count = 15,
not_installed_user_count = 5,
)
result = await graph_client.device_app_management.managed_e_books.by_managed_e_book_id('managedEBook-id').install_summary.patch(request_body)
プロジェクトに SDK を追加 し、authProvider インスタンスを作成 する方法の詳細については、SDK のドキュメント を参照してください。
応答
以下は、応答の例です。 注: 簡潔にするために、ここに示す応答オブジェクトは切り詰められている場合があります。 実際の呼び出しではすべてのプロパティが返されます。
HTTP/1.1 200 OK
Content-Type: application/json
Content-Length: 285
{
"@odata.type": "#microsoft.graph.eBookInstallSummary",
"id": "9708ad78-ad78-9708-78ad-089778ad0897",
"installedDeviceCount": 4,
"failedDeviceCount": 1,
"notInstalledDeviceCount": 7,
"installedUserCount": 2,
"failedUserCount": 15,
"notInstalledUserCount": 5
}