/{object-id}/comments
En esta referencia, se describe el perímetro /comments
, común a varios nodos de la API Graph. La estructura y las operaciones son iguales en cada nodo. Los siguientes objetos tienen un perímetro /comments
:
Los objetos de comentarios pueden tener un perímetro /comments
denominado respuestas a comentarios. Para estos, la estructura es la misma, pero se debe prestar atención a los modificadores para dichos perímetros.
Devuelve un comentario sobre un objeto.
Se dejará de devolver el campo id
del punto de conexión /PAGEPOST-ID/comments
para las apps que usan la función de acceso al contenido público de la página. Para obtener los identificadores de comentarios de una publicación de la página, debes poder realizar la tarea "MODERATE" en la página sobre la que se realiza la consulta. Este cambio se aplica a la versión 11.0 (y posteriores) y se implementará en todas las versiones el 7 de septiembre de 2021.
Se admiten los siguientes puntos de conexión de /comments
de objetos en la Nueva experiencia para páginas:
|
|
filter
en stream
o usa el campo order
./comments
devuelve datos vacíos si lo lees con un token de acceso de usuario:
id
del punto de conexión /PAGEPOST-ID/comments
para las apps que usan la función de acceso al contenido público de la página. Para acceder a los identificadores de comentarios de una publicación de la página, debes poder realizar la tarea "MODERATE" en la página sobre la que se realiza la consulta.
En el caso de los objetos que tienen decenas de miles de comentarios, es posible que encuentres límites al realizar la paginación. Obtén más información sobre la paginación en nuestra guía de uso de la API Graph.
GET /v21.0/{object-id}/comments 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(
'/{object-id}/comments',
'{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(
"/{object-id}/comments",
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{object-id}/comments",
null,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{object-id}/comments"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
GET /v21.0/{object-id}/comments?summary=1&filter=toplevel 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(
'/{object-id}/comments?summary=1&filter=toplevel',
'{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(
"/{object-id}/comments",
{
"summary": true,
"filter": "toplevel"
},
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
Bundle params = new Bundle();
params.putBoolean("summary", true);
params.putString("filter", "toplevel");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{object-id}/comments",
params,
HttpMethod.GET,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"summary": @YES,
@"filter": @"toplevel",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{object-id}/comments"
parameters:params
HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Parámetro | Descripción |
---|---|
| Un resumen de metadatos acerca de los comentarios sobre el objeto. Es importante saber que estos metadatos incluyen |
| Si una persona puede responder un comentario, puedes filtrarlos en función de los comentarios de nivel superior, de los que se realicen directamente en la publicación o del orden cronológico de todos los comentarios.
|
Una matriz de objetos de comentario, además de los siguientes campos cuando un summary
es true
en la solicitud.
Campo | Descripción |
---|---|
| Orden en el que se devolvieron los comentarios.
|
| El número de comentarios sobre este nodo. Es importante tener en cuenta que este valor cambia en función del
Nota: El |
Publica nuevos comentarios en cualquier objeto.
Se admiten los siguientes puntos de conexión /comments
de objetos en la Nueva experiencia para páginas:
|
|
MODERATE
en la página.pages_manage_engagement
.Ten presente que el campo can_comment
en cada objeto de comentario individual indica si es posible responder a ese comentario.
POST /v21.0/{object-id}/comments HTTP/1.1
Host: graph.facebook.com
message=This+is+a+test+comment
/* PHP SDK v5.0.0 */
/* make the API call */
try {
// Returns a `Facebook\FacebookResponse` object
$response = $fb->post(
'/{object-id}/comments',
array (
'message' => 'This is a test comment',
),
'{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(
"/{object-id}/comments",
"POST",
{
"message": "This is a test comment"
},
function (response) {
if (response && !response.error) {
/* handle the result */
}
}
);
Bundle params = new Bundle();
params.putString("message", "This is a test comment");
/* make the API call */
new GraphRequest(
AccessToken.getCurrentAccessToken(),
"/{object-id}/comments",
params,
HttpMethod.POST,
new GraphRequest.Callback() {
public void onCompleted(GraphResponse response) {
/* handle the result */
}
}
).executeAsync();
NSDictionary *params = @{
@"message": @"This is a test comment",
};
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
initWithGraphPath:@"/{object-id}/comments"
parameters:params
HTTPMethod:@"POST"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
id result,
NSError *error) {
// Handle the result
}];
Nombre | Descripción |
---|---|
| Un identificador opcional de una foto no publicada (consultar el campo |
| La URL de un GIF que se incluirá como comentario de un GIF animado. Al realizar la publicación, se debe proporcionar alguno de estos campos: |
| La URL de una imagen que se incluirá como comentario de una foto. Al realizar la publicación, se debe proporcionar alguno de estos campos: |
| Una foto, codificada como datos de formulario, que se usará como comentario de una foto. Al realizar la publicación, se debe proporcionar alguno de estos campos: |
| El texto del comentario. Al realizar la publicación, se debe proporcionar alguno de estos campos: Menciona otras páginas de Facebook en el texto de tu
El uso de esta función está sujeto a revisión. |
Si la operación se realiza correctamente, recibirás una respuesta JSON con el identificador de comentario creado recientemente. Asimismo, este punto de conexión admite la lectura después de escritura y puede devolver de inmediato los campos devueltos por las operaciones de lectura.
{ "id": "{comment-id}" }
No puedes realizar la actualización si usas este perímetro.
No puedes realizar la eliminación con este perímetro.
Para eliminar comentarios individuales, usa el punto de conexión /comment-id.