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

La versión 26.0 de la API Graph y la API de marketing incluyen nuevas funciones, retiradas y cambios importantes. 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 importantes

• API Graph - Administración de pedidos comerciales: las llamadas a los extremos afectados en la versión 26.0 y posteriores se bloquearán a partir del 29 de julio de 2026. Los extremos se suprimirán de todas las versiones restantes de la API Graph el 27 de octubre de 2026. A partir de entonces, las llamadas devolverán errores. No hay ninguna API que la reemplace.
• 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 los campos de reemplazo que devuelven el tipo RightsHolderOwner y ya no se devolverán los campos de propietario obsoletos. Los campos obsoletos seguirán estando disponibles en la versión 25.0 y anteriores durante dos años después del lanzamiento de la versión 26.0.
• API Graph: funciones del protocolo obsoleto. A partir del 29 de julio de 2026, se suprimen cinco comportamientos obsoletos de las llamadas de la versión 26.0. Este comportamiento se aplicará a todas las versiones de la API Graph restantes admitidas a partir del 27 de octubre de 2026.
• API de marketing: anuncios en el estado de WhatsApp. La versión 26.0 añadirá funciones ampliadas de identidad, segmentación, optimización y contenido a partir del 29 de julio de 2026.
• API de marketing: audiencia de Advantage+ para campañas de viviendas, empleos 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 deberán establecer explícitamente advantage_audience en 1 o 0. Las configuraciones relajadas o predeterminadas se siguen estableciendo de forma predeterminada en 1, y las actualizaciones de los conjuntos de anuncios existentes no se ven afectadas.
• API de marketing - Feed Explorar de Instagram: la ubicación dejará de estar disponible a partir de la versión 26.0 del 29 de julio de 2026. Los desarrolladores deben suprimir la sección Explorar de sus configuraciones de ubicación.
• API de marketing: destino solo para web para campañas de web y aplicación. A partir de la versión 26.0 del 29 de julio de 2026, un anuncio no podrá usar contenido con applink_treatment establecido en web_only cuando la campaña use las ubicaciones de conversión de sitio web y aplicación. 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 del 29 de julio de 2026, el valor story se suprimirá de forma silenciosa de messenger_positions al crear o actualizar conjuntos de anuncios. La retirada se aplicará 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 con votación. A partir de la versión 26.0 del 29 de julio de 2026, se rechazarán las solicitudes que creen contenido de votación o cambien un anuncio para utilizarlo. Se seguirán admitiendo las actualizaciones de anuncios existentes que no cambien el contenido. La retirada se aplicará 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 suprimen 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 que la reemplace.
• Retiradas de la versión de la API Graph: la versión 20.0 de la API Graph se retiró y suprimió el 24 de septiembre de 2026. La versión 21.0 de la API Graph se retirará y suprimirá el 21 de enero de 2027.

Actualizaciones generales

API de marketing: compatibilidad ampliada de los anuncios con el estado de WhatsApp

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

• Identidad de WhatsApp: los solicitantes de 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 estos solicitantes.
• Segmentación por edad desconocida: cuando se selecciona la ubicación del estado de WhatsApp y no se establece user_age_unknown, el campo se establece de forma predeterminada en true, lo que significa que la campaña puede llegar a personas en WhatsApp de las que se desconoce la edad.
• 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 del contenido: los anuncios por secuencia admiten hasta diez tarjetas.

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

Retiradas y cambios de última hora

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

Los campos daily_outcomes_curve, budget_guardrail y estimate_dau se están retirando de la respuesta del extremo de estimación de entrega porque el servicio que alimenta estos valores ha quedado obsoleto. A partir de la versión 26.0 de la API Graph y la API de marketing del 29 de julio de 2026, estos campos ya no se devolverán. El cambio se aplicará a todas las versiones compatibles de la API Graph y la API de marketing a partir del 27 de octubre de 2026. No hay ninguna API que la reemplace.

Los desarrolladores deben suprimir el uso de estos campos, así como las referencias a ellos, antes de la fecha de supresión aplicable.

Entre los puntos de conexión afectados se incluyen los siguientes:

• GET /{ad-account-id}/delivery_estimate - Ad account delivery estimates
• GET /{adset-id}/delivery_estimate: estimaciones de entrega de conjuntos de anuncios

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

API Graph: retirada de la API de administración de pedidos comerciales

Las aplicaciones que llamen a estos extremos en la versión 26.0 o posterior de la API Graph se bloquearán a partir del 29 de julio de 2026. Los extremos se suprimirán de todas las versiones restantes de la API Graph a partir del 27 de octubre de 2026. A partir de entonces, las llamadas devolverán errores.

La experiencia de finalización de compra directamente en Facebook e Instagram para las tiendas se ha retirado por completo. La API de administración de pedidos comerciales permitía a las plataformas de terceros enumerar los pedidos, ver sus detalles, administrar los envíos, procesar las cancelaciones, gestionar los reembolsos y hacer un seguimiento de las devoluciones de esa experiencia de finalización de compra. Estos extremos van a quedarse obsoletos debido a la retirada de la infraestructura de pedidos comerciales subyacente.

Los desarrolladores deben dejar de llamar a estos extremos y suprimir la dependencia. No hay ninguna API que la reemplace.

Entre los extremos afectados se incluyen los siguientes:

• GET /{commerce-order-id}: detalles del pedido
• GET /{commerce-order-id}/items: artículos del pedido
• GET /{commerce-order-id}/payments - Order payments
• GET /{commerce-order-id}/payment_transaction_details: detalles de la transacción de pago
• GET /{commerce-order-id}/refunds - Order refunds
• GET /{commerce-order-id}/shipments - Order shipments
• GET /{commerce-order-shipment-id}/items: artículos de la línea de envío
• GET /{commerce-return-id}: detalles de devolución
• GET /{commerce-order-cancellation-id}/items: artículos de la línea de cancelación
• GET /{page-id}/commerce_orders: lista de pedidos por página
• GET /{commerce-merchant-settings-id}/commerce_orders: enumera los pedidos según la configuración del comerciante
• GET /{commerce-merchant-settings-id}/commerce_returns: enumera las devoluciones según la configuración del comerciante
• GET /{commerce-merchant-settings-id}/tax_settings - Tax settings

La lista completa de los 47 extremos 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 se han migrado a RightsHolderOwner

Los campos reference_owner y matched_reference_owner de AudioVisualReferenceMatch e ImageReferenceMatch, así como los campos sending_rights_holder y receiving_rights_holder de CopyrightOwnershipTransfer, dejarán de estar disponibles. A partir de la versión 26.0 de la API Graph, los campos de reemplazo que devuelven el tipo RightsHolderOwner específico están disponibles para representar mejor el modelo de propiedad que utiliza Rights Manager. Además, 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 anteriores durante dos años después del lanzamiento de la versión 26.0. Transcurrido este tiempo, se suprimirán. Los desarrolladores deberán migrar a los campos sustitutos durante este periodo de dos años.

Utiliza 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.

Entre los extremos afectados se incluyen los siguientes:

• GET /{audio-visual-reference-match-id}: obtener detalles de coincidencias de referencias
• GET /{image-reference-match-id}: obtener detalles de coincidencias de referencias de imágenes
• GET /{copyright-ownership-transfer-id} - Ownership transfer details

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

API Graph: las funciones del protocolo heredado han quedado obsoletas

A partir del 29 de julio de 2026, la versión 26.0 y posteriores de la API Graph dejarán de admitir cinco comportamientos del protocolo heredado: pretty, debug, date_format, solicitudes GET /?ids=... raíz y la gestión heredada If-None-Match/ETag.

Estos comportamientos se están retirando para simplificar las respuestas de la API Graph y hacer que la gestión de solicitudes sea más coherente.

Para la versión 26.0 de la API Graph y versiones posteriores:

• Se ignora pretty y las respuestas JSON utilizan un formato compacto. Da formato al JSON en las herramientas para clientes o el código.
• Se ignora debug y no se añade ningún sobre de respuesta de depuración. Usa las herramientas de depuración estándar. El extremo debug_token no se verá afectado.
• Las solicitudes que incluyan date_format devuelven un error de parámetro. Utiliza el formato de fecha predeterminado y convierte los valores de forma 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. Se han suprimido los encabezados de respuesta ETag antiguos y el comportamiento 304 Not Modified. 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 restantes admitidas. Revisa los registros de solicitudes de tiempo de ejecución y el registro de cambios de la versión 26.0 de la API Graph para obtener detalles sobre la migración.

Retirada de los campos de páginas antiguas para la nueva experiencia de páginas (versión 26.0 de la API Graph)

Borrador de la publicación en el blog para desarrolladores. Lanzamiento objetivo: versión 26.0 de la API Graph. Tipo de cambio: retirada (90 días).

Resumen

Para las páginas de la nueva experiencia de 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 dejarán de estar disponibles 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 para las páginas de la nueva experiencia.

Plazos

• 29 de julio de 2026: Los campos se bloquearán y la configuración se suprimirá en la versión 26.0 y posteriores de las páginas de la nueva experiencia.
• Aproximadamente 90 días después del lanzamiento: El mismo cambio se aplica a todas las versiones restantes. La fecha exacta, a finales de octubre de 2026, está pendiente de confirmación.

¿Qué va a cambiar?

En la versión 26.0 y posteriores, al solicitar cualquiera de estos cinco campos en una página de la nueva experiencia de páginas, se devuelve un error de versión y la configuración auto_publish_page_info_updates ya no aparece en la respuesta de configuración de la página. En las versiones anteriores, el comportamiento no cambiará hasta que finalice el intervalo de migración de 90 días. Después, se aplicará lo mismo a todas las versiones.

Extremos 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 auto_publish_page_info_updates se elimina de la lista de configuración devuelta.

Qué deben hacer los desarrolladores

• Suprime estos campos y la configuración auto_publish_page_info_updates de las solicitudes de tu página.
• Comprueba el uso de estos campos en las páginas de la nueva experiencia de páginas en tus paneles, integraciones de clientes y registros de solicitudes.
• 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 la audiencia de Advantage+ para campañas sobre viviendas, empleos 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 de targeting_automation pasará a ser 1 de forma predeterminada para las configuraciones de audiencia completas o relajadas. En el caso de las configuraciones de audiencia restringidas, los desarrolladores deben establecer 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 solo se aplica cuando se crea 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 que no pertenecían a categorías de anuncios especiales en la versión 23.0 de la API de marketing. Consulta la documentación de resolución de problemas de la audiencia de Advantage+ para obtener más detalles.

Los siguientes extremos de 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 del 29 de julio de 2026, con la versión 26.0 de la API de marketing, la ubicación del feed Explorar de Instagram dejará de estar disponible. La entrega en esta sección se detendrá y el gasto de las campañas se cambiará automáticamente a otras ubicaciones aptas.

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 deben suprimir la sección “Explorar” de las configuraciones de ubicación y usar otras ubicaciones aptas.

Los siguientes extremos se verán afectados:

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

API de marketing: retirada de destino solo para web para las campañas de web y aplicación

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 de anuncio con applink_treatment establecido en web_only a un anuncio de una campaña que utilice las ubicaciones de conversión del sitio web y la aplicación. Esto afecta a la creación y actualización de anuncios mediante las solicitudes POST /act_{ad-account-id}/ads y POST /{ad-id}.

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

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 Anuncio y Contenido del anuncio para obtener más información.

API de marketing: se ha retirado la ubicación de Messenger Stories

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 dejará de estar disponible al crear o actualizar conjuntos de anuncios mediante llamadas de la versión 26.0 o posteriores.

Para estas llamadas, story se suprimirá de la especificación de segmentación y ya no aparecerá en las ubicaciones eficaces para los conjuntos de anuncios nuevos o existentes. Los datos históricos de segmentación pueden seguir incluyendo story si se solicitan mediante GET /{ad_set-id}?fields=targeting. No se devolverá ningún error específico, pero pueden aplicarse los errores de validación de ubicación estándar si la eliminación de story da lugar a una configuración de ubicación no válida.

Los siguientes extremos se verán afectados:

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

Los desarrolladores que usen las ubicaciones manuales deben suprimir story de messenger_positions. Si es el único valor, suprime todo el campo messenger_positions y plantéate la posibilidad de suprimir messenger de publisher_platforms si no se utiliza ninguna otra ubicación de Messenger como marketing_messages. No se requiere ninguna acción para las ubicaciones de Advantage+.

Este cambio, que solo se aplica a la API, no afecta al Administrador de anuncios. En un principio, las llamadas sin versión y las llamadas a versiones anteriores a la 26.0 no se verán afectadas. El 27 de octubre de 2026, 90 días después del lanzamiento de la versión 26.0, la retirada se aplicará a todas las versiones de la API de marketing, incluidas las llamadas sin versión.

API de marketing: se ha retirado la creación de anuncios con votación

A partir de la versión 26.0 de la API de marketing, que se lanzará el 29 de julio de 2026, los componentes de votación dejarán de admitirse al crear o actualizar 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.

Las solicitudes que creen contenido de encuesta o cambien un anuncio para usar una se rechazarán. Se pueden seguir realizando actualizaciones en un anuncio existente que no cambien su contenido, como modificaciones en el estado, el presupuesto o la programación.

Los siguientes extremos 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 las encuestas de las especificaciones de su contenido y usar un contenido que no tenga un componente de encuesta. Al principio, las llamadas a versiones anteriores a la 26.0 y las llamadas sin versión no se ven afectadas.

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

Lanzamiento de la versión 26 del Meta Business SDK

El lanzamiento de la versión 26 del Meta Business SDK se efectuará poco después del lanzamiento de la versión 26 de la API Graph. Esta versión incluirá actualizaciones de dependencia, la integración del Administrador de parámetros de la API de conversiones, nuevas funciones de la API y la retirada de la API de administración de pedidos comerciales y varias funciones de protocolo obsoleto.

El Business SDK ahora está integrado con el generador 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 (según las preferencias establecidas por los anunciantes) y mejora los parámetros fbc, fbp, event_source_url, referrer_url, client_ip_address y el cifrado o la normalización de la información de identificación personal de los idiomas admitidos. Obtén más información aquí. La API de administración de pedidos comerciales (47 extremos) se ha retirado completamente sin sustituto. La ubicación de anuncios del feed Explorar de Instagram se ha suprimido y devuelve errores si se especifica. La ubicación de Messenger Stories se suprime de forma silenciosa de messenger_positions. Los anuncios en el estado de WhatsApp obtienen nuevas funciones, como las especificaciones de identidad, la secuencia de hasta 10 tarjetas y la optimización de conversiones fuera del sitio.

Como parte de nuestra programación de retiradas en dos años de los SDK de la plataforma, ten en cuenta las próximas retiradas y desapariciones:

• Septiembre de 2026: la versión 20.0 del SDK de la plataforma de Facebook se retirará
• Enero de 2027: la versión 21.0 del SDK de la plataforma de Facebook se retirará

Retiradas de versiones de la API

Como parte de la programación del control de versiones de Facebook de la API Graph, ten en cuenta las próximas retiradas:

API Graph

• 24 de septiembre de 2026: la versión 20.0 de la API Graph se retirará y suprimirá de la plataforma.
• 21 de enero de 2027: la versión 21.0 de la API Graph se retirará y suprimirá de la plataforma.

Para evitar cualquier interrupción, migra todas las llamadas a la versión de la API más reciente.