Versión 8.0

API Graph

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

Identificadores de acceso

Extremos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones el 2 de noviembre de 2020.

• GET /token_deprecation_check

Álbumes

Extremos reincorporados

Se aplica a todas las versiones.

• GET /{album-id}/likes

Configuración de la aplicación

Tipos de aplicaciones

Este cambio se aplica a todas las versiones.

Ahora es posible elegir el tipo de aplicación para las aplicaciones recién creadas: Empresa, Juegos o Ninguno. De este modo, se simplifica la interfaz de la revisión de la aplicación, ya que se eliminan los permisos y las funciones inadecuados en función del tipo que se haya elegido. Además, las aplicaciones empresariales utilizan un nuevo mecanismo de autorización, ya no usan modos y tienen acceso a una nueva función. Consulta la entrada sobre el registro de cambios de las aplicaciones empresariales para obtener más información.

Aplicaciones empresariales

Las aplicaciones empresariales utilizan un nuevo mecanismo de autorización denominado niveles de acceso. Los niveles de acceso permiten que el proceso de revisión de la aplicación sea más sencillo e intuitivo, y sustituyen las funcionalidades que ofrecían los modos publicado y de desarrollo y que se han eliminado de las aplicaciones empresariales. Además, se ha lanzado una nueva función de acceso al perfil de usuario de los activos empresariales, con la que las aplicaciones empresariales pueden leer un pequeño conjunto de campos públicos del usuario. A continuación se describen de forma detallada estos cambios.

Niveles de acceso

Se aplica a todas las versiones.

Los niveles de acceso son un nuevo mecanismo de autorización de la API Graph para las aplicaciones empresariales que se aplica a los permisos y funciones de manera individual. El acceso estándar solo permite el acceso a los datos que son propiedad de aquellos usuarios que tienen un rol en la aplicación o en una empresa que la ha reclamado. El acceso avanzado permite el acceso a los datos que son propiedad de cualquier usuario de la aplicación, aunque requiere una revisión de la aplicación. Las aplicaciones empresariales reciben automáticamente acceso estándar para todos los permisos y funciones disponibles en función de su tipo.

Eliminación de los modos publicado y de desarrollo

Se aplica a todas las versiones.

El modo de desarrollo y el modo publicado se han eliminado de las aplicaciones empresariales. Ambos modos se sustituyeron por los niveles de acceso, que proporcionan la misma funcionalidad y mayor versatilidad. Dado que las aplicaciones empresariales tienen acceso estándar para todos los permisos y funciones disponibles, cualquier usuario con un rol en la aplicación o en una empresa que la haya reclamado puede conceder a la aplicación cualquiera de los permisos disponibles en cualquier momento. De esta manera, se elimina la necesidad de realizar una revisión de la aplicación o de cambiar entre modos durante el desarrollo.

Nueva función de acceso al perfil del usuario de los activos empresariales

Se aplica a todas las versiones.

La nueva función de acceso al perfil del usuario de los activos empresariales permite que las aplicaciones empresariales lean un pequeño conjunto de campos públicos del usuario, siempre y cuando este haya interactuado con activos que sean propiedad de una empresa que haya reclamado la aplicación. Consulta la referencia sobre el acceso al perfil del usuario de los activos empresariales para ver una lista de los campos de usuario que se pueden leer.

Comentarios

Extremos reincorporados

Se aplica a todas las versiones.

• GET /{comment-id}/likes

Dispositivos

Extremos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones el 2 de noviembre de 2020.

• POST /device/share

Grupos

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{group-id}/posts

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones el 2 de noviembre de 2020.

• GET /{group-post-id}/likes

Instagram

Nuevo extremo oEmbed de Instagram

Se aplica a todas las versiones.

Se incorporó el nuevo extremo GET /instagram_oembed. Ofrece la misma funcionalidad que los extremos oEmbed heredados de Instagram, que se retirarán el 24 de octubre de 2020. El nuevo extremo requiere un identificador de acceso, por lo que necesitarás una cuenta de desarrollador de Facebook y una aplicación registrada para acceder a él. Consulta el documento sobre oEmbed de Instagram para ver las instrucciones de uso y detalles adicionales.

Acontecimientos importantes

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{life-event-id}
• GET /{life-events-id}/photos

Enlaces

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{link-id}/reactions

Vídeos en directo

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{live-video-id}/likes

Utiliza el extremo GET /{live-video-id}/reactions para recuperar los Me gusta de un objeto LiveVideo.

Parámetro save_vod

Se aplica a partir de la versión 8.0. Se aplicará a todas las versiones el 2 de noviembre de 2020.

El parámetro save_vod se retiró de los perímetros siguientes:

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Plataforma de Messenger

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

Revisión de la aplicación

Se aplica a todas las versiones.

La revisión de la aplicación de Messenger se movió de Productos > Messenger > Configuración a Revisión de la aplicación en el panel de aplicaciones. Para solicitar permisos específicos de Messenger, como pages_messaging, pages_user_gender, pages_user_locale y pages_user_timezone, dirígete a Revisión de la aplicación > Permisos y funciones. Para obtener más detalles, consulta la documentación sobre la revisión de la aplicación de Messenger.

Perímetro de perfiles de Messenger

Se aplica a partir de la versión 8.0.

El tipo de menú persistente anidado se ha retirado para POST /{page-id}/messenger_profile.

Nueva función: Messenger para tiendas

Se aplica a partir de la versión 8.0.

Ofrece compatibilidad con el envío y la recepción de productos en Messenger para tiendas. Incluye la plantilla de producto, que se puede utilizar para enviar productos en mensajes, Webhooks para mensajes con la plantilla de producto y mensajes de la página de detalles del producto de las tiendas de Facebook y Webhooks echo para los mensajes con productos.

• GET /{message_id}/access_requests
• POST {page_id}/message
• Webhook message_echo
• Webhook messages

Ofertas nativas

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

Extremos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones a partir del 2 de noviembre de 2020.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

Páginas

Extremos retirados

Se retiraron a partir de la versión 8.0.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

Publicación de la página

Se retiraron de todas las versiones.

El formato de los identificadores de comentario, {page-id}_{post_id}_{comment-id}, de la publicación de la página se ha retirado. Utiliza el formato {pagepost-id}_{comment-id} en su lugar.

Fotos

Extremos retirados

Se retiraron de todas las versiones.

• GET /{photo-id}/sharedposts

Lugares

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{place-information-id} (consulta Correcciones)

Publicaciones

Extremos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones a partir del 2 de noviembre de 2020.

• GET /{post-id}/likes

Utiliza el extremo GET /post/reactions para recuperar los Me gusta de una publicación.

Búsqueda

Extremos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones el 2 de noviembre de 2020.

• GET /search?type=place
• GET /search?type=audience_interest

Configuración de seguridad

Campos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones a partir de noviembre de 2020.

• secure_browsing

Plugins sociales

Extremos oEmbed de Facebook

Este cambio se aplicará a todas las versiones el 24 de octubre de 2020.

Los extremos oEmbed de Facebook, que permiten que las aplicaciones obtengan el código HTML de inserción de las publicaciones y vídeos públicos de Facebook, se retirarán el 24 de octubre de 2020. Se han incorporado tres extremos nuevos que proporcionarán la misma funcionalidad que los anteriores a los que sustituirán:

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

Los extremos nuevos requieren un identificador de acceso, y las solicitudes estarán sujetas a una limitación de frecuencia. Consulta la documentación del nuevo extremo de oEmbed para obtener información adicional y detalles sobre el uso.

Usuarios

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{user-id}/taggable_friends

Campos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones a partir de noviembre de 2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Se retiraron de todas las versiones.

• can_review_measurement_request
• is_famedeeplinkinguser

Reautorización

Este cambio se aplica a todas las versiones.

A partir del 24 de octubre de 2020, los siguientes campos requerirán una reautorización del acceso a los datos después de 90 días de inactividad:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

Foto de usuario

Se aplica a todas las versiones a partir del 24 de octubre de 2020.

A partir del 24 de octubre de 2020, el extremo GET /{user-id}/picture (GET /{user-id}?fields=picture) requerirá un identificador de usuario específico de la aplicación (ASID) para las solicitudes sin identificador. Si realizas una consulta al usuario con un identificador distinto del ASID, deberás incluir un identificador de acceso de aplicación, cliente o usuario en la solicitud. Consulta los detalles en la referencia de la foto de usuario.

Preguntas del vídeo

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

Extremos retirados

Se retiraron a partir de la versión 8.0. Se retirarán de todas las versiones a partir del 2 de noviembre de 2020.

• GET /{company-id}/access_requests
• GET /access_requests

API de marketing

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

Cuentas publicitarias

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

Permisos

Se aplica a partir de la versión 8.0. Se aplicará a todas las versiones el 2 de noviembre de 2020.

Las aplicaciones necesitan permisos detallados para acceder a los campos empresariales de una cuenta publicitaria. Estos permisos deben concederse para un objeto empresarial específico.

Reglas de personalización de activos

Validación

Se aplica a partir de la versión 8.0.

Todos los anuncios que utilicen el parámetro asset_feed_spec deben contener al menos dos normas de personalización de destino. Si el contenido utiliza el parámetro asset_feed_spece incluye menos de dos normas, no podrás crear el anuncio.

Este cambio afecta a la personalización de activos por ubicación, los anuncios en varios idiomas y la personalización de activos por segmento.

Personalización de activos por segmento

Se aplica a partir de la versión 8.0. Se aplicará a todas las versiones el 2 de noviembre de 2020.

Todos los casos de uso que no tienen relación con la geolocalización se han retirado para los usuarios de la Personalización de activos por segmento. Con este cambio, todas las reglas de segmentación deben contener información de geolocalización en la especificación de la personalización. Hay una excepción para la norma predeterminada, que no necesita incluir geolocalización.

Pujas

Estrategia de puja de coste objetivo

Se aplica a partir de la versión 8.0.

La estrategia de puja TARGET_COST se ha retirado. Para seguir controlando los costes, recomendamos utilizar las pujas con límite de coste. Consulta todas las estrategias de puja disponibles.

Business Manager

Extremos retirados

Se retiraron a partir de la versión 8.0.

• GET{system-user-id}/updated_by

Reincorporación de los extremos de acuerdos de uso compartido

Se aplica a todas las versiones.

Se han vuelto a incorporar los siguientes extremos:

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

Ambos extremos se habían retirado ya con el lanzamiento de la API Graph versión 6.0.

Canvas

Extremos retirados

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

API de catálogo

Permisos

Se aplica a partir de la versión 8.0. Se aplicará a todas las versiones el 31 de enero de 2021.

Ya no necesitas el permiso ads_management para acceder a los extremos del catálogo de productos. En adelante, necesitarás el permiso catalog_management para llamar a esos extremos. Los desarrolladores que hayan tenido acceso a los extremos del catálogo a través de ads_management en los últimos 90 días se migrarán automáticamente a los permisos catalog_management antes del 14 de agosto de 2020.

A partir de este momento y hasta el 28 de febrero de 2021, los desarrolladores que usen versiones anteriores de la API podrán seguir llamando a los extremos del catálogo de productos con el permiso ads_management. Si usas la versión 8.0, deberás tener el permiso catalog_management.

Después de la fecha límite de febrero, el permiso catalog_management ya no estará asociado con ads_management, por lo que los usuarios tendrán que conceder de manera explícita el permiso catalog_management a la aplicación.

Autenticación

Se aplica a partir de la versión 8.0. Se aplicará a todas las versiones el 2 de noviembre de 2020.

[ACTUALIZACIÓN] Los siguientes extremos de la API de catálogo ahora cumplen con la configuración empresarial de la autenticación en dos pasos. Cualquier aplicación que llame a este extremo recibirá un error si la empresa que es propietaria del catálogo requiere la autenticación en dos pasos para el usuario actual de la aplicación y dicho usuario no se ha autenticado con este método.

Cuando el usuario actual de la aplicación accede al catálogo a través de una empresa asociada, se respetan los requisitos de autenticación de la instancia de Business Manager del socio. Los usuarios del sistema no tienen que realizar la autenticación en dos pasos.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

Informes

Retiradas

Se aplica a partir de la versión 8.0.

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

Segmentación

Retirada

Se aplica a partir de la versión 8.0.

• GET /search?type=adzipcode

Correcciones

• 28 de septiembre de 2020: se actualizó la entrada sobre la autenticación de la API de catálogo con fines de claridad.
• 23 de octubre de 2020: se actualizó la entrada sobre la API del catálogo:

  • Hemos ampliado el plazo durante el que los desarrolladores que usen versiones anteriores de la API podrán seguir llamando a los extremos del catálogo de productos con el permiso ads_management. La nueva fecha límite es el 28 de febrero de 2021.
  • Hemos añadido aclaraciones acerca de la autenticación de los usuarios del sistema.
• 17 de mayo de 2021: hemos cambiado el extremo retirado de GET /{place-id} a GET /{place-information-id}. GET /{place-id} no se ha retirado.