versión API Graph

Page Published Posts

Lectura

All published posts by the page.

Nueva experiencia para las páginas

This endpoint is supported for Nueva experiencia para las páginas.

Feature Permissions

NombreDescripción
Acceso al contenido público de la páginaThis feature permission may be required.

Ejemplo

Graph API Explorer
GET /v21.0/{page-id}/published_posts 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}/published_posts',
    '{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}/published_posts",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{page-id}/published_posts",
    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}/published_posts"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];
Si quieres aprender a usar la API Graph, lee nuestra guía "Uso de la API Graph".

Limitaciones

  • 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 noticias 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 compartidas: es posible que una publicación de la página que comparte una publicación de otra página o persona no se pueda ver si la 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 versión más reciente de tu agente de usuario concreto.
  • Publicaciones con vídeo: el campo source de /page/feed y /page/posts solo se devolverá para los vídeos que pertenezcan a la página si el usuario que realiza la solicitud es administrador de dicha página.

Parámetros

Este extremo no tiene ningún parámetro.

Campos

La lectura de este perímetro mostrará un resultado formateado con JSON:

{ "data": [], "paging": {}, "summary": {} }

data

Una lista de nodos de PagePost.

paging

Para obtener más detalles sobre la paginación, consulta la Guía de la API Graph.

summary

Información global sobre el perímetro, como los recuentos. Especifica los campos sobre los que quieres recuperar información en el parámetro "summary siguiendo este modelo: summary=total_count.

CampoDescripción
total_count
unsigned int32

The approximate total number of published posts within the specified time window, requires since parameter to be specified

Error Codes

ErrorDescripción
80001There have been too many calls to this Page account. Wait a bit and try again. For more info, please refer to https://developers.facebook.com/docs/graph-api/overview/rate-limiting.
200Permissions error
100Invalid parameter
190Invalid OAuth 2.0 Access Token
210User not visible
283That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata
104Incorrect signature
3001Invalid query
2500Error parsing graph query

Creando

No puedes realizar esta operación en este extremo.

Actualizando

No puedes realizar esta operación en este extremo.

Eliminando

No puedes realizar esta operación en este extremo.