Actualización a la versión más reciente de la API Graph
En esta guía se describe cómo preparar una aplicación a fin de probar diferentes versiones de la API Graph y actualizarla a la versión más reciente.
En la herramienta de actualización de la API se muestran las llamadas a la API de la aplicación que se pueden ver afectadas por los cambios de las versiones más recientes de la API. Podrás consultar rápidamente qué cambios debes realizar para actualizar la versión actual a otra más reciente.
Información sobre cómo afecta un cambio a la aplicación
En la herramienta de actualización de la API se muestra una lista personalizada de cambios que afectan a una aplicación al actualizarla a una versión de destino concreta. De esta forma, se pueden consultar todos los cambios pertinentes entre las versiones de origen y destino.
Paso 1. En la herramienta de actualización, selecciona tu aplicación en el menú desplegable o escribe su nombre.
En el menú desplegable solo se muestran un máximo de diez aplicaciones. Para ver más aplicaciones, además de las que aparecen en la lista, usa la barra de búsqueda en el menú desplegable.
Paso 2. Usa los menús desplegables de la derecha para seleccionar la versión de origen y destino de la actualización en los campos Actualizar a partir de y Actualizar a.
Leer los resultados
En la herramienta se muestra el número de cambios necesarios para actualizar la aplicación a la versión seleccionada. Si la aplicación realiza llamadas a la API que no se verán afectadas por una versión más reciente, no se devolverán datos.
Los métodos se codifican por colores en función de la versión que afecta a la llamada. Pasa el cursor sobre el gráfico de barras para consultar el número de cambios de cada versión. Las fechas asociadas con cada versión indican la fecha de implementación de los cambios para todas las aplicaciones.
En la tabla se muestran el tipo de cambio (retirada, función nueva o cambio), los métodos que se ven afectados, el número de llamadas realizadas en los últimos siete días y el porcentaje de llamadas a la API a las que ha afectado este cambio concreto.
Limitaciones
- Debes ser administrador o desarrollador de la aplicación para poder verla en la herramienta.
- No se devolverán datos si la aplicación realizó muy pocas llamadas a la API o no realizó ninguna desde la versión de origen de la actualización.
- Los volúmenes de llamadas pueden parecer incorrectos. Las muestras del registro de llamadas a la API se toman y se recopilan para la semana anterior. Después, se compara el registro con el volumen de llamadas para calcular a cuántas de ellas afecta un cambio de versión determinado.
Nota: Puede que no todos los cambios afecten a todas las llamadas a la API. Considera si tu aplicación debe gestionar un cambio determinado. Asegúrate de probar las llamadas a la API en la versión más reciente para comprobar que funcionan correctamente.
Implementar una nueva versión
En el panel de aplicaciones, selecciona Configuración > Opciones avanzadas y desplázate hasta la sección Actualizar la versión de la API.
Actualización de desarrolladores y administradores
Se actualizan todos los desarrolladores y administradores de una aplicación a la siguiente versión disponible. De esta forma, puedes probar los cambios con un subconjunto reducido de usuarios reales antes de lanzar la nueva versión al público.
Actualización de todas las llamadas
Se actualizan todas las llamadas que hace una aplicación a la siguiente versión disponible. La actualización anticipada resulta útil porque conserva la opción de volver a la versión original en caso de errores o problemas imprevistos.
Más información
- Registro de cambios de la API Graph: obtén información sobre los cambios de versión más recientes.
- Control de versiones: obtén toda la información necesaria sobre el control de versiones de la API Graph, las solicitudes a diferentes versiones y mucho más.
- Aplicaciones de prueba: obtén información sobre cómo crear aplicaciones de prueba para probar los cambios de la aplicación antes del lanzamiento público.
- Usuarios de prueba: obtén información sobre cómo crear usuarios de prueba para probar los cambios de la aplicación antes del lanzamiento público.