API Graph versión

Grupo

Un grupo de Facebook.

Leer

Devuelve información sobre un único objeto de grupo. Para obtener una lista con los grupos que administra un usuario, usa el perímetro /user/groups en su lugar.

Explorador de la API Graph
GET /v21.0/{group-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{group-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permisos

  • groups_access_member_info: permite que la app reciba datos relacionados con un miembro en el contenido del grupo.
  • publish_to_groups: permite que la app publique contenido en un grupo en nombre de un usuario.

Para grupos públicos y cerrados

Un token de acceso de usuario.

Para los grupos secretos

Token de acceso del usuario para un administrador del grupo.

Advertencias

  • Las respuestas no incluirán los campos que devuelven información del usuario, a menos que la solicitud se realice con el token de acceso de un administrador del grupo.

Campos

Nombre de la propiedad Descripción Tipo

id

El identificador del grupo.

string

cover

Información sobre la foto de portada del grupo.

CoverPhoto

id

El identificador de la foto que representa esta foto de portada.

string

source

La URL de la foto que representa esta foto de portada.

string

offset_y

El desplazamiento vertical, en píxeles, de la foto desde la parte inferior.

int

offset_x

El desplazamiento horizontal, en píxeles, de la foto desde la izquierda.

int

description

Una breve descripción del grupo.

string

email

La dirección de correo electrónico que se usa para subir contenido al grupo. Solo los miembros actuales del grupo pueden usarla.

string

icon

La URL del icono del grupo.

string

member_count

El número de miembros del grupo.

int

member_request_count

El número de solicitudes de miembros pendientes. Requiere un token de acceso de un administrador del grupo. El recuento se devuelve únicamente cuando el número solicitudes de miembros pendientes es mayor que 50.

int

name

El nombre del grupo.

string

owner

Obsoleto a partir de la versión 9.0. Quedará obsoleto en todas las versiones a partir del 9 de febrero de 2021.

User | Page

parent

El elemento principal del grupo, si corresponde.

Group | Page

permissions

El permiso que un usuario concedió para una app instalada en el grupo.

string

privacy

La configuración de privacidad del grupo. Los posibles valores son CLOSED, OPEN y SECRET. Requiere un token de acceso de un administrador del grupo.

string

updated_time

La última vez que se actualizó el grupo (incluye cambios en las propiedades del grupo, publicaciones y comentarios). Requiere un token de acceso de un administrador del grupo.

datetime

Crear

No se admite esta operación.

Actualizar

No se admite esta operación.

Eliminar

No se admite esta operación.

Perímetros

Nombre Descripción

/admins

Este perímetro quedó obsoleto el 4 de abril de 2018.

/albums

Álbumes de fotos que pertenecen al grupo.

/docs

Documentos que pertenecen al grupo.

/events

Eventos que pertenecen al grupo.

/feed

Lista de publicaciones que pertenecen al grupo.

/files

Archivos que pertenecen al grupo.

/live_videos

Videos en vivo que pertenecen al grupo.

/members

Este perímetro quedó obsoleto el 4 de abril de 2018.

/photos

Fotos que pertenecen al grupo.

/videos

Videos que pertenecen al grupo.