Phiên bản API Đồ thị

shares`

Một trong những thay đổi của phiên bản 3.3 là quyền read_page_mailboxes đã ngừng hoạt động. Hãy sử dụng quyền pages_messaging để truy cập vào điểm cuối này. Quyền read_page_mailboxes sẽ ngừng hoạt động sau ngày 30/06/2020

Các mục được chia sẻ trong một tin nhắn. Đây là điểm cuối chỉ dành cho Trang.

Đọc

Trình khám phá API Đồ thị

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

Quyền

Cạnh này yêu cầu mã truy cập Trang cùng với các quyền sau:

pages_messaging

Các ứng dụng ở Chế độ phát triển chỉ có thể nhắn tin cho những người có vai trò trong ứng dụng.

Trường

Tên	Mô tả	Loại
`description`	Phần mô tả về mục được chia sẻ.	`string`
`link`	URL đến mục được chia sẻ.	`string`
`id`	ID của mục được chia sẻ.	`string`
`name`	Tên mục được chia sẻ.	`string`
`template`	Đối tượng của mục được chia sẻ.	`Object`

`template.payload.product.elements`

Trường này sẽ chỉ có sẵn nếu doanh nghiệp có thể xem sản phẩm. Đối với sản phẩm không thuộc sở hữu của doanh nghiệp đó, hệ thống sẽ trả về shares.data.name dưới dạng Attachment Unavailable.

Thuộc tính	Loại	Mô tả
`id`	Chuỗi	ID sản phẩm trong danh mục sản phẩm trên Facebook
`retailer_id`	Chuỗi	ID bên ngoài được liên kết với Sản phẩm. (Ví dụ: SKU/ID nội dung)
`image_url`	Chuỗi	URL của hình ảnh sản phẩm
`title`	Chuỗi	Tên sản phẩm
`price`	Chuỗi	Giá sản phẩm

Ví dụ về mẫu sản phẩm

Mẫu sản phẩm trên API Cuộc trò chuyện chỉ có trên API Đồ thị phiên bản 8.0 trở lên

Ứng dụng sẽ cần được phê duyệt quyền catalog_management thì mới nhận được chi tiết sản phẩm trong API Cuộc trò chuyệ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"
                            },
                            {..}],
                        }
                    }
                }
            }
    }]
}

Đăng

Bạn không thể đăng bằng cạnh này.

Xóa

Bạn không thể xóa bằng cạnh này.

Cập nhật

Bạn không thể cập nhật bằng cạnh này.

Tài liệu tham khảo về API Đồ thị /{message-id}/shares

Đọc