Versión 7.0

API Graph

Fecha de lanzamiento: 5 de mayo de 2020 | Disponible hasta: 4 de agosto de 2022 | Publicación en el blog

Versión 2 de la extensión de Facebook para empresas

Este cambio se aplica a todas las versiones.

Se han añadido dos nuevos campos a la versión 2 de la extensión de Facebook para empresas.

• Identificador de la cuenta publicitaria (ad_account_id): representa el identificador de la cuenta publicitaria seleccionada por el usuario en FBE. Esta cuenta publicitaria puede utilizarse para administrar anuncios si tu aplicación tiene permisos ads_management.

• Identificador del catálogo (catalog_id): identificador del catálogo seleccionado por el usuario en FBE. Este identificador puede utilizarse para administrar su catálogo de productos.

Instagram

Búsqueda de hashtags

Este cambio se aplica a partir de la versión 7.0.

Ahora puedes solicitar el campo timestamp en el contenido multimedia de IG que devuelven las consultas GET /{ig-hashtag-id}/top_media y GET /{ig-hashtag-id}/recent_media de búsqueda de hashtags. Por ejemplo: GET /{ig-hashtag-id}/top_media?fields=timestamp.

Messenger

Plugin de chat con clientes

Este cambio se aplica a la versión 7.0 y posteriores, y se aplicará a todas las versiones a partir del 2 de noviembre de 2020.

Cuando se inicia una nueva conversación o se continúa una existente mediante el plugin de chat con clientes, las notificaciones de webhooks messaging_postbacks y messaging_referrals iniciales incluirán un identificador user_ref anónimo para el usuario en lugar del identificador de usuario específico de la página (PSID) del usuario. Cuando el usuario envía un mensaje, las notificaciones de webhooks posteriores incluirán el PSID del usuario.

Perfiles de Messenger de páginas

Este cambio se aplica a partir de la versión 7.0.

La propiedad home_url de los perfiles de Messenger de páginas se ha retirado para todas las operaciones (GET, POST y DELETE).

Open Graph

Retiradas

Este cambio se aplica a la versión 7.0 y se aplicará a todas las versiones a partir del 3 de agosto de 2020.

• GET /{open-graph-action-type-id}
• POST /{user-id}/{open-graph-action-type-id}

Páginas

Identificadores de usuario específicos de la aplicación

Estos cambios se aplican a la versión 7.0 y posteriores, y se aplicarán a todas las versiones a partir del 5 de mayo de 2021.

El 1 de mayo de 2018, la API de páginas empezó a devolver identificadores de usuario específicos de la página (PSID) en lugar de identificadores de usuario específicos de la aplicación (ASID) para todas las aplicaciones nuevas. Las aplicaciones creadas antes de esta fecha siguieron recibiendo ASID a menos que optaran por recibir PSID. Ahora todas las aplicaciones recibirán PSID de la API de páginas.

La API con identificador de usuario específico de la aplicación permite asignar ASID con su PSID correspondiente. Esta API se ha retirado en la versión 7.0 y posteriores, pero se puede seguir utilizando con versiones anteriores hasta el 5 de mayo de 2021.

Retiradas

Estos cambios se aplican a la versión 7.0 y posteriores, y se aplicarán a todas las versiones a partir del 3 de agosto de 2020.

Se han retirado los extremos siguientes:

• GET /{page-id}/featured_videos_collection
• POST /{page-id}/albums

Permisos

El permiso manage_pages se ha retirado y se ha reemplazado por cuatro nuevos permisos:

• pages_manage_ads
• pages_manage_metadata
• pages_read_engagement
• pages_read_user_content

El permiso publish_pages se ha retirado y se ha reemplazado por dos nuevos permisos:

• pages_manage_posts
• pages_manage_engagement

Las aplicaciones que ya se han aprobado para el permiso manage_pages o publish_pages (o ambos) se migrarán a los nuevos permisos antes del 1 de junio de 2020.

En el caso de las aplicaciones que se han enviado, pero que todavía no se han revisado para el permiso manage_pages o publish_pages (o ambos), el proceso de revisión seguirá con normalidad. Una vez aprobadas, las aplicaciones se migrarán a los nuevos permisos antes del 1 de junio de 2020.

Para enviar, o volver a enviar, una solicitud de permisos de página antes del 1 de junio de 2020, selecciona los permisos que ves en el panel de aplicaciones (manage_pages, publish_pages, ambos o los nuevos permisos). La aplicación se migrará automáticamente a los nuevos permisos antes del 1 de junio de 2020, si es necesario.

Después del 1 de junio de 2020, los permisos manage_pages y publish_pages dejarán de estar disponibles en la selección Revisión de la aplicación > Permisos y funciones del panel de aplicaciones.

Los permisos manage_pages y publish_pages se retirarán de forma íntegra en mayo de 2022. Se deben aplicar cambios en el código antes de esta fecha.

SDK

Visita el registro de cambios del SDK para iOS y el registro de cambios de Android SDK para obtener información sobre los próximos cambios importantes en estos SDK.

Usuario

Retiradas

Estos cambios se aplican a la versión 7.0 y posteriores, y se aplicarán a todas las versiones a partir del 3 de agosto de 2020.

Se han retirado los extremos siguientes:

• GET /{user-id}/books
• GET /{user-id}/games
• GET /{user-id}/movies
• GET /{user-id}/television

API de marketing

Fecha de lanzamiento: 5 de mayo de 2020 | Disponible hasta: 3 de marzo de 2021 | Publicación en el blog

Campañas publicitarias

Optimización del presupuesto de campaña

Este cambio se aplica a partir de la versión 7.0.

En el caso de una campaña publicitaria concreta, ya no puedes establecer lifetime_budget y spend_cap al mismo tiempo. Solo puedes seleccionar lifetime_budget.

El presupuesto del conjunto de anuncios de una campaña se reparte durante el transcurso de la campaña. Cuando usas lifetime_budget en el nivel de la campaña, ya se incluye la información del límite de gasto. Por lo tanto, no hay ningún motivo por el que añadir un segundo límite de gasto.

Puedes seguir usando spend_cap para las campañas que no usan la optimización del presupuesto de campaña.

Categoría de anuncio especial

Este cambio se aplica a partir de la versión 7.0.

El parámetro special_ad_category del extremo POST /act_<AD_ACCOUNT_ID>/campaigns se ha retirado y se ha reemplazado por el nuevo parámetro special_ad_categories.

El nuevo parámetro special_ad_categories es obligatorio y acepta una matriz. Si tienes el parámetro special_ad_category, seguirá devolviendo una cadena, pero deberías usar GET /{campaign-id}?fields=special_ad_categories para recuperar una matriz.

Para obtener más información, consulta Categoría de anuncio especial.

Obtén más información sobre las categorías de anuncios especiales en el Servicio de ayuda para publicidad.

Retiradas

Este cambio se aplica a partir de la versión 7.0.

El parámetro budget_rebalance_flag se ha retirado. Te recomendamos que utilices la optimización del presupuesto de campaña en su lugar.

Campañas publicitarias de Atlas

Retiradas

Este cambio se aplica a partir de la versión 7.0.

• GET /{atlas-ad-campaign-id}/cumulative_edited_date

Catálogo de productos

Retiradas

Este cambio se aplica a partir de la versión 7.0.

El parámetro cpas_parent_catalog_settings del perímetro POST /PRODUCT_CATALOG_ID se ha retirado para las aplicaciones de terceros.