Creación de officeSuiteApp
Espacio de nombres: microsoft.graph
Importante: Las API de Microsoft Graph en la versión /beta están sujetas a cambios; no se admite el uso de producción.
Nota: la API de Microsoft Graph para Intune requiere una licencia activa de Intune para el espacio empresarial.
Cree un nuevo objeto officeSuiteApp .
Esta API está disponible en las siguientes implementaciones nacionales de nube.
| Servicio global | Gobierno de EE. UU. L4 | Us Government L5 (DOD) | China operada por 21Vianet |
|---|---|---|---|
| ✅ | ✅ | ✅ | ✅ |
Permisos
Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.
| Tipo de permiso | Permisos (de menos a más privilegiados) |
|---|---|
| Delegado (cuenta profesional o educativa) | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
| Delegado (cuenta personal de Microsoft) | No admitida. |
| Aplicación | DeviceManagementConfiguration.ReadWrite.All, DeviceManagementApps.ReadWrite.All |
Solicitud HTTP
POST /deviceAppManagement/mobileApps
Encabezados de solicitud
| Encabezado | Valor |
|---|---|
| Authorization | {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización. |
| Aceptar | application/json |
Cuerpo de la solicitud
En el cuerpo de la solicitud, proporcione una representación JSON para el objeto officeSuiteApp.
En la tabla siguiente se muestran las propiedades necesarias al crear officeSuiteApp.
| Propiedad | Tipo | Descripción |
|---|---|---|
| id | Cadena | Clave de la entidad. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| displayName | Cadena | Título de la aplicación importado o proporcionado por el administrador. Heredado de mobileApp. |
| description | Cadena | Descripción de la aplicación. Heredado de mobileApp. |
| publicador | Cadena | Publicador de la aplicación. Heredado de mobileApp. |
| largeIcon | mimeContent | Icono grande que se mostrará en los detalles de la aplicación y se usa para cargar el icono. Heredado de mobileApp. |
| createdDateTime | DateTimeOffset | Fecha y hora de creación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| lastModifiedDateTime | DateTimeOffset | Fecha y hora de la última modificación de la aplicación. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| isFeatured | Booleano | Valor que indica si el administrador ha marcado la aplicación como destacada. Heredado de mobileApp. |
| privacyInformationUrl | Cadena | Dirección URL de la declaración de privacidad. Heredado de mobileApp. |
| informationUrl | Cadena | Dirección URL para obtener más información. Heredado de mobileApp. |
| owner | Cadena | Propietario de la aplicación. Heredado de mobileApp. |
| developer | Cadena | Desarrollador de la aplicación. Heredado de mobileApp. |
| notas | Cadena | Notas de la aplicación. Heredado de mobileApp. |
| uploadState | Int32 | Estado de carga. Los valores posibles son: 0 - Not Ready, 1 - Ready, 2 - Processing. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| publishingState | mobileAppPublishingState | Estado de publicación de la aplicación. La aplicación no puede asignarse a menos que se publique. Esta propiedad es de sólo lectura. Se hereda de mobileApp. Los valores posibles son: notPublished, processing y published. |
| isAssigned | Booleano | Valor que indica si la aplicación está asignada a al menos un grupo. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| roleScopeTagIds | Colección string | Lista de identificadores de etiqueta de ámbito para esta aplicación móvil. Heredado de mobileApp. |
| dependentAppCount | Int32 | Número total de dependencias que tiene la aplicación secundaria. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| supersedingAppCount | Int32 | El número total de aplicaciones que esta aplicación reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| supersededAppCount | Int32 | El número total de aplicaciones por las que esta aplicación se reemplaza directa o indirectamente. Esta propiedad es de sólo lectura. Heredado de mobileApp. |
| autoAcceptEula | Booleano | Valor para aceptar automáticamente el CLUF en el dispositivo del usuario final. |
| productIds | colección officeProductId | Identificadores de producto que representan la SKU de Office365 Suite. Los valores posibles son: o365ProPlusRetail, o365BusinessRetail, visioProRetail y projectProRetail. |
| excludedApps | excludedApps | Propiedad que representa las aplicaciones que se excluyen del identificador de producto de Office365 seleccionado. |
| useSharedComputerActivation | Booleano | La propiedad para representar si la activación del equipo compartido no se usa para el conjunto de aplicaciones de Office365. |
| updateChannel | officeUpdateChannel | Propiedad que representa el canal de actualización de Office365. Los valores posibles son: none, current, deferred, firstReleaseCurrent, firstReleaseDeferred, monthlyEnterprise. |
| officeSuiteAppDefaultFileFormat | officeSuiteDefaultFileFormatType | Propiedad que representa el tipo de formato de archivo predeterminado de Office365. Los valores posibles son: notConfigured, officeOpenXMLFormat, officeOpenDocumentFormat y unknownFutureValue. |
| officePlatformArchitecture | windowsArchitecture | Propiedad que representa la versión del conjunto de aplicaciones de Office365. Los valores posibles son: none, x86, x64, arm, neutral, arm64. |
| localesToInstall | Colección string | Propiedad que representa las configuraciones regionales que se instalan cuando se instalan las aplicaciones de Office365. Usa RFC 6033 estándar. Referencia: https://technet.microsoft.com/library/cc179219(v=office.16).aspx| |
| installProgressDisplayLevel | officeSuiteInstallProgressDisplayLevel | Para especificar el nivel de visualización de la interfaz de usuario de configuración del progreso de la instalación en el dispositivo. Los valores posibles son none y full. |
| shouldUninstallOlderVersionsOfOffice | Booleano | Propiedad para determinar si se va a desinstalar msi de Office existente si se implementa un conjunto de aplicaciones de Office365 en el dispositivo o no. |
| targetVersion | Cadena | Propiedad que representa la versión de destino específica del conjunto de aplicaciones de Office365 que debe permanecer implementada en los dispositivos. |
| updateVersion | Cadena | Propiedad que representa la versión de actualización en la que la versión de destino específica está disponible para el conjunto de aplicaciones de Office365. |
| officeConfigurationXml | Binario | Propiedad que representa el archivo de configuración XML que se puede especificar para Office ProPlus Apps. Tiene prioridad sobre todas las demás propiedades. Cuando esté presente, se usará el archivo de configuración XML para crear la aplicación. |
Respuesta
Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto officeSuiteApp en el cuerpo de la respuesta.
Ejemplo
Solicitud
Aquí tiene un ejemplo de la solicitud.
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=="
}
Respuesta
Aquí tiene un ejemplo de la respuesta. Nota: Es posible que el objeto de respuesta que aparezca aquí esté truncado para abreviar. Todas las propiedades se devolverán desde una llamada real.
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=="
}