Páginas

Las empresas pueden solicitar las páginas que les pertenecen. De esta forma, los administradores pueden asignar con facilidad personas a las páginas a las que deben tener acceso.

Solicitar páginas

Las empresas pueden solicitar la propiedad de las páginas que les pertenecen. Esto les permite administrar todos los aspectos de las páginas, incluida la eliminación de agencias u otras empresas a las que se les haya concedido acceso. Las empresas también pueden solicitar acceso de agencia a las páginas, lo que les permite poner anuncios en circulación en ellas mediante las cuentas publicitarias a las que tienen acceso.

Solicitar páginas como propietario

Si quieres solicitar una página para tu empresa como OWNER, necesitas el identificador de la página y el identificador de la empresa. A continuación, envía una solicitud POST:

El solicitante debe tener:

  • permiso de administrador en la página
  • permiso en la empresa propietaria; de lo contrario, el propietario de la empresa propietaria deberá aprobar la solicitud

Para realizar esta solicitud, debes usar el identificador de acceso de un usuario administrador o un usuario administrador del sistema de tu empresa. Si el usuario que realiza la llamada es un administrador, o MANAGER, de la página durante más de siete días, la página pertenece inmediatamente a la empresa. En la respuesta, Facebook devuelve el valor de access_status establecido en CONFIRMED. Si un usuario se convierte en administrador, o MANAGER, de la página en siete días o menos, no aprobamos automáticamente la solicitud de la API.

Si el usuario que realiza una llamada de solicitud como OWNER no tiene los permisos adecuados en la página, se produce un error en la llamada. A diferencia de la solicitud de una cuenta publicitaria, en este caso no se envía ninguna solicitud a los administradores de la página para su aprobación.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Solicitar páginas como agencia

Si quieres solicitar una página para tu empresa como AGENCY, necesitas el identificador de la página. A continuación, envía una solicitud POST:

Si el solicitante tiene permiso de administrador en la página, la solicitud se aprobará automáticamente. En caso contrario, el administrador de la página deberá aprobar la solicitud.

La agencia no puede volver a compartir la página con otra empresa.

La agencia puede comenzar a poner anuncios en circulación en la página (mediante las cuentas publicitarias a las que tiene acceso) de inmediato.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Si usas AGENCY:

  • Debes proporcionar permitted_tasks.
  • La página debe pertenecer a una empresa.
  • El identificador de acceso debe tener los permisos pages_manage_metadata y pages_show_list.

Si realizas una solicitud como AGENCY, pero no tienes los permisos de página adecuados, la respuesta es PENDING. El administrador de esa página puede iniciar sesión y otorgar el acceso, denegarlo o denunciar la solicitud como spam. Si una empresa tiene demasiadas solicitudes de acceso a la página denunciadas como spam, bloqueamos la cuenta de Business Manager.

Para ver todas las páginas de clientes a las has solicitado acceso pero aún no se ha aprobado, realiza esta llamada GET. Necesitas el identificador de acceso del usuario administrador del sistema:

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

Ver las páginas propiedad de una empresa o las páginas que pertenecen a los clientes de la empresa

Para ver todas las páginas que pertenecen a tu empresa, usa esta llamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Para ver todas las páginas de las que tu empresa es una agencia, utiliza esta llamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Esto devuelve una lista de las páginas que pertenecen a los clientes de una cuenta de Business Manager.

Añadir páginas de forma masiva

Puedes añadir páginas únicas a una cuenta de Business Manager con la IU de Business Manager. Para añadir páginas de forma masiva a una cuenta de Business Manager, realiza las siguientes llamadas POST:

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

Donde:

  • <ACCESS_TOKEN> es un identificador de acceso con el permiso business_management.
  • <BUSINESS_ID> es el identificador de la cuenta de Business Manager para la que se deben solicitar las páginas.
  • <PAGE_ID_n> son los identificadores de las páginas que se van a solicitar.

Eliminar páginas

Para eliminar una página de la empresa, realiza esta llamada DELETE:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Añadir personas a las páginas

Cuando tu empresa tenga una página, podrás asignar tareas a las personas. Entre las tareas se incluyen las siguientes:

Nombre Constante de la API Descripción

Administrador

['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

Puede administrar los roles de administrador, enviar mensajes y publicar en nombre de la página, crear anuncios y ver informes.

Editor

['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']

Puede editar la página, enviar mensajes y publicar en nombre de la página, crear anuncios y ver informes.

Moderador

['MODERATE', 'ADVERTISE', 'ANALYZE']

Puede responder a comentarios en la página y eliminarlos, enviar mensajes en nombre de la página, crear anuncios y ver informes.

Anunciante

['ADVERTISE', 'ANALYZE']

Puede crear anuncios para la página y ver insights.

Analista

['ANALYZE']

Puede ver informes.

Necesitas lo siguiente:

  • page_id: identificador de la página.
  • user_id: identificador de usuario que añadir.
  • Tareas que asignar.

Realiza esta llamada POST para añadir a alguien con las tareas ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']:

El identificador de la empresa debe ser el identificador de la empresa propietaria de la página.

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Cambiar el acceso a las páginas

Para cambiar las tareas de un usuario existente, utiliza la misma llamada POST que realizas al añadir un nuevo usuario con tareas:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Ver los permisos de la página

Para ver las páginas con permisos de usuario, realiza esta llamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

Para ver los permisos específicos de una página, realiza esta llamada GET:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

Eliminar el acceso a la página

Para poder eliminar una página de Business Manager, también debes eliminar a los administradores de dicha página de tu empresa.

Para eliminar el acceso de alguien a una página de tu propiedad, necesitas lo siguiente:

  • page_id: identificador de la página.
  • user_id: identificador del usuario que eliminar.

La llamada DELETE es:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"