Información general de la administración de activos

Una empresa puede acceder a numerosos activos. Tu empresa es la propietaria de los activos o accede a ellos como agencia. Usa las API de activos de administración de empresas de Facebook para añadir, eliminar o consultar la relación entre una empresa y sus activos, así como para administrar los activos comerciales y acceder a ellos.

Agencia hace referencia a un tipo de entidad empresarial que puede administrar o acceder a activos que son propiedad de otra empresa. Esta relación permite a la agencia realizar tareas o acciones concretas en nombre del cliente, como administrar cuentas publicitarias, páginas u otros activos digitales.

Grupos de activos comerciales

Los grupos de activos comerciales ayudan a los grandes anunciantes o agencias a administrar de forma eficaz los usuarios y los activos de su empresa. Debes organizar los activos y los usuarios de una forma que se corresponda con las operaciones del mundo real. Por ejemplo, una empresa puede estructurar sus activos y usuarios según la marca, la región, el cliente o un principio de organización de su elección.

Los grupos de activos comerciales pueden contener cuentas publicitarias, páginas, píxeles de Facebook, conjuntos de eventos offline, aplicaciones, catálogos, conversiones personalizadas y cuentas de Instagram. Los activos pueden ser propiedad de una empresa o compartirse para proporcionar acceso a una agencia.

Puedes usar esta API para añadir usuarios a un grupo de activos comerciales. Una vez añadidos, puedes otorgarles permisos para los activos de un grupo de activos comerciales. Esto te ayuda a otorgar acceso a varios activos a la vez, sin tener que crear demasiados administradores en el nivel de empresa.

Con esta API, puedes administrar grupos de activos comerciales que ya se han creado mediante Business Manager o puedes administrar activos en el grupo de activos comerciales. Puedes:

Obtener una lista de los grupos de activos comerciales asociados a una empresa.
Eliminar un grupo de activos comerciales o cambiarle el nombre.
Ver todos los activos de un grupo de activos comerciales.
Obtener, añadir, editar y eliminar permisos de usuarios para activos de un grupo de activos comerciales.
Asignar usuarios a un grupo de activos comerciales.
Obtener, añadir y eliminar activos de un grupo de activos comerciales.

Permisos

Para utilizar la API de grupos de activos comerciales, tu aplicación necesita el nivel de acceso a la API de marketing adecuado:

En el caso de todos los extremos de adición y eliminación, el usuario del identificador de acceso debe ser un administrador de la empresa. De lo contrario, se denegará el acceso.
En el caso de todos los extremos de la API, tu aplicación necesita el permiso business_management.

Necesitas permisos adicionales para:

Extremos de grupos de activos comerciales	Permisos necesarios
Obtener una lista de cuentas publicitarias	`ads_management`
Obtener una lista de catálogos de productos, añadir un catálogo de productos o eliminar un catálogo de productos	`ads_management`
Obtener una lista de cuentas de Instagram, añadir una cuenta de Instagram o eliminar una cuenta de Instagram	`ads_management` Si utilizas la versión 4.0 de la API de marketing, también necesitas `instagram_basic`.
Obtener una lista de píxeles	`ads_read`
Obtener una lista de conjuntos de eventos offline	`ads_management`
Obtener una lista de conversiones personalizadas	`ads_read`
Añadir una conversión personalizada	`ads_management`

Limitaciones

Se produce un error al intentar reducir o eliminar permisos de activos contenidos en grupos de activos comerciales mediante las siguientes llamadas a la API:

Solicitud DELETE a /{page_id}/assigned_users
Solicitud POST a /{page_id}/assigned_users
Solicitud DELETE a /act_{ad_account_id}/assigned_users
Solicitud POST a /act_{ad_account_id}/assigned_users.

Para reducir o eliminar los permisos, sigue estos pasos:

Realiza una llamada para obtener una lista de los grupos de activos asociados a una empresa. Busca grupos de activos en los que contained_asset_id sea igual a {page_id} o {ad_account_id}.
Para cada identificador de grupo de activos comerciales devuelto, realiza una llamada a la API para eliminar a un usuario de ese grupo.
A continuación, llama a las solicitudes DELETE o POST anteriores para eliminar el permiso de ese usuario en la página o la cuenta publicitaria.

Si proporcionas funciones de administración de permisos en la aplicación para otras empresas, debes utilizar esta API para evitar incoherencias y errores entre la API y Business Manager.

No se pueden establecer permisos en aplicaciones, catálogos, cuentas de Instagram ni conversiones personalizadas mediante el grupo de activos comerciales. En lugar de eso, debes asignar permisos en el nivel de activo.

Por ejemplo, si añades a Jorge a un grupo de activos comerciales en la cuenta de Business Manager de Lucas, puede obtener permisos para cualquier página, cuenta publicitaria, píxel, etc., de ese grupo de activos comerciales. Sin embargo, para eliminar o editar los permisos de Jorge para cualquier activo del grupo de activos comerciales de Lucas, debes realizar esta acción en el propio grupo de activos comerciales.

Puedes añadir permisos de usuarios en el nivel de activo con la API de activos, como convertir a un moderador de la página en administrador. Consulta ejemplos de página y cuenta publicitaria.

Los grupos de activos comerciales reemplazaron a la API de proyectos el 13 de octubre de 2019. Debes migrar todas las aplicaciones de la API de proyectos a grupos de activos comerciales.

Roles permitidos

Cuando se añade un usuario a un negocio, se puede asignar uno de los dos roles siguientes mediante las API de usuarios empresariales:

Constante de la API	Nombre	Descripción
`ADMIN`	Administrador de la empresa	Puede administrar todos los aspectos de la configuración de la empresa, incluidas la modificación o eliminación de la cuenta y la adición o eliminación de personas.
`EMPLOYEE`	Empleado de la empresa	Puede ver toda la información de la configuración de la empresa, pero no puede realizar cambios, excepto añadir a la empresa páginas o cuentas publicitarias de las que sea administrador.

Catálogos

Los siguientes roles pueden asignarse a cualquier usuario de la empresa, ya sea administrador o empleado, en catálogos accesibles para la empresa mediante las API de catálogos:

Constante de la API	Nombre	Descripción
`['MANAGE', 'ADVERTISE']`	Administrador del catálogo	Puede administrar todos los aspectos del catálogo con acceso completo de lectura y escritura, incluidas la creación, actualización y eliminación de artículos, la administración de listas, la asociación del catálogo a píxeles y aplicaciones, la creación de conjuntos de productos, la publicación de anuncios de catálogo de Advantage+ con el catálogo, el cambio de la configuraciones del catálogo, etc.
`['ADVERTISE']`	Anunciante del catálogo	Puede crear conjuntos de productos y publicar anuncios de catálogo de Advantage+ con el catálogo. No puede editar los productos, las listas ni la configuración del catálogo.

Cuentas publicitarias

Las siguientes tareas pueden asignarse a cualquier usuario de la empresa para cuentas publicitarias accesibles para la empresa mediante las API de cuentas publicitarias:

Constante de la API	Nombre	Descripción
`['MANAGE', 'ADVERTISE', 'ANALYZE']`	Administrador de la cuenta publicitaria	Puede administrar todos los aspectos de las campañas, informes, facturación y permisos de la cuenta, y puede establecer límites de gasto de la cuenta publicitaria. Los administradores de las cuentas publicitarias también pueden asociar métodos de pago empresariales.
`['ADVERTISE', 'ANALYZE']`	Anunciante en la cuenta publicitaria	Puede ver y editar los anuncios y configurar anuncios con el método de pago asociado a la cuenta publicitaria.
`['ANALYZE']`	Analista de la cuenta publicitaria	Puede ver el rendimiento de los anuncios.

Páginas

Puedes asignar las siguientes tareas a cualquier usuario de la empresa en páginas accesibles para la empresa mediante las API de páginas:

Constante de la API	Nombre	Descripción
`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Administrador de la página	Puede administrar los roles de la página, enviar mensajes y publicar en nombre de la página, crear anuncios y ver insights.
`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Editor de la página	Puede editar la página, enviar mensajes y publicar en nombre de la página, crear anuncios y ver insights.
`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Moderador de la página	Puede responder a comentarios en la página y eliminarlos, enviar mensajes en nombre de la página, crear anuncios y ver insights. No puede publicar en nombre de la página.
`['ADVERTISE', 'ANALYZE']`	Anunciante de la página	Puede crear anuncios para la página y ver insights. No puede publicar en nombre de la página.
`['ANALYZE']`	Analista de la página	Puede ver insights. No puede publicar en nombre de la página.

Aplicaciones

No hay API de administración de roles ni tareas para las aplicaciones en Business Manager.

Cuentas de Instagram

No hay administración de roles para las cuentas de Instagram en Business Manager. Los usuarios con acceso a cuentas publicitarias que están vinculadas a cuentas de Instagram pueden publicar anuncios para esas cuentas de Instagram.