Versión 8.0

API Graph

Lanzamiento: 4 de agosto de 2020 | Disponible hasta: 1 de noviembre de 2022 | publicación de blog

Tokens de acceso

Puntos de conexión obsoletos

Baja a partir de la versión 8.0. Baja en todas las versiones a partir del 2 de noviembre de 2020.

• GET /token_deprecation_check

Álbumes

Puntos de conexión restablecidos

Se aplica a todas las versiones.

• GET /{album-id}/likes

Configuración de apps

Tipos de apps

Este cambio se aplica a todas las versiones.

Las apps recién creadas ahora pueden elegir un tipo de app: Negocios, Videojuegos o Ninguno. Esto simplifica la interfaz de revisión de apps, ya que elimina los permisos y funciones inadecuados según el tipo elegido. Además, las apps de negocios usan un nuevo mecanismo de autorización, ya no utilizan modos y tienen acceso a una nueva función. Consulta Entrada de registro de cambios de apps de negocios para obtener más información.

Apps de negocios

Las apps de negocios usan un nuevo mecanismo de autorización denominado niveles de acceso. Los niveles de acceso reemplazan la funcionalidad proporcionada por el modo de desarrollo y el modo en vivo, que se eliminaron de las apps de negocios. Estos niveles simplifican el proceso de revisión y lo hacen más intuitivo. Además, se presentó una nueva función de acceso a perfiles de usuarios de activos comerciales, que permite a las apps de negocios leer un pequeño conjunto de campos de usuario públicos. A continuación, se describen estos cambios en detalle.

Niveles de acceso

Se aplica a todas las versiones.

Los niveles de acceso son un mecanismo de autorización de la API Graph para apps de negocios que se aplican a permisos y funciones de forma individual. El acceso estándar solo permite el acceso a los datos que pertenecen a los usuarios que tienen un rol en la app o un rol en un negocio que solicitó la app. El acceso avanzado permite el acceso a los datos que pertenecen a cualquier usuario de la app, pero requiere la revisión de la aplicación. Las apps de negocios tienen acceso de forma automática a todos los permisos y funciones disponibles para su tipo.

Eliminación del modo activo y de desarrollo

Se aplica a todas las versiones.

El modo de desarrollo y el modo activo se eliminaron de las apps de negocios. Estos modos se reemplazaron por niveles de acceso, que brindan la misma funcionalidad y más versatilidad, ya que las apps de negocios tienen acceso estándar para todos los permisos y funciones disponibles. Cualquier usuario con un rol en la app o un rol en un negocio que solicitó la app, puede otorgar a la app cualquier permiso disponible en cualquier momento. Esto elimina la necesidad de revisión de la app o de tener que cambiar de un modo a otro durante el desarrollo.

Nueva función de acceso a perfiles de usuarios de activos comerciales

Se aplica a todas las versiones.

La nueva función de acceso de perfil de usuario de activos comerciales permite a las apps de negocios leer un pequeño conjunto de campos públicos de un usuario, siempre que el usuario haya interactuado con activos de un negocio que solicitó la app. Consulta la referencia del acceso al perfil del usuario de activos comerciales para obtener una lista de los campos de usuario que se pueden leer.

Comentarios

Puntos de conexión restablecidos

Se aplica a todas las versiones.

• GET /{comment-id}/likes

Dispositivos

Puntos de conexión obsoletos

Baja a partir de la versión 8.0. Baja en todas las versiones a partir del 2 de noviembre de 2020.

• POST /device/share

Grupos

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

• GET /{group-id}/posts

Baja a partir de la versión 8.0. Baja en todas las versiones a partir del 2 de noviembre de 2020.

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

Instagram

Nuevo punto de conexión oEmbed de Instagram

Se aplica a todas las versiones.

Se presentó un nuevo punto de conexión GET /instagram_oembed. Proporciona la misma funcionalidad que los puntos de conexión de oEmbed heredados, que quedarán obsoletos a partir del 24 de octubre de 2020. El nuevo punto de conexión requiere un token de acceso. Por lo tanto, necesitarás una cuenta de desarrollador de Facebook y una app registrada para acceder. Consulta el documento de oEmbed de Instagram para conocer las instrucciones de uso y detalles adicionales.

Acontecimientos importantes

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

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

Enlaces

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

• GET /{link-id}/reactions

Videos en vivo

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

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

Usa el punto de conexión GET /{live-video-id}/reactions para obtener "Me gusta" en un video en vivo.

Parámetro save_vod

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

El parámetro type quedó obsoleto en los siguientes perímetros:

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

Plataforma de Messenger

Puntos de conexión obsoletos

Baja 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 apps

Se aplica a todas las versiones.

Se movió la revisión de apps para Messenger de Productos > Messenger > Configuración a Revisión de la app en el panel de apps. Para solicitar permisos específicos de Messenger, pages_messaging, pages_user_gender, pages_user_locale y pages_user_timezone, acceda a Revisión de la app > Permisos y funciones. Consulta la documentación de revisión de apps de Messenger para obtener más información.

Perímetro del perfil de Messenger

Se aplica a partir de la versión 8.0.

El tipo de menú anidado persistente queda obsoleto para POST /{page-id}/messenger_profile.

Nueva función: Messenger para tiendas

Se aplica a partir de la versión 8.0.

Compatibilidad para enviar y recibir productos en Messenger para tiendas. Esto incluye la plantilla de productos, que se puede usar para enviar productos en mensajes, Webhooks para mensajes con plantillas de productos y mensajes desde la página de detalles de productos de la tienda de Facebook, y Webhooks con eco para mensajes con productos.

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

Ofertas nativas

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

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

Open Graph

Puntos de conexión obsoletos

Baja a partir de la versión 8.0. Baja en 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

Puntos de conexión obsoletos

Baja 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

Baja en todas las versiones.

El formato de identificador de comentarios de publicación de la página, {page-id}_{post_id}_{comment-id}, quedó obsoleto. En su lugar, usa el formato {pagepost-id}_{comment-id}.

Fotos

Puntos de conexión obsoletos

Baja en todas las versiones.

• GET /{photo-id}/sharedposts

Lugares

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

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

Publicaciones

Puntos de conexión obsoletos

Baja a partir de la versión 8.0. Baja en todas las versiones a partir del 2 de noviembre de 2020.

• GET /{post-id}/likes

Usa el punto de conexión GET /post/reactions para obtener "Me gusta" en una publicación.

Búsqueda

Puntos de conexión obsoletos

Baja a partir de la versión 8.0. Baja en todas las versiones a partir del 2 de noviembre de 2020.

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

Configuración de seguridad

Campos obsoletos

Baja a partir de la versión 8.0. Baja en todas las versiones a partir de noviembre de 2020.

• secure_browsing

Plugins sociales

Puntos de conexión oEmbed de Facebook

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

Los puntos de conexión oEmbed de Facebook, que permiten a las apps obtener HTML insertado para publicaciones y videos de Facebook, quedará obsoleto el 24 de octubre de 2020. Se presentaron tres nuevos puntos de conexión que ofrecen la misma funcionalidad que los puntos de conexión anteriores que reemplazan:

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

Los nuevos puntos de conexión requieren un token de acceso y las solicitudes estarán sujetas a limitaciones de frecuencia. Consulta la nueva documentación del punto de conexión oEmbed de Facebook para obtener los detalles de uso e información adicional.

Usuarios

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

• GET /{user-id}/taggable_friends

Campos obsoletos

Baja a partir de la versión 8.0. Baja en todas las versiones a partir de noviembre de 2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Baja en 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 para el acceso a los datos después de 90 días de inactividad:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

Foto del usuario

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

A partir del 24 de octubre de 2020, el punto de conexión GET /{user-id}/picture (GET /{user-id}?fields=picture) requerirá un identificador de usuario específico de la app (ASID) para las solicitudes sin token. Si envías una consulta al usuario con un identificador que no es un ASID, deberás incluir un token de acceso de app, cliente o usuario en la solicitud. Consulta la referencia de la foto del usuario para obtener más información.

Preguntas sobre videos

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

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

Workplace

Puntos de conexión obsoletos

Baja a partir de la versión 8.0. Baja en todas las versiones a partir del 2 de noviembre de 2020.

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

API de marketing

Lanzamiento: 4 de agosto de 2020 | Disponible hasta: 4 de mayo de 2021 | publicación de blog

Cuentas publicitarias

Puntos de conexión obsoletos

Baja 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 implementará en todas las versiones el 2 de noviembre de 2020.

Las apps necesitan permisos detallados para acceder a los campos de negocio de una cuenta publicitaria. Se deben otorgar permisos para un objeto de negocio específico.

Reglas de personalización de activos

Validación

Se aplica a partir de la versión 8.0.

Todos los anuncios que usan asset_feed_spec deben contener al menos dos reglas de personalización de objetivo. Si tu contenido usa asset_feed_specy contiene menos de dos reglas, no podrás crear el anuncio.

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

Personalización de activos de segmentos

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

Todos los casos de uso no relacionados con la geolocalización quedaron obsoletos para usuarios de personalización de activos de segmentos. Con este cambio, todas las reglas de segmentación deben contener información de geolocalización dentro de su especificación de personalización. Existe una excepción a la regla predeterminada que no requiere incluir la geolocalización.

Pujas

Estrategia de puja de costo objetivo

Se aplica a partir de la versión 8.0.

La estrategia de puja de TARGET_COST quedó obsoleta. Para continuar con el control de los costos, recomendamos usar la puja Límite de costo. Consulta todas las estrategias de puja disponibles.

Administrador comercial

Puntos de conexión obsoletos

Baja a partir de la versión 8.0.

• GET{system-user-id}/updated_by

Puntos de conexión de acuerdos de uso compartido incorporados de nuevo

Se aplica a todas las versiones.

Se incorporaron de nuevo los siguientes puntos de conexión:

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

Ambos puntos de conexión habían quedado obsoletos con el lanzamiento de la API Graph 6.0.

Canvas

Puntos de conexión obsoletos

.

• /{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 implementará en todas las versiones a partir del 31 de enero de 2021.

Ya no necesitarás el permiso ads_management para acceder a los puntos de conexión del catálogo de productos. De ahora en más, necesitarás el permiso catalog_management para llamar a esos puntos de conexión. Los desarrolladores que tuvieron acceso a los puntos de conexión del catálogo mediante ads_management en los últimos 90 días, se migrarán automáticamente a los permisos catalog_management a partir del 14 de agosto de 2020.

Desde ahora hasta el 28 de febrero de 2021, los desarrolladores que utilizan versiones anteriores de la API aún pueden llamar a los puntos finales del catálogo de productos con el permiso ads_management. Si estás usando la versión 8.0, debes 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, de modo que los usuarios deberán conceder el permiso catalog_management de forma explícita para la app.

Autenticación

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

[ACTUALIZADO] Los siguientes puntos de conexión de la API del catálogo ahora respetan la configuración de empresa de la autenticación en dos pasos. Cualquier app que llame a este punto de conexión recibirá un error si el negocio propietario del catálogo requiere autenticación en dos pasos para el usuario actual de la app y el usuario no la usó.

Cuando el usuario actual de la app tiene acceso al catálogo a través del negocio de un socio, respetamos los requisitos de autenticación del administrador comercial del socio. Los usuarios del sistema no tienen que usar 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

Elementos obsoletos

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

Elemento obsoleto

Se aplica a partir de la versión 8.0.

• GET /search?type=adzipcode

Correcciones

• 28 de septiembre de 2020: se actualizó la entrada de autenticación de la API de catálogo para una mayor claridad.
• 23 de octubre de 2020: se actualizó la entrada de API de catálogo:

  • Ampliamos la fecha límite para que los desarrolladores que usan versiones anteriores de la API puedan llamar a puntos de conexión de catálogos de productos con el permiso ads_management. La nueva fecha límite es el 28 de febrero de 2021.
  • Agregamos una aclaración acerca de la autenticación de usuarios del sistema.
• 17 de mayo de 2021: se cambió el punto de conexión obsoleto de GET /{place-id} a GET /{place-information-id}. GET /{place-id} no quedó obsoleto.