Graph API-Version

shares`

Aufgrund der Änderungen durch V3.3 ist die Berechtigung read_page_mailboxes mittlerweile veraltet. Verwende die Berechtigung pages_messaging, um auf diesen Endpunkt zuzugreifen. Die Berechtigung read_page_mailboxes wurde am 30. Juni 2020 eingestellt.

Geteilte Elemente in einer Nachricht. Das ist ein Endpunkt nur für Seiten.

Lesen

Graph API Explorer

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
}];

Berechtigungen

Für diese Edge ist ein Seiten-Zugriffsschlüssel mit den folgenden Berechtigungen erforderlich:

pages_messaging

Apps im Entwicklungsmodus können nur an Personen Nachrichten senden, die in der App eine Rolle haben.

Felder

Name	Beschreibung	Typ
`description`	Die Beschreibung des geteilten Elements	`string`
`link`	Die URL zum geteilten Element	`string`
`id`	Die ID des geteilten Elements	`string`
`name`	Der Titel des geteilten Elements	`string`
`template`	Das Objekt des geteilten Elements	`Object`

`template.payload.product.elements`

Dies ist nur für Unternehmen verfügbar, die das Produkt anzeigen können. Bei Produkten, die nicht dem Unternehmen gehören, wird shares.data.name als Attachment Unavailable zurückgegeben.

Eigenschaft	Typ	Beschreibung
`id`	String	Produkt-ID aus dem Facebook-Produktkatalog
`retailer_id`	String	Externe ID, die mit dem Produkt verknüpft ist (z. B. SKU/Content-ID)
`image_url`	String	URL des Produktbilds
`title`	String	Titel des Produkts
`price`	String	Preis des Produkts

Beispiel einer Produktvorlage

Die Produktvorlage in der Conversation API ist erst ab Version 8.0 der Graph API verfügbar.

Die App benötigt eine Genehmigung für die Berechtigung catalog_management, um Produktdetails in der Conversation API abzurufen.

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

Veröffentlichen

Mit dieser Edge ist das Veröffentlichen nicht möglich.

Löschen

Mit dieser Edge ist das Löschen nicht möglich.

Aktualisieren

Mit dieser Edge sind keine Aktualisierungen möglich.

Graph API-Referenz /{message-id}/shares