Crear, recuperar y actualizar un usuario del sistema

Crear

Usa tu token de usuario administrador del sistema o el token de acceso de tu propio usuario administrador para crear un usuario del sistema.

Nota: A un usuario del sistema solo se le puede otorgar un rol en una app si tanto el usuario del sistema como la app pertenecen al mismo negocio. Si tu app necesita acceder a datos por medio de un usuario del sistema y un token de acceso perteneciente a otro negocio, usa la API de negocio "En nombre de" en su lugar.

Aquí están las solicitudes que necesitas para obtener un token de usuario del sistema y hacer llamadas a la API. La configuración de los primeros tres pasos también la puedes hacer en el administrador comercial. Cuando creas tu primer usuario de sistema, usas el token de acceso de un usuario real, que es admin del administrador de negocios.

Crear un usuario administrador del sistema y generar un token

1. Crea un usuario administrador del sistema con tu propio token de acceso de usuario administrador.
2. Instala la app con el usuario administrador del sistema usando el token de acceso del usuario administrador.
3. Genera el token de usuario administrador del sistema con el token de acceso del usuario administrador.

Crear un usuario del sistema

1. Crea un usuario del sistema con el token de acceso del usuario administrador.
2. O bien crea un usuario del sistema usando el token de acceso de un usuario administrador del sistema de tu administrador de negocios, si has creado uno.

Generar un token de acceso del usuario del sistema

1. Instala la app con el usuario del sistema usando el token de acceso del usuario administrador, usuario administrador del sistema u otro usuario del sistema.
2. Asigna permiso para acceder a los recursos (como cuentas publicitarias, páginas) que pertenecen a tu administrador comercial. Los permisos deben asignarse al usuario del sistema recién creado usando el token de acceso del usuario administrador o del usuario administrador del sistema.
3. Genera el token de acceso del usuario del sistema con el token del acceso del usuario administrador o del usuario administrador del sistema.
4. Ahora, usa el token de acceso del usuario del sistema para hacer llamadas a la API en los activos comerciales.

Para crear un usuario del sistema o un usuario administrador del sistema a través de la API, necesitas lo siguiente:

• Un token de acceso de un usuario administrador o de un usuario administrador del sistema de este administrador comercial.
• Rol: ADMIN o EMPLOYEE.
• Nombre: identificador de este usuario del sistema o del usuario administrador del sistema.

Para crear un usuario del sistema, realiza una solicitud POST:

curl \
-F "name=Ad Server" \
-F "role=EMPLOYEE" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

La solicitud devuelve el id específico de la app del nuevo usuario del sistema:

{
  "id" : "100000008899900"
}

Se trata del identificador de la app de un usuario del sistema. Deberás usar este identificador para hacer llamadas a la API, pero no el identificador canónico en Business Manager > System Users.

Recuperar

Para obtener la lista de usuarios del sistema, necesitas un token de acceso del usuario administrador o del usuario administrador del sistema. La lista incluye a los usuarios administradores del sistema y sus identificadores específicos de la app.

Haz una solicitud GET:

curl "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users?access_token=<ACCESS_TOKEN>>"

Esta solicitud devuelve una lista de todos los usuarios del sistema, incluso de los usuarios administradores del sistema, que son propiedad de un administrador comercial:

{
  "data": [
    {
      "id": "1000081799813",
      "name": "Reporting server"
      "role": "ADMIN",
    }, 
  ]
}

Actualizar

Puedes cambiar el nombre de un usuario del sistema o de un usuario administrador del sistema:

curl \
-F "system_user_id=<APP_SCOPED_SYSTEM_USER_ID>" \
-F "name=FBX Server" \
-F "access_token=<ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/system_users"

Invalidar tokens de acceso

No se puede borrar un usuario del sistema ni un usuario administrador del sistema, pero sí es posible invalidar todos los tokens de acceso para dicho usuario. Es posible invalidar tokens enviando una solicitud DELETE a:

https://graph.facebook.com/<API_VERSION>/<APP_SCOPED_SYSTEM_USER_ID>/access_tokens

La respuesta devuelve true si la llamada se realizó correctamente. Luego, puedes generar nuevos tokens de acceso para el usuario del sistema, como se indico con anterioridad.