Actualización a la última versión de la API Graph

Esta guía describe cómo preparar tu app para probar las diferentes versiones de la API Graph y actualizarla a la última versión.

La herramienta de actualización de la API muestra las llamadas a la API de tu app que pueden verse afectadas por los cambios en las últimas versiones de la API. Podrás consultar rápidamente qué cambios debes realizar para actualizar tu versión actual a otra más reciente.

Obtén información sobre cómo se ve afectada tu app por los cambios

La herramienta de actualización de la API muestra una lista personalizada de los cambios que afectan a una app cuando se actualiza a una versión de destino específica. Esto te permite ver todos los cambios relevantes entre las versiones de origen y de destino.

Paso 1: En la herramienta de actualización, selecciona tu app del menú desplegable o el tipo o escribe el nombre de la app.

El menú desplegable muestra como máximo diez apps. Para ver más apps, usa la barra de búsqueda del menú desplegable.

Paso 2: Usa los menús desplegables de la derecha para seleccionar la versión desde la cual quieres actualizar y la versión a la que quieres actualizar.

Leer los resultados

La herramienta presenta el número de cambios que se deben hacer para actualizar tu app a la versión seleccionada. No se devolverá ningún dato, si tu app hace llamadas a la API que no se verán afectadas por una versión posterior.

Los métodos aparecen en un código de color según la versión que afecta la llamada. Pasa el mouse por encima del gráfico de barras para ver cuántos cambios hay en cada versión. Las fechas relacionadas con cada versión indican cuándo se aplicarán los cambios para todas las apps.

La tabla muestra el tipo de cambio (obsolescencia, función nueva o cambio), qué métodos se ven afectados, el número de llamadas realizadas en los últimos siete días y el porcentaje de llamadas a la API al cual afecta ese cambio en particular.

Limitaciones

  • Debes ser administrador o desarrollador de la app para verla en la herramienta.
  • No se devolverá ningún dato si la app no hizo llamadas a la API desde la versión a partir de la cual quieres actualizar o hizo muy pocas.
  • Es posible que los volúmenes de llamadas aparezcan de manera incorrecta. El registro de llamadas a la API se muestrea y recopila durante la semana anterior. Se compara con el volumen de llamadas para calcular cuántas de ellas se podrían ver afectadas por un determinado cambio en la versión.

Nota: Es posible que no todos los cambios afecten a cada llamada a la API. Usa tu criterio para saber si tu app debe manejar un cambio en particular. Asegúrate de probar tus llamadas a la API en la versión más reciente para asegurarte de que todo funcione adecuadamente.

Implementar una nueva versión

Desplázate a la sección Actualizar la versión de la API en Configuración > Opciones avanzadas del panel de apps.

Actualización de desarrolladores y administradores

Se actualizan todos los desarrolladores y administradores de una app a la siguiente versión disponible. Esto te permite probar los cambios con un pequeño subconjunto de usuarios reales antes de lanzar la nueva versión al público.

Actualización de todas las llamadas

Esto actualiza todas las llamadas que una app realiza a la siguiente versión disponible. La actualización anticipada es útil debido a que brinda la opción de regresar 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 más recientes de la versión.
  • Versión: obtén información sobre las versiones de la API Graph, las consultas de las diferentes versiones y más.
  • Apps de prueba: obtén información sobre cómo crear apps de prueba para probar los cambios en tu app antes de lanzarla al público.
  • Usuarios de prueba: obtén información sobre cómo crear usuarios de prueba para probar los cambios en tu app antes de lanzarla al público.