Feed de página

Usa este punto de conexión para llegar a una página y publicar en ella. El feed de página incluye cualquier interacción con una página de Facebook, por ejemplo, publicaciones y enlaces incorporados en esta página, visitantes de esta página y publicaciones públicas en las que se etiquetó a la página.

Más información

• El punto de conexión /{page-post-id} te permite actualizar una publicación específica de la página.
• El punto de conexión /{page-id}/taggedrecupera todas las publicaciones públicas en las que se etiquetó a esta página.

Leer

Las publicaciones de una página de Facebook.

Nueva experiencia de página

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

Requisitos

La persona que solicita el token de acceso debe poder realizar alguna de las siguientes tareas en la página:

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

  • Responder comentarios en las publicaciones de la página actuando en nombre de ella.
  • Eliminar comentarios en las publicaciones de la página.
  • Si una cuenta de Instagram está conectada 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.

También es necesario haber otorgado los siguientes permisos a la app:

• El permiso pages_read_engagement
• El permiso pages_read_user_content

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

• La función de acceso a contenido público de páginas.

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 caducó una publicación, ya no podrás ver el contenido mediante la API Graph.
• 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: las publicaciones con llamadas a la acción de mensaje no son accesibles 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 realizadas: las publicaciones realizadas y no realizadas se devolverán cuando se consulte el punto de conexión "/{page-id}/feed". Usa el campo "is_published" para que se devuelvan solo publicaciones realizadas.
• 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 tienes problemas, quizás debas cambiar a una versión más reciente del agente de usuario en particular.
• Publicaciones de video: para obtener una lista de publicaciones de video, la persona que realiza la solicitud debe ser administradora de la página.
• Reels: para obtener una lista de los reels publicados en tu página, usa el perímetro Page VideoReels.

Limitación: todas las publicaciones (realizadas y no realizadas) se retirarán del punto de conexión del feed. La única diferencia es que las publicaciones no realizadas no aparecerán en el feed físico. Sin embargo, se puede agregar el campo "is_published" al punto de conexión "/feed" para indicar a los desarrolladores si la publicación que aparece en el punto de conexión "/feed" se realizó 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 en páginas con este perímetro. Debe proporcionarse link o message.

Nueva experiencia de página

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

Requisitos

Si puedes realizar la tarea CREATE_CONTENT, necesitarás:

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

Las publicaciones aparecerán con la identidad de la página.

Permisos

• Un token de acceso a la página solicitado por una persona que puede realizar la tarea

  CREATE_CONTENT

  en la página que se consulta

• El permiso pages_manage_posts

Nota: Si la persona que está visualizando o la app 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"}

Este punto de conexión admite lectura después de escritura y puede devolver de inmediato los campos devueltos por las operaciones de lectura.

Ejemplo de la herramienta del explorador de Graph

Prueba en la herramienta del explorador de Graph mediante 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 del mismo modo que las publicaciones efectivamente realizadas, con la excepción de que 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();

A fin de ver una publicación en Facebook.com, puedes visitar https://www.facebook.com/{post-id} para la mayoría de los tipos de publicación, o puedes recuperar el campo actions de la publicación que contiene la URL desde la cual un usuario puede indicar que le gusta la publicación o hacer un comentario.

Llamada a la acción de la publicación de la página

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

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

Puedes publicar un enlace a una página con una imagen de enlace personalizado. El archivo adjunto de la historia genera una imagen recuperada desde ese enlace. Actualmente, es posible anular esa imagen si proporcionas un parámetro picture opcional con una URL a una imagen nueva. El parámetro thumbnail ofrece una funcionalidad similar. La principal diferencia es que el parámetro acepta un archivo de imagen local que se sube a Facebook en la llamada a la API.

Permisos

• Se exige un token de acceso a la página.
• El enlace debe ser propiedad de la página que publica.

Limitaciones

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

Publicar un enlace a una página

Publica un enlace a una página enviando una solicitud "POST" al perímetro /page/feed. Establece el parámetro publish en 1 para hacer la publicación inmediatamente o en 0 para crear una publicación oculta para 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}"}

Publicación de la página con enlace con llamada a la acción

El campo call_to_action especifica la acción correspondiente y el enlace pertinente. Este enlace debe ser el mismo que el parámetro link de la publicación de la página. En esta llamada, title, description, caption y picture son opcionales; cuando no se proporcionan, Facebook lee las propiedades equivalentes desde los metadatos de Open Graph del enlace. Si la página web vinculada no tiene metadatos de Open Graph, Facebook intentará adivinar estas propiedades extrayendo el 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}"}

Publicación con enlace con imagen personalizada subida

Usar 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"}

Usar una imagen mediante 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

Para obtener más información, consulta la referencia sobre el nodo "Photo".

Publicación de la página con video

Para obtener más información, consulta la referencia sobre video de la página.

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

Para obtener más información, consulta la referencia sobre estadísticas de la publicación de la página.

Actualización

No puedes actualizar usando este perímetro, pero puedes actualizar publicaciones con el nodo /{post-id}.

Eliminación

No puedes eliminar usando este perímetro, pero puedes eliminar publicaciones con el nodo /{post-id}.