Autorización

Para acceder a los puntos de conexión de la API de marketing, la app debe cumplir varias capas de autorización de la API Graph.

Capa 1: Tipos de app

Cuando creas una app de Facebook, se te pregunta qué uso se le va a dar. Según lo que elijas, tu app será de alguno de los siguientes tipos: negocios, videojuegos o ninguno. Consulta Tipos de apps.

Para acceder a los puntos de conexión de la API de marketing, debes crear una app de negocios. Consulta Productos disponibles para apps de negocios.

Una vez que registres tu app, puedes asignar roles a cualquier persona que tenga una cuenta de desarrollador, quien te ayudará con el desarrollo.

Capa 2: Niveles de acceso, permisos y funciones

Las apps de negocios están sujetas a una capa adicional de autorización de la API Graph, denominada niveles de acceso. Durante la revisión de apps, tu app debe solicitar también permisos y funciones específicas.

Niveles de acceso a funciones

Nivel de acceso a funciones	Descripción
Acceso estándar	En las apps de negocios, el acceso estándar aprueba automáticamente todos los permisos y las funciones disponibles para el tipo de app de negocios. Usa esta opción si estás empezando. Puedes construir flujos de trabajo de extremo a extremo antes de solicitar todos los permisos. Puedes acceder a un número ilimitado de cuentas de publicidad. Es posible que algunas llamadas a la API no estén disponibles con el acceso estándar si están asociadas a varias cuentas o si la cuenta afectada no se puede identificar mediante programación.
Acceso avanzado	El acceso avanzado se debe aprobar mediante el proceso de revisión de apps de manera individual para cada permiso y función. Para solicitar el acceso avanzado, ve al panel de control de tu app y haz clic en Revisión de la app > Permisos y funciones. Encuentra el permiso o la función a los que quieras acceder y, en Acción, haz clic en Solicitar acceso avanzado. Puedes seleccionar una o más funciones. Una vez que selecciones las opciones, haz clic en Continuar la solicitud y accederás a una pantalla que te guiará a través del proceso de solicitud. Una vez que envías la solicitud, Facebook responde con una aprobación o una denegación y la información correspondiente si tu app no cumple con los requisitos para el acceso estándar. Si recibes la aprobación para el acceso avanzado, debes realizar lo siguiente para mantener tu estado: Haber realizado al menos 1.500 llamadas correctas a la API de marketing en los últimos 15 días. Haber realizado llamadas a la API de marketing con una tasa de errores inferior al 10% en los últimos 15 días.

Nivel de acceso a funciones

Descripción

Acceso estándar

En las apps de negocios, el acceso estándar aprueba automáticamente todos los permisos y las funciones disponibles para el tipo de app de negocios.

Usa esta opción si estás empezando. Puedes construir flujos de trabajo de extremo a extremo antes de solicitar todos los permisos. Puedes acceder a un número ilimitado de cuentas de publicidad.

Es posible que algunas llamadas a la API no estén disponibles con el acceso estándar si están asociadas a varias cuentas o si la cuenta afectada no se puede identificar mediante programación.

Acceso avanzado

El acceso avanzado se debe aprobar mediante el proceso de revisión de apps de manera individual para cada permiso y función.

Para solicitar el acceso avanzado, ve al panel de control de tu app y haz clic en Revisión de la app > Permisos y funciones.

Encuentra el permiso o la función a los que quieras acceder y, en Acción, haz clic en Solicitar acceso avanzado. Puedes seleccionar una o más funciones. Una vez que selecciones las opciones, haz clic en Continuar la solicitud y accederás a una pantalla que te guiará a través del proceso de solicitud.

Una vez que envías la solicitud, Facebook responde con una aprobación o una denegación y la información correspondiente si tu app no cumple con los requisitos para el acceso estándar.

Si recibes la aprobación para el acceso avanzado, debes realizar lo siguiente para mantener tu estado:

Haber realizado al menos 1.500 llamadas correctas a la API de marketing en los últimos 15 días.
Haber realizado llamadas a la API de marketing con una tasa de errores inferior al 10% en los últimos 15 días.

Cada nivel tiene restricciones. Consulta Niveles de acceso y funciones. Todos los desarrolladores también deben cumplir las Condiciones de la plataforma de Facebook y las Políticas para desarrolladores. Las llamadas en TODOS los niveles de acceso se hacen con los datos de producción.

Para comprobar tu nivel de acceso actual, ve a Panel de apps > Revisión de la app > Mis permisos y funciones.

Asignación de acceso a la API de anuncios vs. acceso estándar a la administración de anuncios

Acceso a la API de marketing	Acceso estándar a administración de anuncios	Acción
Acceso de desarrollo	Acceso estándar	Predeterminado
Acceso estándar	Acceso avanzado	Requiere solicitud en el panel de apps

Permisos y funciones

Los permisos que debes solicitar cambian en función de la API a la que quieras acceder.

Si lo único que tu app hace es administrar tu cuenta publicitaria, el acceso estándar y los permisos ads_read y ads_management son suficientes. Si tu app está administrando las cuentas publicitarias de otras personas, necesitarás los permisos ads_read y/o ads_management del acceso avanzado. Consulta todos los permisos disponibles para apps de negocios.

Las funciones que debes solicitar cambian en función de cómo quieres usar nuestras API. Si estás administrando anuncios, una característica común que debes solicitar es Ads Management Standard Access. Consulta todas las funciones disponibles para apps de negocios.

Con el fin de obtener acceso avanzado del acceso estándar a la administración de anuncios, es necesario que tu app cumpla con los requisitos:

Haber realizado al menos 1.500 llamadas correctas a la API de marketing en los últimos 15 días.
Haber realizado llamadas a la API de marketing con una tasa de errores inferior al 10% en los últimos 15 días.

Si administras los anuncios de otra persona, usa el parámetro scope para solicitar a alguien los permisos ads_management o ads_read. Tu app obtiene acceso cuando alguien hace clic en Permitir:

https://www.facebook.com/v21.0/dialog/oauth?
  client_id=<YOUR_APP_ID>
  &redirect_uri=<YOUR_URL>
  &scope=ads_management

Cuando ingreses el campo YOUR_URL, agrega / antes y después. Ejemplo: http://www.facebook.com/

Ejemplos

Caso de uso	Qué solicitar
Quieres leer y administrar los anuncios de tus cuentas publicitarias o de aquellas a las que el propietario de la cuenta te ha otorgado acceso.	Permiso: `ads_management` Función: `Ads Management Standard Access`
Quieres leer los reportes de los anuncios de tus cuentas publicitarias o de aquellas a las que el propietario de la cuenta te ha otorgado acceso.	Permiso: `ads_read` Función: `Ads Management Standard Access`
Quieres extraer los reportes de los anuncios de un grupo de clientes, y leer y gestionar los anuncios de otro grupo.	Permisos: `ads_management` y `ads_read` Función: `Ads Management Standard Access`

Niveles de acceso y funciones

En la siguiente tabla, se muestra cómo los niveles de acceso estándar y avanzado influyen en la función Acceso estándar a la administración de anuncios.

	Acceso estándar	Acceso avanzado
Límites de cuentas	Administra una cantidad ilimitada de cuentas publicitarias. Los administradores o desarrolladores de la app pueden hacer llamadas a la API en nombre de administradores de cuentas publicitarias o de anunciantes.	Administra una cantidad ilimitada de cuentas publicitarias, suponiendo que tienes el permiso `ads_read` o `ads_management` de la cuenta publicitaria.
Límites de frecuencia	Límite restrictivo por cada cuenta publicitaria. Solo para desarrollo. No adecuado en apps de producción ejecutadas para anunciantes que usan anuncios en vivo.	Límite laxo por cuenta publicitaria.
Administrador comercial	Acceso limitado al administrador comercial y a las API de catálogos de productos. Sin acceso al administrador comercial para la gestión de cuentas publicitarias, permisos de usuarios y páginas.	Acceso total al administrador comercial y a las API de catálogos de productos.
Usuario del sistema	Se puede crear un usuario del sistema y un usuario administrador del sistema.	Se pueden crear diez usuarios del sistema y un usuario administrador del sistema.
Creación de páginas	No se pueden crear páginas mediante la API.	No se pueden crear páginas mediante la API.

Niveles de acceso vs. Acceso estándar a administración de anuncios

Los permisos y las funciones de las apps tienen dos niveles de acceso diferentes: acceso estándar y acceso avanzado. Ten en cuenta que el uso que se le da aquí al término "acceso estándar" no está asociado a la función de acceso estándar del administrador de anuncios. Para obtener el acceso avanzado del acceso estándar a la administración de anuncios, es necesario, de todos modos, que la app se someta a revisión, con el fin de obtener la función.

Capa 3: Verificación del negocio

La verificación del negocio es un proceso que nos permite verificar la identidad de tu negocio; esto es obligatorio si tu app va a tener acceso a datos confidenciales. Más información acerca del proceso de Verificación del negocio.