Grupos de activos y usuarios

Administra tus grupos de activos comerciales y aprende a conectar a los usuarios de tu empresa con grupos de activos. 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.

Grupos de activos

Obtener una lista de grupos

Para obtener una lista de grupos de activos asociados a una empresa, envía una solicitud GET al extremo 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 los detalles de un grupo de activos comerciales específico, envía una solicitud GET al extremo 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 extremo BusinessAssetGroup y establece el nuevo valor en name.

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 un grupo

Para eliminar un grupo de activos específico, envía una solicitud DELETE al extremo 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

Campos públicos de un usuario que tiene un rol en la empresa que ha reclamado la aplicación.

Requisitos

• La función de acceso al perfil del usuario de los activos comerciales permite que las aplicaciones empresariales lean un pequeño conjunto de campos públicos de un usuario, siempre y cuando este haya interactuado con activos que sean propiedad de una empresa que haya reclamado la aplicación.

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

Obtener el acceso de un usuario a los grupos

Para ver una lista de todos los grupos de activos comerciales a los que puede acceder un usuario específico de una empresa, envía una solicitud GET al extremo 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

En la respuesta se incluyen los roles que definen los niveles de acceso que un usuario tiene por 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 los permisos de un usuario

Para leer una lista de usuarios asignados de un grupo de activos, envía una solicitud GET al extremo 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 extremo 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 extremo 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"