Feeds de páginas

Utiliza este extremo para obtener una página y realizar una publicación en ella. Los feeds de páginas abarcan todas las interacciones con una página de Facebook, tales como las publicaciones que realiza y los enlaces que publica la página, los visitantes a la página y las publicaciones públicas en las que se ha etiquetado la página.

Más información

• El extremo /{page-post-id} te permite actualizar una publicación de la página específica.
• El extremo /{page-id}/taggedsolo te permite recuperar las publicaciones públicas en las que se ha etiquetado la página.

Lectura

Publicaciones de una página de Facebook.

Nueva experiencia para páginas

Esta API es compatible con la nueva experiencia para páginas.

Requisitos

El usuario que solicita el identificador de acceso debe poder realizar una de las siguientes tareas en la página:

• CREATE_CONTENT: publicar contenido en nombre de la página en la página.
• MANAGE: asignar y administrar tareas de la página.
• MODERATE

  • Responder a comentarios en las publicaciones de la página en nombre de esta.
  • Eliminar comentarios en las publicaciones de la página
  • Si se conecta una cuenta de Instagram a la página, publicar contenido en Instagram desde Facebook, responder a comentarios y eliminarlos, enviar mensajes directos, sincronizar la información de contacto de la empresa y crear anuncios.

Además, es necesario haber concedido a la aplicación los siguientes permisos:

• El permiso pages_read_engagement.
• El permiso pages_read_user_content.

Si no eres el propietario ni administrador de la página, necesitarás lo siguiente:

• La función de acceso al contenido público de la página

Ejemplo de solicitud

GET /v21.0/{page-id}/feed 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(
    '/{page-id}/feed',
    '{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(
    "/{page-id}/feed",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Ejemplo de respuesta JSON

{
  "data": [
    {
      "created_time": "2019-05-17T16:24:04+0000",
      "message": "Become a Facebook developer!",
      "id": "{page-id}_2191966997525824"
    },
    {
      "created_time": "2019-02-26T21:35:42+0000",
      "message": "Hello world!",
      "id": "{page-id}_2072371269485398"
    },
...
    {
      "created_time": "2018-01-26T20:57:22+0000",
      "message": "Friday Funday!",
      "id": "{page-id}_1569752556413941"
    }
  ],
  "paging": {
    "cursors": {
      "before": "Q2c4U1pXNT...",
      "after": "Q2c4U1pXNT..."
    },
    "next": "https://graph.facebook.com/vX.X/{page-id}/feed?access_token={your-page-access-token}&pretty=0&limit=25&after=Q2c4U1pXNT..."
  }
}

Limitaciones

• Publicaciones caducadas: si una publicación ha caducado, ya no podrás ver el contenido con la API Graph.
• Publicaciones máximas

  • La API devolverá aproximadamente 600 publicaciones realizadas y clasificadas al año.
  • Solo puedes leer un máximo de 100 publicaciones de feeds con el campo limit. Si intentas leer más, recibirás un mensaje de error en el que se te indicará que no superes las 100.
• Llamada a la acción de mensajes: no se puede acceder a las publicaciones con llamadas a la acción de mensajes con otro identificador de acceso a la página, dado que las páginas no pueden enviar mensajes a otras páginas.
• Información de identificación pública: la información del usuario no se incluirá en las respuestas a menos que hagas la solicitud con un identificador de acceso a la página.
• Publicaciones realizadas: las publicaciones realizadas y sin realizar se devolverán al consultar el extremo “/{page-id}/feed”. Usa el campo “is_published” para que se devuelvan solo las publicaciones realizadas.
• Publicaciones compartidas: es posible que una publicación de la página que comparte una publicación de otra página o usuario no se pueda ver si la publicación original tampoco se puede ver con el identificador de acceso utilizado.
• Publicaciones etiquetadas: cuando utilizas /{page-id}/tagged para mostrar las publicaciones que etiquetaron esta página, los resultados solo incluyen publicaciones de otras páginas si estas son auténticas.
• Agentes de usuario: los agentes de usuario disponibles que se permiten para estas llamadas a la API Graph están sujetos a cambios sin previo aviso. Si tienes problemas, te recomendamos que cambies a una nueva versión de tu agente de usuario concreto.
• Publicaciones con vídeo: para obtener una lista de publicaciones con vídeo, el usuario que realiza la solicitud debe ser un administrador de la página.
• Reels: para obtener una lista de los reels publicados en tu página, usa el perímetro de VideoReels de la página.

Limitación: todas las publicaciones (realizadas o no) se extraerán en el extremo de feeds. La única diferencia es que las publicaciones sin realizar no se mostrarán en el feed físico. Sin embargo, hay un campo “is_published” que se puede añadir al extremo “/feed” para que los desarrolladores sepan si la publicación que se indica en el extremo “/feed” se ha realizado o no.

Campos

curl -i -X GET \
 "https://graph.facebook.com/{your-page-id}/feed
    ?fields=is_eligible_for_promotion,promotable_id
        &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{your-page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_eligible_for_promotion,promotable_id");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"fields": @"is_eligible_for_promotion,promotable_id",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'GET',
  {"fields":"is_eligible_for_promotion,promotable_id"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{your-page-id}/feed?fields=is_eligible_for_promotion,promotable_id',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

{
  "data": [
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943344825721377",
      "id": "1353269864728879_1943344825721377"
    },
    {
      "is_eligible_for_promotion": true,
      "promotable_id": "1353269864728879_1943313139057879",
      "id": "1353269864728879_1943378089051384"
    },
    {
      "is_eligible_for_promotion": false,
      "promotable_id": "1353269864728879_1942095249179668",
      "id": "1353269864728879_1942095249179668"
    },
...

Publicación

Puedes publicar contenido en páginas mediante este perímetro. Se debe proporcionar link o message.

Nueva experiencia para páginas

Esta API es compatible con la nueva experiencia para páginas.

Requisitos

Si puedes realizar la tarea CREATE_CONTENT, necesitarás lo siguiente:

• Un identificador de acceso a la página.
• El permiso pages_manage_posts.
• El permiso pages_read_engagement.
• El permiso pages_show_list.

Las publicaciones se mostrarán en nombre de la página.

Permisos

• Un identificador de acceso a la página solicitado por un usuario que pueda realizar la

  tarea CREATE_CONTENT

  en la página que se consulta.

• El permiso pages_manage_posts

Nota: Si el espectador o la aplicación no pueden ver la URL de link, se producirá un error en la publicación.

POST /v21.0/{page-id}/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+message

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/{page-id}/feed',
    array (
      'message' => 'This is a test message',
    ),
    '{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(
    "/{page-id}/feed",
    "POST",
    {
        "message": "This is a test message"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test message");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test message",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{page-id}/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Respuesta

{"id":"post-id"}

El extremo admite la operación de lectura después de la escritura y puede devolver inmediatamente cualquier campo que devuelvan las operaciones de lectura.

Ejemplo de la herramienta del explorador de la API Graph

Prueba la herramienta del explorador de la API Graph con POST {page-id}/feed:

Campos

POST /v21.0/page-id/feed HTTP/1.1
Host: graph.facebook.com

message=This+is+a+test+activity&og_action_type_id=383634835006146&og_object_id=136050896551329&og_icon_id=609297155780549

/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->post(
    '/page-id/feed',
    array (
      'message' => 'This is a test activity',
      'og_action_type_id' => '383634835006146',
      'og_object_id' => '136050896551329',
      'og_icon_id' => '609297155780549',
    ),
    '{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(
    "/page-id/feed",
    "POST",
    {
        "message": "This is a test activity",
        "og_action_type_id": "383634835006146",
        "og_object_id": "136050896551329",
        "og_icon_id": "609297155780549"
    },
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

Bundle params = new Bundle();
params.putString("message", "This is a test activity");
params.putString("og_action_type_id", "383634835006146");
params.putString("og_object_id", "136050896551329");
params.putString("og_icon_id", "609297155780549");
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/page-id/feed",
    params,
    HttpMethod.POST,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

NSDictionary *params = @{
  @"message": @"This is a test activity",
  @"og_action_type_id": @"383634835006146",
  @"og_object_id": @"136050896551329",
  @"og_icon_id": @"609297155780549",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/page-id/feed"
                                      parameters:params
                                      HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Publicaciones de página ocultas

Admitimos los siguientes tipos de publicaciones de página ocultas:

Las publicaciones de página ocultas se tratan igual que las que se muestran, excepto en que estas no aparecen en /feed.

Para ver una lista de las publicaciones de página ocultas, consulta el campo is_published.

curl -i -X GET \
 "https://graph.facebook.com/{page-id}/feed
 ?fields=is_published
 &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newGraphPathRequest(
  accessToken,
  "/{page-id}/feed",
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});

Bundle parameters = new Bundle();
parameters.putString("fields", "is_published");
request.setParameters(parameters);
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{page-id}/feed"
           parameters:@{ @"fields": @"is_published",}
           HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{page-id}/feed',
  'GET',
  {"fields":"is_published"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->get(
    '/{page-id}/feed?fields=is_published',
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Para ver una publicación en Facebook.com, puedes navegar a https://www.facebook.com/{post-id} a fin de ver la mayoría de tipos de publicaciones. También puedes recuperar el campo actions de la publicación, que contiene la URL en la que el usuario puede indicar que le gusta la publicación o añadirle un comentario.

Publicación de la página call_to_action

Puedes mejorar las publicaciones de la página con enlace con los botones de llamada a la acción. El campo call_to_action siguiente se puede añadir a las nuevas publicaciones de la página con enlace.

Imagen de publicación de la página con enlace personalizada

Publica un enlace en una página e incluye una imagen de enlace personalizada. El archivo adjunto de la historia representa una imagen recuperada del enlace. Actualmente, se puede proporcionar un parámetro picture opcional con una URL a una nueva imagen para reemplazar esa imagen. El parámetro thumbnail ofrece una funcionalidad similar con la diferencia clave de que el parámetro acepta un archivo de imagen local que se sube a Facebook en la llamada a la API.

Permisos

• Se requiere un identificador de acceso a la página.
• El enlace debe pertenecer a la página que hace la publicación.

Limitaciones

• El parámetro thumbnail solo está disponible para las publicaciones con enlace de las páginas de Facebook.
• El parámetro thumbnail tiene mayor prioridad sobre el parámetro picture. Si se proporcionan ambos, el parámetro picture no se utiliza.
• El parámetro thumbnail acepta imágenes con la extensión .jpg, .jpeg, .gif o .png.
• El parámetro thumbnail no se admite en las solicitudes por lotes.

Publicar un enlace en una página

Para publicar un enlace en una página, envía una solicitud POST al perímetro /page/feed. Establece el parámetro publish en 1 para realizar la publicación inmediatamente o en 0 para crear una publicación oculta que se publicará más tarde.

Ejemplo de solicitud

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become%20a%20Facebook%20developer!
  &link=https%3A%2F%2Fdevelopers.facebook.com
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Ejemplo de respuesta

{"id":"{post-id}"}

Enlace de una publicación de la página con una llamada a la acción

El campo call_to_action especifica la acción adecuada y el enlace pertinente. Este enlace debe ser el mismo que el del parámetro link de la publicación de la página. En esta llamada, los valores title, description, caption y picture son opcionales y, cuando no se proporcionen, Facebook leerá las propiedades equivalentes de los metadatos de Open Graph del enlace. Si la página web vinculada no tiene metadatos de Open Graph, Facebook intentará averiguar dichas propiedades mediante la extracción de contenido de la página web.

Ejemplo de solicitud

curl -i -X POST "https://graph.facebook.com/{your-page-id}/feed
  ?message=Become a Facebook developer!
  &link=https://developers.facebook.com
  &call_to_action={"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}
  &published=1
  &access_token={your-page-access-token}"

GraphRequest request = GraphRequest.newPostRequest(
  accessToken,
  "/{your-page-id}/feed",
  new JSONObject("{\"message\":\"Become a Facebook developer!\",\"link\":\"https://developers.facebook.com\",\"published\":\"1\",\"call_to_action\":\"{\\\"type\\\":\\\"SIGN_UP\\\",\\\"value\\\":{\\\"link\\\":\\\"https://developers.facebook.com\\\"}}\"}"),
  new GraphRequest.Callback() {
    @Override
    public void onCompleted(GraphResponse response) {
      // Insert your code here
    }
});
request.executeAsync();

FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
    initWithGraphPath:@"/{your-page-id}/feed"
           parameters:@{ @"message": @"Become a Facebook developer!",@"link": @"https://developers.facebook.com",@"published": @"1",@"call_to_action": @"{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}",}
           HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection, id result, NSError *error) {
    // Insert your code here
}];

FB.api(
  '/{your-page-id}/feed',
  'POST',
  {"message":"Become a Facebook developer!","link":"https://developers.facebook.com","published":"1","call_to_action":"{\"type\":\"SIGN_UP\",\"value\":{\"link\":\"https://developers.facebook.com\"}}"},
  function(response) {
      // Insert your code here
  }
);

try {
  // Returns a `FacebookFacebookResponse` object
  $response = $fb->post(
    '/{your-page-id}/feed',
    array (
      'message' => 'Become a Facebook developer!',
      'link' => 'https://developers.facebook.com',
      'published' => '1',
      'call_to_action' => '{"type":"SIGN_UP","value":{"link":"https://developers.facebook.com"}}'
    ),
    '{access-token}'
  );
} catch(FacebookExceptionsFacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(FacebookExceptionsFacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();

Ejemplo de respuesta

{"id":"{post-id}"}

Enlace de una publicación con una imagen subida personalizada

Mediante un archivo local:

curl -F 'link=http://www.example.com' \
     -F 'thumbnail=@/local/path/to/file/on/hard/drive/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Valor devuelto

{"id":"post-id"}

Mediante una imagen a través de una URL:

curl -F 'link=http://www.example.com' \
     -F 'picture=https://www.example.com/path/to/image.jpg' \
     -F 'access_token=page-access-token'\
  https://graph.facebook.com/v2.11/page-id/feed

Valor devuelto

{"id":"post-id>"}

Publicación de la página con foto

Visita nuestra referencia del nodo de fotos para obtener más información.

Publicación de la página con vídeo

Visita nuestra referencia de vídeos de la página para obtener más información.

Estadísticas de la publicación de la página

Visita nuestra referencia de insights de la publicación de la página para obtener más información.

Actualización

No puedes realizar la actualización con este perímetro, pero puedes actualizar publicaciones con el nodo /{post-id}.

Eliminación

No puedes realizar la eliminación con este perímetro, pero puedes /{post-id}eliminar publicaciones con el nodo .