Version API du graphe

shares`

Dans le cadre des modifications apportées à la version 3.3, l’autorisation read_page_mailboxes est devenue obsolète. Pour accéder à ce point de terminaison, utilisez l’autorisation pages_messaging. L’autorisation read_page_mailboxes cessera de fonctionner après le 30 juin 2020

Éléments partagés dans un message. Il s’agit d’un point de terminaison Pages uniquement.

Lecture

Explorateur de l’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
}];

Autorisations

Cette arête nécessite un token d’accès de Page avec les autorisations suivantes :

pages_messaging

Les applications en mode développement sont réservées à l’envoi de messages aux personnes qui ont un rôle dans l’app.

Champs

Nom	Description	Type
`description`	Description de l’élément partagé.	`string`
`link`	URL de l’élément partagé.	`string`
`id`	ID de l’élément partagé.	`string`
`name`	Titre de l’élément partagé.	`string`
`template`	Objet de l’élément partagé.	`Object`

`template.payload.product.elements`

Disponible uniquement si l’entreprise peut consulter le produit. Pour les produits n’appartenant pas à l’entreprise, renverra shares.data.name comme Attachment Unavailable.

Propriété	Type	Description
`id`	Chaîne	ID produit du catalogue produits Facebook
`retailer_id`	Chaîne	ID externe associé au produit (p. ex. : SKU/ID de contenu)
`image_url`	Chaîne	URL de l’image du produit
`title`	Chaîne	Titre du produit
`price`	Chaîne	Prix du produit

Exemple de modèle de produit

Le modèle de produit dans l’API Conversation est disponible uniquement dans l’API Graph 8.0 et versions ultérieures.

Seules les applications disposant de l’autorisation catalog_management peuvent recevoir les informations détaillées du produit dans l’API Conversation.

"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"
                            },
                            {..}],
                        }
                    }
                }
            }
    }]
}

Publication

Vous ne pouvez pas effectuer de publication à l’aide de cette arête.

Suppression

Vous ne pouvez pas effectuer de suppression à l’aide de cette arête.

Mise à jour

Vous ne pouvez pas effectuer de mise à jour à l’aide de cette arête.

Référence concernant l’API Graph /{message-id}/shares