Создание officeSuiteApp
Пространство имен: microsoft.graph
Важно: API Microsoft Graph в версии /beta могут быть изменены; Использование в рабочей среде не поддерживается.
Примечание. API Microsoft Graph для Intune требует наличия активной лицензии Intune для клиента.
Создайте объект officeSuiteApp .
Этот API доступен в следующих национальных облачных развертываниях.
| Глобальная служба | Правительство США L4 | Правительство США L5 (DOD) | Китай управляется 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Разрешения
Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.
| Тип разрешения | Разрешения (в порядке повышения привилегий) |
|---|---|
| Делегированные (рабочая или учебная учетная запись) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
| Делегированные (личная учетная запись Майкрософт) | Не поддерживается. |
| Приложение | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
HTTP-запрос
POST /deviceAppManagement/mobileApps
Заголовки запроса
| Заголовок | Значение |
|---|---|
| Авторизация | Bearer {token}. Обязательно. Дополнительные сведения о проверке подлинности и авторизации. |
| Accept | 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 | Логический | Значение, указывающее, назначено ли приложение хотя бы одной группе. Это свойство доступно только для чтения. Наследуется от mobileApp. |
| roleScopeTagIds | Коллекция строк | Список идентификаторов тегов область для этого мобильного приложения. Наследуется от mobileApp. |
| dependentAppCount | Int32 | Общее количество зависимостей, которые имеет дочернее приложение. Это свойство доступно только для чтения. Наследуется от mobileApp. |
| supersedingAppCount | Int32 | Общее число приложений, которое прямо или косвенно заменяет это приложение. Это свойство доступно только для чтения. Наследуется от mobileApp. |
| supersededAppCount | Int32 | Общее количество приложений, которыми это приложение прямо или косвенно заменено. Это свойство доступно только для чтения. Наследуется от mobileApp. |
| autoAcceptEula | Логический | Значение для автоматического принятия лицензионного соглашения на устройстве конечного пользователя. |
| productIds | Коллекция officeProductId | Идентификаторы продуктов, представляющие номер SKU Office365 Suite. Возможные значения: o365ProPlusRetail, o365BusinessRetail, visioProRetail, projectProRetail. |
| excludedApps | excludedApps; | Свойство, представляющее приложения, исключенные из выбранного идентификатора продукта Office365. |
| useSharedComputerActivation | Логический | Свойство , указывающее, используется ли активация общего компьютера не для набора приложений Office365. |
| updateChannel | officeUpdateChannel | Свойство, представляющее канал обновления Office365. Возможные значения: none, current, deferred, firstReleaseCurrent, firstReleaseDeferred, monthlyEnterprise. |
| officeSuiteAppDefaultFileFormat | officeSuiteDefaultFileFormatType | Свойство, представляющее тип формата файла Office365 по умолчанию. Возможные значения: notConfigured, officeOpenXMLFormat, officeOpenDocumentFormat, unknownFutureValue. |
| officePlatformArchitecture | windowsArchitecture; | Свойство, представляющее версию набора приложений Office365. Возможные значения: none, x86, x64, arm, neutral, arm64. |
| localesToInstall | Коллекция строк | Свойство , представляющее языковые стандарты, устанавливаемые при установке приложений из Office365. Используется стандарт RFC 6033. Ссылка: https://technet.microsoft.com/library/cc179219(v=office.16).aspx| |
| installProgressDisplayLevel | officeSuiteInstallProgressDisplayLevel | Чтобы указать уровень отображения для пользовательского интерфейса установки хода установки на устройстве. Возможные значения: none, full. |
| shouldUninstallOlderVersionsOfOffice | Логический | Свойство, определяющее, следует ли удалять существующий MSI-файл Office, если набор приложений Office365 развернут на устройстве или нет. |
| targetVersion | String | Свойство , представляющее определенную целевую версию набора приложений Office365, которая должна быть развернута на устройствах. |
| updateVersion | String | Свойство , представляющее версию обновления, в которой доступна определенная целевая версия для набора приложений Office365. |
| officeConfigurationXml | В двоичном формате | Свойство, представляющее XML-файл конфигурации, который можно указать для приложений Office профессиональный плюс. Имеет приоритет над всеми остальными свойствами. При наличии 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=="
}
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по