API Graph versión

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

Nombre	Descripción
Acceso a contenido público de páginas	This 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 obtener información sobre cómo usar la API Graph, lee nuestra guía de uso de la API Graph.

Limitaciones

Cantidad máxima de publicaciones
- La API devuelve aproximadamente 600 publicaciones hechas clasificadas por año.
- Solo puedes leer un máximo de 100 publicaciones de la lista con el campo limit. Si intentas leer más, recibirás un mensaje de error en el que se indicará que no puedes superar las 100 publicaciones.
Llamada a la acción de mensaje: no se puede acceder a las publicaciones con llamadas a la acción de mensaje mediante otro token de acceso a la página, ya que las páginas no pueden enviar mensajes a otras páginas.
Información de identificación pública: no se incluirá la información de usuario en las respuestas, a menos que hagas la solicitud con un token 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 u otra persona no sea visible si la publicación original no es visible con el token de acceso utilizado.
Publicaciones etiquetadas: cuando usas /{page-id}/tagged para mostrar las publicaciones que etiquetaron a esta página, los resultados incluyen las publicaciones de otras páginas solo si estas son auténticas.
Agentes de usuario: los agentes de usuario disponibles permitidos en estas llamadas a la API Graph están sujetos a cambio sin previo aviso. Si experimentas problemas, quizás debas cambiar a una versión más reciente del agente de usuario en particular.
Publicaciones de videos: el campo source de /page/feed y /page/posts ya no se devolverá en los videos que pertenecen a la página, a menos que el usuario que haga la solicitud sea administrador en la página propietaria.

Parámetros

Este extremo no tiene ningún parámetro.

Campos

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

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

`data`

Una lista de nodos PagePost.

`paging`

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

`summary`

Información total sobre el perímetro, por ejemplo, los recuentos. Especifica los campos que quieres recuperar en el parámetro "summary" (como en summary=total_count).

Campo Descripción

Campo	Descripción
`total_count` unsigned int32	The approximate total number of published posts within the specified time window, requires since parameter to be specified

total_count

unsigned int32

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

Error Codes

Error	Descripción
80001	There 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.
200	Permissions error
100	Invalid parameter
190	Invalid OAuth 2.0 Access Token
210	User not visible
283	That action requires the extended permission pages_read_engagement and/or pages_read_user_content and/or pages_manage_ads and/or pages_manage_metadata
104	Incorrect signature
3001	Invalid query
2500	Error parsing graph query

Creación

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.