Crear, recuperar y actualizar un usuario del sistema

Crear

Utiliza el identificador de usuario administrador del sistema o tu propio identificador de acceso de usuario administrador para crear un usuario del sistema.

Nota: Solo se puede conceder un rol a un usuario del sistema en una aplicación si el usuario del sistema y la aplicación pertenecen a la misma empresa. Si la aplicación tiene que acceder a los datos con un usuario del sistema y un identificador de acceso que pertenecen a otra empresa, utiliza la API que permite actuar en nombre de otra empresa en su lugar.

A continuación se indican las solicitudes que necesitas para obtener un identificador de usuario del sistema y realizar llamadas a la API. Los tres primeros pasos son la configuración, que también se puede llevar a cabo en Business Manager. Al crear tu primer usuario del sistema, usas el identificador de acceso de un usuario real, que tiene el rol admin en la cuenta de Business Manager.

Crear un usuario administrador del sistema y generar un identificador

1. Crea un usuario administrador del sistema con tu propio identificador de acceso de usuario administrador.
2. Descarga la aplicación con el usuario administrador del sistema mediante el identificador de acceso del usuario administrador.
3. Genera el identificador de usuario administrador del sistema mediante el identificador de acceso del usuario administrador.

Crear un usuario del sistema

1. Crea un usuario del sistema mediante el identificador de acceso del usuario administrador.
2. También puedes crear un usuario del sistema mediante el identificador de acceso de un usuario administrador del sistema de tu cuenta de Business Manager, si has creado alguno.

Generar un identificador de acceso de usuario del sistema

1. Descarga la aplicación con el usuario del sistema mediante el identificador de acceso del usuario administrador, el usuario administrador del sistema u otro usuario del sistema.
2. Asigna permiso a los activos (como cuentas publicitarias o páginas) que pertenezcan a tu cuenta de Business Manager. Los permisos deben asignarse al usuario del sistema creado recientemente mediante el identificador de acceso del usuario administrador o el usuario administrador del sistema.
3. Genera el identificador de acceso de usuario del sistema mediante el identificador de acceso del usuario administrador o el usuario administrador del sistema.
4. Ahora, utiliza el identificador de acceso de usuario del sistema para realizar llamadas a la API en activos comerciales.

Para crear un usuario del sistema o un usuario administrador del sistema mediante la API, necesitas lo siguiente:

• Un identificador de acceso de un usuario administrador o un usuario administrador del sistema de esta cuenta de Business Manager.
• Rol: ADMIN o EMPLOYEE.
• Nombre: identificador de este usuario del sistema o 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"

Esto devuelve el valor de id específico de la aplicación del nuevo usuario del sistema:

{
  "id" : "100000008899900"
}

Se trata del identificador específico de la aplicación de un usuario del sistema. Debes utilizarlo para realizar llamadas a la API, en lugar del identificador canónico de Business Manager > System Users.

Recuperar

Para obtener la lista de los usuarios del sistema, necesitas un identificador de acceso de usuario administrador o usuario administrador del sistema. En la lista se incluyen los usuarios administradores del sistema y los correspondientes identificadores específicos de la aplicación.

Realiza una solicitud GET:

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

Esto devuelve una lista de todos los usuarios del sistema, incluidos los usuarios administradores del sistema, que pertenecen a una cuenta de Business Manager:

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

Actualizar

Puedes cambiar el nombre de un usuario del sistema o 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 identificadores de acceso

No puedes eliminar un usuario del sistema ni un usuario administrador del sistema, pero puedes invalidar todos los identificadores de acceso de dicho usuario. Para invalidar los identificadores, envía 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 realiza correctamente. A continuación, puedes generar nuevos identificadores de acceso para el usuario del sistema, como se ha indicado anteriormente.