API Graph versión

shares`

Como parte de los cambios en la versión 3.3, el permiso read_page_mailboxes quedó obsoleto. Usa el permiso pages_messaging para acceder a este punto de conexión. El permiso read_page_mailboxes dejará de funcionar después del 30 de junio de 2020.

Elementos compartidos en un mensaje. Este es un punto de conexión exclusivo para páginas.

Lectura

Explorador de la API Graph

GET /v19.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 necesita un token de acceso a la página con los siguientes permisos:

pages_messaging

Las apps en modo de desarrollo solo pueden enviar mensajes a las personas que tienen un rol en la app.

Campos

Nombre	Descripción	Tipo
`description`	La descripción del elemento compartido.	`string`
`link`	La URL del elemento compartido.	`string`
`id`	El identificador del elemento compartido.	`string`
`name`	El título del elemento compartido.	`string`
`template`	El objeto del elemento compartido.	`Object`

`template.payload.product.elements`

Esto solo estará disponible si la empresa puede ver el producto. Para productos que no son propiedad de la empresa, se mostrará shares.data.name como Attachment Unavailable.

Propiedad	Tipo	Descripción
`id`	Cadena	Identificador de producto del catálogo de productos de Facebook
`retailer_id`	Cadena	Identificador externo asociado al producto. (p. ej.: identificador de contenido/SKU)
`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 en la API de conversación solo está disponible para la API Graph versión 8.0 y versiones posteriores

La app deberá tener un permiso de catalog_management aprobado para recibir detalles del producto en la API de conversiones.

"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 publicar usando este perímetro.

Eliminación

No puedes eliminar con este perímetro.

Actualización

No puedes actualizar usando este perímetro.

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