Presentación de la versión 26.0 de la API Graph y de la API de marketing

La versión 26.0 de la API Graph y de la API de marketing incluye nuevas funciones, obsolescencias y cambios radicales. Consulta lo más destacado a continuación y visita el registro de cambios de la versión 26.0 para obtener una lista completa de los cambios y los detalles.

Fechas y cambios clave

• API Graph - Administración de pedidos de comercio: las llamadas a los puntos de conexión afectados en la versión 26.0 y posteriores se bloquearán a partir del 29 de julio de 2026. Los puntos de conexión se eliminarán de todas las versiones restantes de la API Graph el 27 de octubre de 2026. Después de esa fecha, las llamadas devolverán errores. No hay ninguna API de reemplazo disponible.
• API Graph: campos de propietario de Rights Manager - A partir de la versión 26.0 del 29 de julio de 2026, estarán disponibles campos de reemplazo que devuelven el tipo RightsHolderOwner y ya no se devolverán los campos de propietario obsoletos. Los campos obsoletos permanecerán disponibles en la versión 25.0 y en versiones anteriores durante dos años después del lanzamiento de la versión 26.0.
• API Graph - Funciones del protocolo heredado: a partir del 29 de julio de 2026, se eliminarán cinco comportamientos heredados de las llamadas de la versión 26.0. El mismo comportamiento se aplicará a todas las versiones restantes admitidas de la API Graph a partir del 27 de octubre de 2026.
• API de marketing - Anuncios en el estado de WhatsApp: la versión 26.0 agrega funciones ampliadas de identidad, segmentación, optimización y contenido a partir del 29 de julio de 2026.
• API de marketing: público Advantage+ de campañas de vivienda, empleo y productos y servicios financieros: a partir de la versión 26.0 del 29 de julio de 2026, los conjuntos de anuncios nuevos o copiados con segmentación restringida deben configurar explícitamente advantage_audience en 1 o 0. Las configuraciones predeterminadas o flexibles siguen usando 1 de forma predeterminada, y las actualizaciones de conjuntos de anuncios existentes no se ven afectadas.
• API de marketing - Feed de la sección "Explorar" de Instagram: la ubicación ya no estará disponible a partir de la versión 26.0 del 29 de julio de 2026. Los desarrolladores deben eliminar la sección "Explorar" de las configuraciones de ubicación.
• API de marketing - Destino solo web para campañas de web y app: a partir de la versión 26.0 del 29 de julio de 2026, un anuncio no puede usar contenido con applink_treatment configurado como web_only cuando la campaña usa las ubicaciones de conversión de sitio web y app. La restricción se aplicará a todas las versiones de la API de marketing a partir del 27 de octubre de 2026.
• API de marketing - Messenger Stories: a partir de las llamadas de la versión 26.0 el 29 de julio de 2026, el valor story se eliminará de forma silenciosa de messenger_positions cuando se creen o actualicen conjuntos de anuncios. La obsolescencia se aplica a todas las versiones de la API de marketing, incluidas las llamadas sin versión, a partir del 27 de octubre de 2026.
• API de marketing - Creación de anuncios de encuesta: a partir de la versión 26.0 del 29 de julio de 2026, se rechazarán las solicitudes que creen contenido de encuesta o cambien un anuncio para usarlo. Las actualizaciones de anuncios existentes que no cambien el contenido seguirán siendo compatibles. La obsolescencia se aplica a todas las versiones de la API de marketing a partir del 27 de octubre de 2026.
• API Graph y API de marketing - Campos de estimación de entrega: los campos de respuesta daily_outcomes_curve, budget_guardrail y estimate_dau se eliminarán de las llamadas a la versión 26.0 a partir del 29 de julio de 2026 y de todas las versiones admitidas restantes a partir del 27 de octubre de 2026. No hay ninguna API de reemplazo disponible.
• Las versiones de la API Graph quedarán obsoletas: la versión 20.0 de la API Graph quedará obsoleta y se eliminará el 24 de septiembre de 2026. La versión 21.0 de la API Graph quedará obsoleta y se eliminará el 21 de enero de 2027.

Actualizaciones generales

API de marketing: mayor compatibilidad con los anuncios en el estado de WhatsApp

Comenzando con la versión 26.0 de la API de marketing a partir del 29 de julio de 2026, los anuncios en el estado de WhatsApp admiten funciones adicionales de identidad, segmentación, optimización y contenido.

• Identidad de WhatsApp: quienes llamen a la API de marketing de terceros deben incluir explícitamente wamo_whatsapp_identity_spec en el contenido de los anuncios destinados a la entrega en el estado de WhatsApp. La identidad de WhatsApp no se establece automáticamente de forma predeterminada para estas llamadas.
• Segmentación por edad desconocida: cuando se selecciona la ubicación de estado de WhatsApp y no se configura user_age_unknown, el campo se configura de forma predeterminada en true, lo que significa que la campaña puede llegar a personas en WhatsApp cuya edad se desconoce.
• Optimización: la optimización de conversiones para conversiones fuera del sitio se admite en los objetivos de ventas, clientes potenciales e interacción. También se admite la optimización de visitas a la página de destino.
• Formato de contenido: los anuncios por secuencia admiten hasta 10 tarjetas.

Consulta la documentación sobre segmentación por ubicación y segmentación básica para obtener más información.

Elementos obsoletos y cambios radicales

API Graph y API de marketing: eliminación del campo de estimación de entrega

Los campos daily_outcomes_curve, budget_guardrail y estimate_dau se eliminarán de la respuesta del punto de conexión de estimación de entrega, ya que el servicio que impulsaba estos valores quedó obsoleto. Comenzando por la versión 26.0 de la API Graph y la API de marketing a partir del 29 de julio de 2026, estos campos ya no se devolverán. El cambio se aplicará a todas las versiones restantes admitidas de la API Graph y la API de marketing a partir del 27 de octubre de 2026. No hay ninguna API de reemplazo disponible.

Los desarrolladores deben eliminar el uso de estos campos o las referencias a ellos antes de la fecha de eliminación aplicable.

Algunos puntos de conexión representativos afectados:

• GET /{ad-account-id}/delivery_estimate - Estimaciones de entrega de la cuenta publicitaria
• GET /{adset-id}/delivery_estimate - Estimaciones de entrega de conjuntos de anuncios

La lista completa de campos y puntos de conexión estará disponible en el registro de cambios de la versión 26.0.

API Graph: obsolescencia de la API de administración de pedidos de comercio

Las apps que llamen a estos puntos de conexión en la versión 26.0 o posterior de la API Graph se bloquearán a partir del 29 de julio de 2026. Los puntos de conexión se eliminarán de todas las versiones restantes de la API Graph el 27 de octubre de 2026. Después de esa fecha, las llamadas devolverán errores.

La experiencia de finalización de compra directamente en Facebook e Instagram para tiendas dejó de estar disponible. La API de administración de pedidos de comercio permitía que las plataformas de terceros pudieran publicar pedidos, ver los detalles de los pedidos, administrar envíos, procesar cancelaciones, manejar reembolsos y hacer un seguimiento de las devoluciones de esa experiencia de finalización de compra. Como la infraestructura de pedidos comerciales subyacente se está retirando, estos puntos de conexión quedarán obsoletos.

Los desarrolladores deben dejar de llamar a estos puntos de conexión y eliminar la dependencia. No hay ninguna API de reemplazo disponible.

Los puntos de conexión representativos afectados incluyen:

• GET /{commerce-order-id} - Detalles del pedido
• GET /{commerce-order-id}/items - Artículos de la línea de pedido
• GET /{commerce-order-id}/payments - Pagos de pedidos
• GET /{commerce-order-id}/payment_transaction_details - Detalles de la transacción de pago
• GET /{commerce-order-id}/refunds - Reembolsos de pedidos
• GET /{commerce-order-id}/shipments - Envíos de pedidos
• GET /{commerce-order-shipment-id}/items - Artículos de la línea de envío
• GET /{commerce-return-id} - Detalles de la devolución
• GET /{commerce-order-cancellation-id}/items - Artículos de la línea de cancelación
• GET /{page-id}/commerce_orders - Enumerar pedidos por página
• GET /{commerce-merchant-settings-id}/commerce_orders - Enumerar pedidos por configuración del comerciante
• GET /{commerce-merchant-settings-id}/commerce_returns - Enumerar devoluciones por configuración del comerciante
• GET /{commerce-merchant-settings-id}/tax_settings - Configuración de impuestos

La lista completa de los 47 puntos de conexión afectados estará disponible en el registro de cambios de la versión 26.0 de la API Graph.

API Graph: los campos de propietario de Rights Manager migraron a RightsHolderOwner

Los campos reference_owner y matched_reference_owner de AudioVisualReferenceMatch e ImageReferenceMatch, junto con los campos sending_rights_holder y receiving_rights_holder de CopyrightOwnershipTransfer, quedarán obsoletos. A partir de la versión 26.0 de la API Graph, los campos de reemplazo que devuelven el tipo de RightsHolderOwner dedicado están disponibles para representar mejor el modelo de propiedad que utiliza Rights Manager, y los campos obsoletos ya no se devuelven en las respuestas de la versión 26.0 y posteriores.

Los campos obsoletos seguirán funcionando en la versión 25.0 y en versiones anteriores durante dos años después del lanzamiento de la versión 26.0. Transcurrido ese tiempo, se eliminarán. Los desarrolladores deben migrar a los campos de reemplazo durante este intervalo de dos años.

Usa los siguientes campos de reemplazo:

• Usa reference_owner_rh_owner en lugar de reference_owner.
• Usa matched_reference_owner_rh_owner en lugar de matched_reference_owner.
• Usa sending_rights_holder_owner en lugar de sending_rights_holder.
• Usa receiving_rights_holder_owner en lugar de receiving_rights_holder.

Los puntos de conexión representativos afectados incluyen:

• GET /{audio-visual-reference-match-id} - Consultar detalles de coincidencias de referencia
• GET /{image-reference-match-id} - Detalles de coincidencia de referencia de imagen
• GET /{copyright-ownership-transfer-id} - Detalles de la transferencia de propiedad

La lista completa de campos estará disponible en el registro de cambios de la versión 26.0 de la API Graph.

API Graph: obsolescencia de funciones del protocolo anterior

A partir del 29 de julio de 2026, la versión 26.0 de la API Graph y las versiones posteriores ya no admitirán cinco comportamientos de protocolos anteriores: pretty, debug, date_format, solicitudes de raíz GET /?ids=... y procesamiento heredado If-None-Match / ETag.

Estos comportamientos se están eliminando para simplificar las respuestas de la API Graph y hacer que el manejo de solicitudes sea más consistente.

En la versión 26.0 y posteriores de la API Graph:

• pretty se ignora, y las respuestas JSON usan formato compacto. Dar formato al JSON en herramientas o código del cliente.
• Se ignora debug y no se agrega ningún sobre de respuesta de depuración. Utilizar herramientas de depuración estándar. El punto de conexión debug_token no se ve afectado.
• Las solicitudes que incluyen date_format devuelven un error de parámetro. Utiliza el formato de fecha predeterminado y convierte los valores de manera local si es necesario.
• Las solicitudes raíz que utilizan GET /?ids=... devuelven un error de parámetro. Utiliza solicitudes por objeto o los lotes admitidos.
• Se ignora If-None-Match. Los encabezados de respuesta ETag antiguos y el comportamiento 304 Not Modified se eliminaron, y las solicitudes devuelven respuestas completas.

A partir del 27 de octubre de 2026, estos cambios se aplicarán a todas las versiones de la API Graph admitidas. Revisa los registros de solicitudes en tiempo de ejecución y el registro de cambios de la versión 26.0 de la API Graph para obtener detalles de la migración.

Obsolescencia de campos de página antiguos para la nueva experiencia de páginas (API Graph v26.0)

Borrador de la publicación del blog para desarrolladores. Versión objetivo: API Graph v26.0. Tipo de cambio: obsolescencia (90 días).

Resumen

En el caso de las páginas de la nueva experiencia para páginas, cinco campos de nodos de página heredados (current_location, genre, network, parking, start_info) y la configuración de página auto_publish_page_info_updates quedarán obsoletos a partir de la versión 26.0 de la API Graph. Estos campos ya no se mantienen y no se debe acceder a ellos en las páginas con la nueva experiencia para páginas.

Línea de tiempo

• 29 de julio de 2026: los campos están bloqueados y la configuración se elimina en la versión 26.0 y versiones posteriores de las páginas de la nueva experiencia para páginas.
• Aproximadamente 90 días después del lanzamiento: El mismo cambio se aplica a todas las versiones restantes. Se confirmará la fecha exacta a fines de octubre de 2026.

¿Qué cambiará?

En la versión 26.0 y posteriores, si se solicita alguno de estos cinco campos en una página de la nueva experiencia para páginas, se devuelve un error de versión, y la opción auto_publish_page_info_updates ya no aparece en la respuesta de la configuración de la página. En versiones anteriores, el comportamiento no cambiará hasta que finalice el período de migración de 90 días. Luego de ese período, se aplicará lo mismo a todas las versiones.

Puntos de conexión afectados:

• GET /{page-id}?fields=current_location
• GET /{page-id}?fields=genre
• GET /{page-id}?fields=network
• GET /{page-id}?fields=parking
• GET /{page-id}?fields=start_info
• GET /{page-id}?fields=settings: la configuración de auto_publish_page_info_updates se elimina de la lista de configuración devuelta

Qué deben hacer los desarrolladores

• Elimina estos campos y la configuración auto_publish_page_info_updates de las solicitudes de tu página.
• Revisa los registros de solicitudes, las integraciones de clientes y los paneles para usar estos campos en las páginas de la nueva experiencia para páginas.
• Consulta el registro de cambios de la versión 26.0 de la API Graph para acceder a la lista completa y actualizada.

Referencia

• Referencia de nodos de página

API de marketing: requisitos de público Advantage+ en las campañas de empleos, vivienda y productos y servicios financieros

A partir del 29 de julio de 2026, con la versión 26.0 de la API de marketing, el parámetro advantage_audience dentro de targeting_automation adoptará automáticamente el valor 1 para las configuraciones de público totalmente predeterminadas o flexibles. En el caso de las configuraciones de público restringidas, los desarrolladores deben configurar explícitamente advantage_audience en 1 o 0 para las campañas de las categorías de anuncios especiales de vivienda, empleo o productos y servicios financieros.

Este comportamiento se aplica solo cuando creas un nuevo conjunto de anuncios. La actualización de un conjunto de anuncios existente no mostrará este comportamiento en ninguna versión de la API.

Este es el mismo comportamiento que se introdujo para las campañas fuera de las categorías de anuncios especiales en la versión 23.0 de la API de marketing. Consulta la documentación de solución de problemas del público Advantage+ para obtener más detalles.

Los siguientes puntos de conexión de la API se verán afectados:

• POST /{ad-account-id}/adsets
• POST /{adset-id}
• POST /{adset-id}/copies

API de marketing: la ubicación de anuncios "Explorar" ya no está disponible

A partir de la versión 26.0 de la API de marketing del 29 de julio de 2026, la ubicación del feed de la sección "Explorar" de Instagram ya no estará disponible. La entrega en la sección "Explorar" se detendrá, y el gasto de la campaña se cambiará automáticamente a otras ubicaciones elegibles.

Si intentas crear o actualizar un conjunto de anuncios que especifique la ubicación de la sección "Explorar", se producirá un error. Los desarrolladores deberían eliminar la sección "Explorar" de las configuraciones de ubicación y usar otras ubicaciones aptas.

Los siguientes puntos de conexión se verán afectados:

• POST /act_{ad-account-id}/adsets
• POST /{ad-set-id}

API de marketing: obsolescencia del destino solo web en campañas de web y app

A partir del 29 de julio de 2026, con la versión 26.0 de la API de marketing, los desarrolladores ya no podrán adjuntar contenido del anuncio con applink_treatment configurado como web_only a un anuncio de una campaña que use las ubicaciones de conversión de sitio web y app. Esto afecta a la creación y actualización de anuncios a través de POST /act_{ad-account-id}/ads y POST /{ad-id}.

El punto de conexión del contenido del anuncio no cambiará, pero POST /act_{ad-account-id}/adcreatives es donde se configura el valor applink_treatment. Los desarrolladores deben revisar sus integraciones de applink_treatment=web_only y usar la selección automática de destino u otro destino manual compatible con las campañas de sitio web y app.

El 27 de octubre de 2026, 90 días después del lanzamiento de la versión 26.0, esta restricción se aplicará a todas las versiones de la API de marketing. Consulta la documentación de anuncio y contenido del anuncio para obtener más información.

API de marketing: ubicación de Messenger Stories obsoleta

A partir del 29 de julio de 2026, con la versión 26.0 de la API de marketing, el valor story en messenger_positions ya no estará disponible cuando se creen o actualicen conjuntos de anuncios mediante llamadas a la versión 26.0 o versiones posteriores.

En esas llamadas, story se eliminará de la especificación de segmentación y ya no aparecerá en las ubicaciones efectivas de los conjuntos de anuncios nuevos o preexistentes. Los datos históricos de segmentación pueden seguir incluyendo story cuando se soliciten mediante GET /{ad_set-id}?fields=targeting. No se devolverá un error específico, pero pueden aplicarse errores de validación de ubicación estándar si la eliminación de story deja una configuración de ubicación no válida.

Los siguientes puntos de conexión se verán afectados:

• POST /act_{ad-account-id}/adsets
• POST /{ad_set-id}

Los desarrolladores que usen las ubicaciones manuales deben eliminar story de messenger_positions. Si es el único valor, elimina todo el campo messenger_positions y considera eliminar messenger de publisher_platforms cuando no se use ninguna otra ubicación de Messenger, como marketing_messages. No es necesario realizar ninguna acción en las ubicaciones Advantage+.

Este cambio solo de la API no afecta al administrador de anuncios. Inicialmente, las llamadas sin versión y las llamadas a versiones anteriores a la versión 26.0 no se ven afectadas. El 27 de octubre de 2026, 90 días después del lanzamiento de la versión 26.0, la obsolescencia se aplicará a todas las versiones de la API de marketing, incluidas las llamadas sin versión.

API de marketing: obsolescencia de la función de creación de anuncios con encuesta

A partir de la versión 26.0 de la API de marketing del 29 de julio de 2026, los componentes de encuesta ya no serán compatibles cuando crees o actualices anuncios y contenido de anuncios. El campo poll_spec y el valor "poll" del campo type ya no estarán disponibles en interactive_components_spec.

Se rechazarán las solicitudes que creen contenido de encuesta o cambien un anuncio para que use ese tipo de contenido. Pueden continuar las actualizaciones de un anuncio existente que no cambien su contenido, como modificaciones en el estado, el presupuesto o el calendario.

Los siguientes puntos de conexión se verán afectados:

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• POST /{ad_id}
• GET /{ad_account_id}/generatepreviews

Los desarrolladores deben eliminar los campos relacionados con encuestas de las especificaciones de su contenido y usar contenido sin componentes de encuesta. Inicialmente, las llamadas a versiones anteriores a la 26.0 y las llamadas sin versión no se ven afectadas.

El 27 de octubre de 2026, 90 días después del lanzamiento de la versión 26.0, esta eliminación se aplicará a todas las versiones de la API de marketing.

Lanzamiento de la versión 26 del SDK de Meta para empresas

La versión 26 del SDK de Meta para empresas se publicará poco después de la versión 26 de la API Graph. Esta versión incluirá actualizaciones de dependencias, la integración de la herramienta de creación de parámetros de la API de conversiones, nuevas funciones de la API y la obsolescencia de la API de administración de pedidos de comercio y varias funciones de protocolo anteriores.

El SDK para empresas ahora está integrado con la herramienta de creación de parámetros de la API de conversiones de código abierto. Puedes aprovechar esta nueva integración para mejorar la calidad de la integración de la API de conversiones. Funciones clave: genera automáticamente (restringido por la preferencia de los anunciantes) y mejora los parámetros fbc, fbp, event_source_url, referrer_url, client_ip_address y la normalización/cifrado automático de la información de identificación personal en los idiomas admitidos. Obtén más información aquí. La API de administración de pedidos de comercio (47 puntos de conexión) quedó completamente obsoleta y no tiene reemplazo. La ubicación de anuncios en el feed de la sección "Explorar" de Instagram se eliminó y muestra errores si se la especifica. La ubicación de Messenger Stories se elimina silenciosamente de messenger_positions. Los anuncios en el estado de WhatsApp obtienen nuevas funciones, como la especificación de identidad, secuencias de hasta 10 tarjetas y optimización de conversión fuera del sitio.

Como parte de nuestro calendario de obsolescencias de 2 años correspondiente a los SDK de la plataforma, ten en cuenta los próximos elementos que quedarán obsoletos y las próximas desactivaciones:

• Septiembre de 2026: Quedará obsoleto el SDK de la plataforma de Facebook v20.0
• Enero de 2027: Quedará obsoleto el SDK de la plataforma de Facebook v21.0

Versiones de la API obsoletas

Como parte del calendario de versiones de Facebook correspondiente a la API Graph, ten en cuenta los próximos elementos que quedarán obsoletos:

API Graph

• El 24 de septiembre de 2026, quedará obsoleta la versión 20.0 de la API Graph y se la eliminará de la plataforma.
• El 21 de enero de 2027, quedará obsoleta la versión 21.0 de la API Graph y se la eliminará de la plataforma.

Para evitar interrupciones, migra todas las llamadas a la última versión de la API.