versión API Graph

shares`

Como parte de los cambios de la versión 3.3, el permiso read_page_mailboxes se retiró. Utiliza el permiso pages_messaging para acceder a este extremo. El permiso read_page_mailboxes dejará de funcionar a partir del 30 de junio de 2020.

Elementos compartidos en un mensaje. Se trata de un extremo exclusivo para páginas.

Lectura

Explorador de la API Graph

GET /v21.0/{message-id}/shares 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(
    '/{message-id}/shares',
    '{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(
    "/{message-id}/shares",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);

/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{message-id}/shares",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();

/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{message-id}/shares"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

Permisos

Este perímetro requiere un identificador de acceso a la página con los siguientes permisos:

pages_messaging

Las aplicaciones en modo de desarrollo están restringidas para el envío de mensajes a personas con un rol en la aplicación.

Campos

Nombre	Descripción	Tipo
`description`	Descripción del elemento compartido.	`string`
`link`	URL al elemento compartido.	`string`
`id`	Identificador del elemento compartido.	`string`
`name`	Título del elemento compartido.	`string`
`template`	Objeto del elemento compartido.	`Object`

`template.payload.product.elements`

Solo estará disponible si la empresa puede ver el producto. En el caso de los productos que no sean propiedad de la empresa, devolverá shares.data.name como Attachment Unavailable.

Propiedad	Tipo	Descripción
`id`	Cadena	Identificador del producto del catálogo de productos de Facebook.
`retailer_id`	Cadena	Identificador externo asociado con el producto (p. ej.: el SKU o el identificador del contenido).
`image_url`	Cadena	URL de la imagen del producto.
`title`	Cadena	Título del producto.
`price`	Cadena	Precio del producto.

Ejemplo de plantilla de producto

La plantilla de producto de la API de conversación solo está disponible en la API Graph versión 8.0 y posteriores.

La aplicación necesitará tener aprobado el permiso catalog_management para recibir los detalles del producto en la API de conversación.

"shares": {
    "data": [{
       "template": {
            "payload":{
                "product": {
                    "elements":{ // multiple elements in Hscroll
                        "data": [
                            {
                                "id" : "<Product_id>",
                                "retailer_id": "<EXTERNAL_ID>", 
                                "image_url" : "https://fb.cdn.com/sdsd",
                                "name" : "Some product title",
                                "price" : "$10"
                            },
                            {..}],
                        }
                    }
                }
            }
    }]
}

Publicación

No puedes realizar la publicación mediante este perímetro.

Eliminación

No puedes realizar la eliminación mediante este perímetro.

Actualización

No puedes realizar la actualización mediante este perímetro.

Referencia de la API Graph /{message-id}/shares