Atualização para a versão mais recente da Graph API
Este guia detalha como preparar seu aplicativo para testar diversas versões da Graph API e atualizar para a versão mais recente.
A Ferramenta de atualização de API mostra quais chamadas à API do seu aplicativo podem ser afetadas por alterações nas versões mais recentes da API. Você poderá ver rapidamente as alterações que precisa fazer para realizar a atualização da versão atual para uma versão mais recente.
Saiba como uma mudança afeta seu aplicativo
A Ferramenta de atualização de API mostra uma lista personalizada de alterações que impactam um aplicativo ao atualizar para uma versão de destino especificada. Isso permite que você visualize todas as alterações relevantes que foram feitas entre as versões de origem e destino.
Etapa 1. Na Ferramenta de atualização, selecione seu aplicativo no menu suspenso ou digite o nome dele.
O menu suspenso lista, no máximo, dez aplicativos. Para ver outros, use a barra de pesquisa no menu suspenso.
Etapa 2. Use o menu suspenso à direita para selecionar a versão da qual você gostaria de atualizar e a versão para a qual você gostaria de atualizar.
Leia os resultados
A ferramenta apresenta o número de alterações que precisam ser realizadas para que a atualização do seu aplicativo para a versão selecionada aconteça. Se o aplicativo faz chamadas à API que não serão afetadas por uma versão mais recente, a ferramenta não exibe nenhuma informação.
Os métodos são identificados por cor pela versão que afeta a chamada. Passe o mouse sobre o gráfico de barras para ver quantas alterações existem em cada versão. As datas associadas a cada versão se referem ao momento em que as alterações serão aplicadas a todos os aplicativos.
A tabela mostra o tipo de alteração (descontinuado, novo recurso ou alteração), quais métodos são afetados, o número de chamadas realizadas nos últimos sete dias e o percentual de chamadas à API afetadas por essa alteração específica.
Limitações
- Você precisa ser administrador ou desenvolvedor do aplicativo para visualizá-lo na ferramenta.
- Nenhuma informação será retornada se o aplicativo ainda não enviou, ou enviou pouquíssimas, chamadas à API da versão da qual atualizar.
- Os volumes de chamada exibidos podem estar incorretos. O registro de chamadas à API é feito por amostragem e agregado durante a semana anterior. Ele é comparado com o volume de chamadas para estimar quantas das suas chamadas poderão ser afetadas por determinada alteração da versão.
Nota: nem todas as alterações afetarão cada chamada à API. Use seu bom senso para determinar se seu aplicativo precisa processar uma alteração específica. Teste suas chamadas à API na versão mais recente para garantir que estão funcionando corretamente.
Implementar uma nova versão
Nas opções Configurações > Avançado do Painel de Aplicativos, role até encontrar a seção Atualizar versão de API.
Atualização de desenvolvedores e administradores
Todos os desenvolvedores e administradores de um aplicativo são atualizados para a próxima versão disponível. Com isso, é possível testar alterações com um pequeno subconjunto de usuários reais antes de lançar a nova versão publicamente.
Atualização de todas as chamadas
Todas as chamadas feitas por aplicativo são atualizadas para a próxima versão disponível. A atualização antecipada é útil porque preserva a opção de voltar à versão original no caso de erros ou problemas inesperados.
Saiba mais
- Registro de alterações da Graph API — saiba mais sobre as alterações da versão mais recente.
- Controle de versão — saiba mais sobre controle de versão, solicitações de versões diferentes da Graph API e muito mais.
- Aplicativos de teste — aprenda a criar aplicativos de teste para testar alterações no seu aplicativo antes da publicação oficial.
- Usuários de teste — aprenda a criar usuários de teste para testar alterações no seu aplicativo antes da publicação oficial.