Usuarios y grupos de activos

Administra los grupos de activos de tu negocio y obtén información sobre cómo conectar los usuarios del negocio a los grupos de activos. Los grupos de activos comerciales ayudan a los grandes anunciantes o agencias a administrar de manera eficiente los usuarios y activos en sus negocios. Debes organizarlos de una manera que se ajuste a 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 organizador de su elección.

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

Grupos de activos

Obtener una lista de grupos

Para obtener una lista de todos los grupos de activos asociados con el negocio, envía una solicitud GET al punto de conexión BusinessBusinessAssetGroups.

Ejemplo de solicitud

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/business_asset_groups
    ?access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Northern Region"
    },
    {
      "id": "BUSINESS-ID",
      "name": "Western Region"
    }
  ],
....
}

Obtener un grupo específico

Para obtener detalles sobre un grupo de activos comerciales específicos, envía una solicitud GET al punto de conexión BusinessAssetGroup.

Ejemplo de solicitud

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

{
  "id": "BUSINESS-ASSET-GROUP-ID", "name": "BUSINESS-ASSET-GROUP-NAME"
}

Cambiar el nombre de un grupo

Para cambiar el nombre de un grupo de activos específico, envía una solicitud POST al punto de conexión BusinessAssetGroup y configura name en el nuevo valor.

Ejemplo de solicitud

curl -i -X POST 
 "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
   ?name=BUSINESS-ASSET-GROUP-NAME
   &access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

"success":  "true"

Eliminar grupo

Para eliminar un grupo de activos específico, envía una solicitud DELETE al punto de conexión BusinessAssetGroup.

Ejemplo de solicitud

curl -i -X DELETE 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>
    ?access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

"success":  "true"

Usuarios

Los campos de usuario público de un usuario que tiene un rol en el negocio y que solicitó la app.

Requisitos

• La función de acceso de perfil de usuario de activos comerciales permite a las apps de negocios leer un pequeño conjunto de campos públicos de un usuario, siempre que el usuario haya interactuado con activos de un negocio que solicitó la app.

Consulta la referencia del acceso al perfil del usuario de activos comerciales para obtener una lista de los campos de usuario que se pueden leer.

Obtener acceso del usuario a grupos

Para ver una lista de todos los grupo de activos comerciales a los que puede acceder un usuario perteneciente al ámbito del negocio, envía una solicitud GET al punto de conexión BusinessScopedUser/AssignedBusinessAssetGroups.

Ejemplo de solicitud

curl -i -X GET 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_business_asset_groups
    ?limit=1
    &access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

La respuesta incluye roles que definen los niveles de acceso que un usuario tiene en función del tipo de activo:

{
  "data": [
    {
      "id": "BUSINESS-ID" 
      "name": "USER NAME",      
      "page_roles": [ "ANALYZE", "ADVERTISE" ],
      "offline_conversion_data_set_roles": ["UPLOAD"],
      "adaccount_roles": ["ANALYZE", "ADVERTISE"],      
      "pixel_roles": ["ANALYZE", "EDIT"]    
    }  
    ],
        ....
}

Obtener permisos del usuario

Para leer una lista de usuarios asignados a un grupo de activos, envía una solicitud GET al punto de conexión BusinessAssetGroupAssignedUsers.

Ejemplo de solicitud

curl -i -X GET
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?limit=2
    &business=<BUSINESS_ID>
    &access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

{
  "data": [
    {
      "id": "BUSINESS-ID",
      "name": "Dabney Donigan",
      "page_roles": [ "ANALYZE" ],  
      "offline_conversion_data_set_roles": [ "ADVERTISE", "UPLOAD", "MANAGE" ],
      "adaccount_roles": [ "ANALYZE" ],
      "pixel_roles": [ "ANALYZE", "EDIT" ]
      }
      ],
   ....
}

Asignar un usuario a un grupo de activos

Para asignar usuarios a un grupo de activos comerciales, envía una solicitud POST al punto de conexión BusinessAssetGroupAssignedUsers.

Ejemplo de solicitud

curl -i -X POST 
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=USER-ID 
    &page_roles=LIST-OF-PAGE-ROLES
    &adaccount_roles=LIST-OF-AD-ACCOUNT-ROLES
    &pixel_roles=LIST-OF-PIXEL-ROLES
    &offline_conversion_data_set_roles=LIST-OF-OFFLINE-CONVERSION-ROLES
    &access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

"success":  "true"

Eliminar un usuario de un grupo de activos

Para eliminar un usuario de un grupo, envía una solicitud POST al punto de conexión BusinessAssetGroup.

Ejemplo de solicitud

curl -i -X DELETE \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ASSET_GROUP_ID>/assigned_users
    ?business=<BUSINESS_ID>
    &user=<USER_ID>
    &access_token=<ACCESS_TOKEN>"

Ejemplo de respuesta

"success":  "true"