Autorización

Para acceder a los extremos de la API de marketing, tu aplicación debe borrar varias capas de autorización de la API Graph.

Capa 1: tipos de aplicaciones

Cuando crees una aplicación de Facebook, se te preguntará cómo se utilizará. La opción que elijas determinará el tipo de aplicación: Negocios, Juegos o Ninguno. Consulta Tipos de aplicaciones.

Para acceder a los extremos de la API de marketing, debes crear una aplicación empresarial. Consulta Productos disponibles para las aplicaciones empresariales.

Un vez registrada la aplicación, puedes asignar roles a cualquier persona que disponga de una cuenta de desarrollador y que vaya a ayudarte con el desarrollo.

Capa 2: niveles de acceso, permisos y funciones

Las aplicaciones empresariales están sujetas a un nivel de autorización adicional de la API Graph denominado de acceso. Durante la revisión de la aplicación, tu aplicación también debe solicitar funciones y permisos específicos.

Niveles de acceso de las funciones

Nivel de acceso de la función	Descripción
Acceso estándar	Las aplicaciones empresariales reciben automáticamente aprobación de acceso estándar para todos los permisos y funciones disponibles según su tipo. Utiliza esta opción si estás empezando. Puedes crear procesos de principio a fin antes de solicitar permisos completos. Puedes acceder a un número de cuentas publicitarias ilimitado. Es posible que algunas llamadas a la API no estén disponibles con acceso estándar al poder pertenecer a varias cuentas, o que la cuenta afectada no se pueda identificar mediante programación.
Acceso avanzado	El acceso avanzado debe aprobarse a través del proceso de revisión de la aplicación para cada permiso y función individualmente. Para solicitar acceso avanzado, dirígete al panel de la aplicación y haz clic en Revisión de la aplicación > Permisos y funciones. Busca la función o el permiso al que quieres acceder y, en Acción, haz clic en Solicitar acceso avanzado. Puedes seleccionar una o más funciones. Después de seleccionar las opciones, haz clic en Continuar con la solicitud y se mostrará una página que te guiará a través del proceso de envío. Después de enviar tus datos, Facebook aprobará o rechazará tu solicitud, y proporcionará información si tu aplicación no cumple los requisitos de este nivel de acceso estándar. Si recibes aprobación para el acceso avanzado, deberás completar los pasos siguientes para mantener el estado: Haber realizado correctamente al menos 1500 llamadas a la API de marketing en los últimos 15 días. Haber realizado llamadas a la API de marketing con una tasa de errores menor al 10 % en los últimos 15 días.

Nivel de acceso de la función

Descripción

Acceso estándar

Las aplicaciones empresariales reciben automáticamente aprobación de acceso estándar para todos los permisos y funciones disponibles según su tipo.

Utiliza esta opción si estás empezando. Puedes crear procesos de principio a fin antes de solicitar permisos completos. Puedes acceder a un número de cuentas publicitarias ilimitado.

Es posible que algunas llamadas a la API no estén disponibles con acceso estándar al poder pertenecer a varias cuentas, o que la cuenta afectada no se pueda identificar mediante programación.

Acceso avanzado

El acceso avanzado debe aprobarse a través del proceso de revisión de la aplicación para cada permiso y función individualmente.

Para solicitar acceso avanzado, dirígete al panel de la aplicación y haz clic en Revisión de la aplicación > Permisos y funciones.

Busca la función o el permiso al que quieres acceder y, en Acción, haz clic en Solicitar acceso avanzado. Puedes seleccionar una o más funciones. Después de seleccionar las opciones, haz clic en Continuar con la solicitud y se mostrará una página que te guiará a través del proceso de envío.

Después de enviar tus datos, Facebook aprobará o rechazará tu solicitud, y proporcionará información si tu aplicación no cumple los requisitos de este nivel de acceso estándar.

Si recibes aprobación para el acceso avanzado, deberás completar los pasos siguientes para mantener el estado:

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

Cada nivel presenta restricciones. Consulta Niveles de acceso y funciones. Todos los desarrolladores deben cumplir todas las Condiciones de la plataforma de Facebook y políticas para desarrolladores. Las llamadas de cualquier nivel de acceso se llevan a cabo según los datos de producción.

Para comprobar el nivel de acceso actual, dirígete a Panel de aplicaciones > Revisión de la aplicación > Permisos y funciones.

Asignación del acceso a la API de anuncios frente al acceso estándar a la administración de anuncios

Acceso a la API de marketing	Acceso estándar a la administración de anuncios	Acción
Acceso de desarrollo	Acceso estándar	De forma predeterminada
Acceso estándar	Acceso avanzado	Es necesario aplicarlo en el panel de aplicaciones

Permisos y funciones

Los permisos que debes solicitar cambian según la API a la que quieres acceder.

Si la aplicación solo administra tu cuenta publicitaria, el acceso estándar y los permisos ads_read y ads_management son suficientes. Si la aplicación administra las cuentas publicitarias de otras personas, necesitas los permisos ads_read o ads_management de acceso avanzado. Consulta todos los permisos disponibles para las aplicaciones empresariales.

Las funciones que debes solicitar cambian según el uso que pretendes dar a nuestras API. Si administras anuncios, una función común que debes solicitar es Ads Management Standard Access. Consulta todas las funciones disponibles para las aplicaciones empresariales.

Para obtener el acceso avanzado de la función de acceso estándar a la administración de anuncios, la aplicación tiene que cumplir los siguientes requisitos:

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

Si administras los anuncios de otra persona, utiliza el parámetro scope para solicitar a alguien los permisos ads_management o ads_read. Tu aplicación 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

Al introducir el valor del campo YOUR_URL, coloca una barra / al final. Ejemplo: http://www.facebook.com/

Ejemplos

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

Niveles de acceso y funciones

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

	Acceso estándar	Acceso avanzado
Límites de cuentas	Administra un número ilimitado de cuentas publicitarias. Los administradores o desarrolladores de aplicaciones pueden realizar llamadas a la API en nombre de los anunciantes o los administradores de las cuentas publicitarias.	Administra un número ilimitado de cuentas publicitarias, suponiendo que obtengas el permiso `ads_read` o `ads_management` de la cuenta publicitaria.
Límites de frecuencia	Limitación de frecuencia estricta por cuenta publicitaria. Solo para desarrollo. No se emplea en aplicaciones de producción operativas para anunciantes en activo.	Con una leve limitación de frecuencia según la cuenta publicitaria.
Business Manager	Acceso limitado a las API de Business Manager y del catálogo de productos. Sin acceso a Business Manager para administrar cuentas publicitarias, permisos de usuario y páginas.	Acceso a todas las API de Business Manager y del catálogo de productos.
Usuario del sistema	Puede crear un usuario del sistema y un usuario administrador del sistema.	Puede 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 frente al acceso estándar a la administración de anuncios

Los permisos y las funciones para aplicaciones presentan dos niveles de acceso diferentes: acceso estándar y acceso avanzado. Ten en cuenta que el uso del término “acceso estándar” aquí no está relacionado con la función de acceso estándar a la administración de anuncios. El acceso avanzado de la función de acceso estándar a la administración de anuncios aún requiere que una aplicación supere la revisión para poder acceder a la función.

Capa 3: verificación de la empresa

La verificación de la empresa es un proceso que nos permite verificar tu identidad como entidad comercial. Resulta necesario si tu aplicación va a tener acceso a datos confidenciales. Obtén más información sobre el proceso de verificación de la empresa.