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

NombreDescripción
Acceso a contenido público de páginasThis feature permission may be required.

Ejemplo

Graph API Explorer
GET /v19.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).

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
190Invalid OAuth 2.0 Access Token
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
100Invalid parameter
210User not visible
104Incorrect signature

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.