Migrar do Live SDK para o Microsoft Graph
Se você estiver usando as APIs do Live SDK ou Live Connect para se conectar ao perfil, calendário, contatos ou arquivos, seu aplicativo precisará ser atualizado para manter a funcionalidade.
As APIs do Live SDK e Live Connect foram marcadas como preteridas por mais de um ano. Como anunciado no Blog do Desenvolvedor do Office, essas APIs estão chegando ao fim da vida útil e não estarão mais disponíveis após 1 de novembro de 2018.
Os dados de perfil e contatos não estarão mais disponíveis das APIs do Live Connect a partir de 1 de dezembro de 2017. Os dados do calendário não estão mais disponíveis no Live Connect desde junho de 2017.
As APIs do Live Connect são todas hospedadas do https://apis.live.net/v5.0. Este prefixo deve ser considerado em todos os exemplos abaixo.
Mudar para o Microsoft Graph
A funcionalidade disponível anteriormente pelas APIs do Live SDK e Live Connect agora estão disponíveis via Microsoft Graph. Para continuarem a integrar-se nos serviços Microsoft, os programadores têm de atualizar as suas aplicações para utilizarem o Microsoft Graph antes da linha do tempo para estes serviços serem descontinuados.
Da mesma forma que os recursos do Live Connect, o Microsoft Graph tem uma série de recursos disponíveis, dependendo do tipo de dados de usuário com os quais seu aplicativo interage:
- Autenticação de conta da Microsoft
- Arquivos do OneDrive
- Calendário do Outlook
- Mensagens do Outlook
- Contatos pessoais
- API do perfil e identidade
Bibliotecas
O Microsoft Graph oferece bibliotecas de clientes para muitas plataformas que podem integrar-se ao seu aplicativo de forma similar ao Live SDK.
Permissões
O Microsoft Graph utiliza um conjunto diferente de âmbitos de permissão do que Live Connect. Para aceder às APIs do Microsoft Graph, a sua aplicação terá de mudar os âmbitos de permissão. Isto requer que a sua aplicação peça ao utilizador o consentimento para iniciar sessão e consentir as novas permissões.
Veja a referência de permissão do Microsoft Graph para obter os detalhes completos.
| Âmbito do Live Connect | Permissões do Microsoft Graph | Descrição |
|---|---|---|
wl.basic |
Contacts.Read |
Permite ao aplicativo ler os contatos do usuário. |
wl.offline_access |
offline_access |
Permite ao aplicativo ler e atualizar dados do usuário, mesmo quando eles não estiver usando o aplicativo. |
wl.signin |
openid |
Permite aos usuários entrar no aplicativo com contas corporativas ou de estudante e permite ao aplicativo ver informações básicas do perfil do usuário. |
wl.skydrive |
Files.Read |
Permite que o aplicativo leia todos os arquivos do usuário conectado. |
wl.skydrive_update |
Files.ReadWrite |
Permite que o aplicativo leia, crie, atualize e exclua os arquivos do usuário conectado. |
wl.contacts_create |
Contacts.ReadWrite |
Permite ao aplicativo criar, ler, atualizar e excluir contatos do usuário. |
wl.contacts_calendar |
Calendars.Read.Shared |
Permite que o aplicativo leia os contatos que o usuário tem permissão de acessar, incluindo os próprios contatos do usuário e os contatos compartilhados. |
wl.contacts_photos |
Contacts.Read |
Permite ao aplicativo ler os contatos do usuário. |
wl.contacts_skydrive |
Files.ReadWrite.All |
Permite que o aplicativo leia, crie, atualize e exclua todos os arquivos que o usuário conectado pode acessar. |
wl.calendars |
Calendars.Read |
Permite ao aplicativo ler eventos nos calendários do usuário. |
wl.calendars_update |
Calendars.ReadWrite |
Permite ao aplicativo criar, ler, atualizar e excluir eventos em calendários do usuário. |
wl.emails |
Mail.Read |
Permite ao aplicativo ler emails em caixas de correio do usuário. |
wl.events_create |
Calendars.ReadWrite |
Permite ao aplicativo criar, ler, atualizar e excluir eventos em calendários do usuário. |
wl.photos |
Files.Read |
Permite que a aplicação leia os ficheiros do utilizador com sessão iniciada, incluindo fotografias. |
office.onenote_create |
Notes.ReadWrite |
Permite ao aplicativo ler, compartilhar e modificar blocos de anotações do OneNote em nome do usuário conectado. |
Identificadores Exclusivos
O Microsoft Graph utiliza um esquema diferente para identificadores exclusivos do que Live Connect ou Live SDK. Não pode utilizar os identificadores de Live Connect com o Microsoft Graph.
A sua aplicação terá de redescobrir os identificadores de itens conhecidos através da pesquisa, da navegação baseada no caminho ou de pedir ao utilizador para selecionar os itens novamente.
API de Identidade
A funcionalidade da API de identidade deixará de devolver dados de utilizador a 1 de dezembro de 2017.
A tabela seguinte descreve os métodos na API Live Connect e o método equivelento no Microsoft Graph. Embora o formato do caminho REST possa ser semelhante, os dados de resposta não seguem o mesmo formato. Terá de utilizar o SDK do Microsoft Graph ou atualizar o mapeamento JSON para utilizar o formato de recurso do Microsoft Graph.
| API de Live Connect | API do Microsoft Graph | Notas |
|---|---|---|
GET /me |
GET /me |
Experimente. Devolve o perfil do utilizador, o nome a apresentar e informações adicionais. |
GET /me/picture |
GET /me/photo/$value |
Experimente. Devolve o foto de perfil do utilizador. |
API de Contatos
A funcionalidade da API de contactos deixará de devolver dados de utilizador a 1 de dezembro de 2017.
A tabela seguinte descreve os métodos na API Live Connect e o método equivelento no Microsoft Graph. Embora o formato do caminho REST possa ser semelhante, os dados de resposta não seguem o mesmo formato. Terá de utilizar o SDK do Microsoft Graph ou atualizar o mapeamento JSON para utilizar o formato de recurso do Microsoft Graph.
| API de Live Connect | API do Microsoft Graph | Notas |
|---|---|---|
GET /me/contacts |
GET /me/contacts |
Experimente. Devolve uma lista dos contactos pessoais do utilizador. |
GET /{contact-id} |
GET /me/contacts/{contact-id} |
Experimente. Devolve os dados de um contacto especificado. |
POST /{contact-id} |
POST /me/contacts |
Crie um novo contacto. |
API de Calendário
A API de calendário já não devolve dados de utilizador a partir de junho de 2017.
A tabela seguinte descreve os métodos na API Live Connect e o método equivelento no Microsoft Graph. Embora o formato do caminho REST possa ser semelhante, os dados de resposta não seguem o mesmo formato. Terá de utilizar o SDK do Microsoft Graph ou atualizar o mapeamento JSON para utilizar o formato de recurso do Microsoft Graph.
| API de Live Connect | API do Microsoft Graph | Notas |
|---|---|---|
GET /me/calendars |
GET /me/calendars |
Experimente Devolve uma lista dos calendários do utilizador. |
GET /{calendar-id} |
GET /me/events |
Experimente Devolver eventos dos calendários do utilizador. |
POST /{calendar-id} |
POST /me/events |
Crie um novo evento no calendário do utilizador. |
OneDrive REST API
A parte do OneDrive da API Live Connect deixará de estar funcional a partir de 1 de novembro de 2018.
As tabelas seguintes descrevem os métodos na API Live Connect e os métodos equivelentos no Microsoft Graph.
Embora o formato do caminho REST possa ser semelhante, os dados de resposta não seguem o mesmo formato. Terá de utilizar o SDK do Microsoft Graph ou atualizar o mapeamento JSON para utilizar o formato de recurso do Microsoft Graph.
Para obter os detalhes completos sobre como navegar nos conteúdos do OneDrive de um utilizador, consulte Obter um recurso DriveItem.
| API de Live Connect | API do Microsoft Graph | Notas |
|---|---|---|
GET /folder.a6b2a7e8f2515e5e.A6B2A7E8F2515E5E!110 |
GET /me/drive/items/A6B2A7E8F2515E5E!110 |
Experimente. Obtenha os metadados de uma pasta. |
GET /me/skydrive/camera_roll |
GET /me/drive/special/cameraroll |
Obtenha a pasta de cópia de segurança de imagens da câmara do utilizador. |
GET /me/skydrive/files |
GET /me/drive/root/children |
Experimente. Liste os conteúdos da pasta raiz do OneDrive. |
GET /me/skydrive/my_documents |
GET /me/drive/special/documents |
Obtenha a pasta de documentos do utilizador. |
GET /me/skydrive/my_photos |
GET /me/drive/special/photos |
Obtenha a pasta fotografias do utilizador. |
GET /me/skydrive/public_documents |
n/d | Obtenha a pasta partilhada pública do utilizador. Este conceito foi removido do OneDrive e não está disponível no Microsoft Graph. |
GET /me/skydrive/quota |
GET /me/drive?$select=quota |
Experimente. Devolve informações de quota para o OneDrive de um utilizador, incluindo espaço utilizado e espaço restante. |
GET /me/skydrive/recent |
GET /me/drive/recent |
Devolver uma lista de ficheiros e pastas partilhados com o utilizador atual. |
GET /me/skydrive/shared |
GET /me/drive/sharedWithMe |
Devolver uma lista de ficheiros e pastas partilhados com o utilizador atual. |
GET /me/skydrive |
GET /me/drive/root |
Experimente. Obtenha a pasta raiz no OneDrive do utilizador. |
GET /skydrive/get_item_preview |
GET /me/drive/items/{item-id}/thumbnails |
Devolve as miniaturas disponíveis para um ficheiro ou pasta no OneDrive. |
Seletor de Ficheiros para aplicações Web
A funcionalidade do seletor de ficheiros do OneDrive fornecida como parte do Live SDK está agora disponível através do seletor de ficheiros do OneDrive.
A versão 5 do Live SDK (selecionador de ficheiros do OneDrive) deixará de estar funcional após 1 de novembro de 2018.
Recursos adicionais
Para obter mais informações sobre como utilizar o Microsoft Graph, experimente o Guia de Introdução do Microsoft Graph.