Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
Тип разрешения
Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)
Тип программы оптовых покупок, с которой связан заданный токен Apple Volume Purchase Program. Возможные значения: business, education. Возможные значения: business, education.
appleId
Строка
Идентификатор Apple ID, связанный с заданным токеном Apple Volume Purchase Program.
expirationDateTime
DateTimeOffset
Дата и время завершения срока действия токена Apple Volume Purchase Program.
lastSyncDateTime
DateTimeOffset
Последнее выполнение синхронизации приложения при помощи службы Apple Volume Purchase Program с использованием токена Apple Volume Purchase Program.
токен
Строка
Строка токена Apple Volume Purchase Program; загрузка выполнена из Apple Volume Purchase Program.
lastModifiedDateTime
DateTimeOffset
Дата и время последнего изменения, связанного с токеном Apple Volume Purchase Program.
Текущее состояние последней синхронизации приложения, инициированной с помощью токена Apple Volume Purchase Program. Возможные значения: none, inProgress, completed, failed. Возможные значения: none, inProgress, completed, failed.
automaticallyUpdateApps
Логическое
Автоматически обновятся все приложения, не только для токена VPP.
countryOrRegion
Строка
Автоматически обновятся все приложения, не только для токена VPP.
Ответ
В случае успешного выполнения данный метод возвращает201 Created код отклика и объект vppToken в форме для обратной связи.
POST https://graph.microsoft.com/v1.0/deviceAppManagement/vppTokens
Content-type: application/json
Content-length: 461
{
"@odata.type": "#microsoft.graph.vppToken",
"organizationName": "Organization Name value",
"vppTokenAccountType": "education",
"appleId": "Apple Id value",
"expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"token": "Token value",
"state": "valid",
"lastSyncStatus": "inProgress",
"automaticallyUpdateApps": true,
"countryOrRegion": "Country Or Region value"
}
// Code snippets are only available for the latest version. Current version is 5.x
// Dependencies
using Microsoft.Graph.Models;
var requestBody = new VppToken
{
OdataType = "#microsoft.graph.vppToken",
OrganizationName = "Organization Name value",
VppTokenAccountType = VppTokenAccountType.Education,
AppleId = "Apple Id value",
ExpirationDateTime = DateTimeOffset.Parse("2016-12-31T23:57:57.2481234-08:00"),
LastSyncDateTime = DateTimeOffset.Parse("2017-01-01T00:02:49.3205976-08:00"),
Token = "Token value",
State = VppTokenState.Valid,
LastSyncStatus = VppTokenSyncStatus.InProgress,
AutomaticallyUpdateApps = true,
CountryOrRegion = "Country Or Region value",
};
// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.DeviceAppManagement.VppTokens.PostAsync(requestBody);
// Code snippets are only available for the latest version. Current version is 6.x
GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);
VppToken vppToken = new VppToken();
vppToken.setOdataType("#microsoft.graph.vppToken");
vppToken.setOrganizationName("Organization Name value");
vppToken.setVppTokenAccountType(VppTokenAccountType.Education);
vppToken.setAppleId("Apple Id value");
OffsetDateTime expirationDateTime = OffsetDateTime.parse("2016-12-31T23:57:57.2481234-08:00");
vppToken.setExpirationDateTime(expirationDateTime);
OffsetDateTime lastSyncDateTime = OffsetDateTime.parse("2017-01-01T00:02:49.3205976-08:00");
vppToken.setLastSyncDateTime(lastSyncDateTime);
vppToken.setToken("Token value");
vppToken.setState(VppTokenState.Valid);
vppToken.setLastSyncStatus(VppTokenSyncStatus.InProgress);
vppToken.setAutomaticallyUpdateApps(true);
vppToken.setCountryOrRegion("Country Or Region value");
VppToken result = graphClient.deviceAppManagement().vppTokens().post(vppToken);
<?php
use Microsoft\Graph\GraphServiceClient;
use Microsoft\Graph\Generated\Models\VppToken;
use Microsoft\Graph\Generated\Models\VppTokenAccountType;
use Microsoft\Graph\Generated\Models\VppTokenState;
use Microsoft\Graph\Generated\Models\VppTokenSyncStatus;
$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);
$requestBody = new VppToken();
$requestBody->setOdataType('#microsoft.graph.vppToken');
$requestBody->setOrganizationName('Organization Name value');
$requestBody->setVppTokenAccountType(new VppTokenAccountType('education'));
$requestBody->setAppleId('Apple Id value');
$requestBody->setExpirationDateTime(new \DateTime('2016-12-31T23:57:57.2481234-08:00'));
$requestBody->setLastSyncDateTime(new \DateTime('2017-01-01T00:02:49.3205976-08:00'));
$requestBody->setToken('Token value');
$requestBody->setState(new VppTokenState('valid'));
$requestBody->setLastSyncStatus(new VppTokenSyncStatus('inProgress'));
$requestBody->setAutomaticallyUpdateApps(true);
$requestBody->setCountryOrRegion('Country Or Region value');
$result = $graphServiceClient->deviceAppManagement()->vppTokens()->post($requestBody)->wait();
# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
from msgraph.generated.models.vpp_token import VppToken
from msgraph.generated.models.vpp_token_account_type import VppTokenAccountType
from msgraph.generated.models.vpp_token_state import VppTokenState
from msgraph.generated.models.vpp_token_sync_status import VppTokenSyncStatus
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
request_body = VppToken(
odata_type = "#microsoft.graph.vppToken",
organization_name = "Organization Name value",
vpp_token_account_type = VppTokenAccountType.Education,
apple_id = "Apple Id value",
expiration_date_time = "2016-12-31T23:57:57.2481234-08:00",
last_sync_date_time = "2017-01-01T00:02:49.3205976-08:00",
token = "Token value",
state = VppTokenState.Valid,
last_sync_status = VppTokenSyncStatus.InProgress,
automatically_update_apps = True,
country_or_region = "Country Or Region value",
)
result = await graph_client.device_app_management.vpp_tokens.post(request_body)
Ниже приведен пример отклика. Примечание. Представленный здесь объект отклика может быть усечен для краткости. При фактическом вызове будут возвращены все свойства.
HTTP/1.1 201 Created
Content-Type: application/json
Content-Length: 574
{
"@odata.type": "#microsoft.graph.vppToken",
"id": "9ceb2f92-2f92-9ceb-922f-eb9c922feb9c",
"organizationName": "Organization Name value",
"vppTokenAccountType": "education",
"appleId": "Apple Id value",
"expirationDateTime": "2016-12-31T23:57:57.2481234-08:00",
"lastSyncDateTime": "2017-01-01T00:02:49.3205976-08:00",
"token": "Token value",
"lastModifiedDateTime": "2017-01-01T00:00:35.1329464-08:00",
"state": "valid",
"lastSyncStatus": "inProgress",
"automaticallyUpdateApps": true,
"countryOrRegion": "Country Or Region value"
}