Nhóm

Đường dẫn `/{group-id}`

Biểu thị một nhóm Workplace. Nút /{group-id} trả về một nhóm.

Nhóm đa công ty

Có những điểm cụ thể cần lưu ý khi truy cập vào nhóm đa công ty:

Bất kỳ ứng dụng nào của tiện ích tích hợp đã cài đặt trong công ty thuộc nhóm đa công ty đều có thể đọc nội dung của nhóm
Nhóm đa công ty được liệt kê trong các cộng đồng hoặc nhóm bên cạnh các nhóm thông thường
- Trường mục đích có thể được dùng để xác định các nhóm đa công ty. Giá trị này được đặt thành WORK_MULTI_COMPANY
Người dùng cũng có thể truy vấn các thành viên nhóm, nhưng sẽ chỉ nhìn thấy id, name và picture nếu ứng dụng thuộc một công ty khác
Tiện ích tích hợp có quyền Quản lý nhóm có thể thêm và xóa các thành viên của nhóm đa công ty
- Tiện ích tích hợp chỉ có thể thêm và xóa người dùng là thành viên của cộng đồng đã cài đặt tiện ích tích hợp đó
- Tiện ích tích hợp chỉ có thể thêm và xóa người dùng khi một trong những quản trị viên nhóm là thành viên của cộng đồng đã cài đặt tiện ích đó
Tiện ích tích hợp có quyền Quản lý nội dung trong nhóm có thể xóa nội dung trong nhóm đa công ty nếu:
- Nội dung thuộc về một thành viên của cộng đồng ứng dụng hoặc
- Thành viên của cộng đồng ứng dụng là quản trị viên nhóm
Hiện không thể đăng lên nhóm đa công ty
Có thể chọn nhóm đa công ty trong phần cài đặt xác định phạm vi nhóm cho tiện ích tích hợp
Không thể nhắc đến các bot trong nhóm đa công ty

Đọc

Bạn có thể đọc thông tin về một nhóm bằng cách gửi yêu cầu GET của API Đồ thị đến /{group-id}.

Quyền

Để đọc nút Nhóm, bạn cần phải có quyền Đọc nội dung của nhóm.

Trường

Tên trường	Mô tả	Loại dữ liệu
`id`	ID nhóm.	`string`
`cover`	Thông tin về ảnh bìa của Nhóm.	`CoverPhoto`
`cover_url`	URL chứa hình ảnh cho ảnh bìa nhóm.	`string`
`description`	Mô tả tóm tắt về nhóm.	`string`
`icon`	URL cho biểu tượng của nhóm.	`url`
`is_workplace_default`	Cho biết liệu nhóm có phải là nhóm Workplace mặc định hay không (chỉ đọc).	`boolean`
`is_community`	Cho biết liệu nhóm có phải là một cộng đồng và có thể chứa các nhóm khác hay không (chỉ đọc).	`boolean`
`name`	Tên nhóm.	`string`
`owner`	Thành viên đã tạo nhóm này.	`User`
`privacy`	Cài đặt quyền riêng tư của nhóm. Giá trị có thể dùng: `CLOSED` `OPEN` `SECRET`	`string`
`updated_time`	Lần cập nhật nhóm gần đây nhất. Bao gồm bất kỳ thay đổi nào về thuộc tính của nhóm cũng như những thay đổi về bài viết và bình luận.	`datetime`
`archived`	Cho biết liệu nhóm đã được lưu trữ hay chưa.	`boolean`
`post_requires_admin_approval`	Cho biết liệu bài viết đăng lên nhóm có cần quản trị viên phê duyệt hay không.	`boolean`
`purpose`	Cho biết mục đích của nhóm	`enum {WORK_ANNOUNCEMENT, WORK_FEEDBACK, WORK_TEAMWORK, WORK_SOCIAL, WORK_MULTI_COMPANY}` Đã ngừng hoạt động: `WORK_FOR_SALE, WORK_TEAM`
`post_permissions`	Cho biết liệu bài viết có cần quản trị viên phê duyệt hay không.	`enum {NONE, ADMIN_ONLY}`
`join_setting`	Cho biết cách những thành viên mới có thể tham gia nhóm.	`enum {NONE, ANYONE, ADMIN_ONLY}`
`sorting_setting`	Cho biết thứ tự của bài viết được trả về cho cạnh `/feed`, giá trị mặc định là `CHRONOLOGICAL`.	`enum {RECENT_ACTIVITY, CHRONOLOGICAL}`
`is_official_group`	Cho biết liệu nhóm có phải là Nhóm Workplace chính thức hay không. Biểu tượng nhóm chính thức sẽ xuất hiện cùng với tên của nhóm chính thức trong sản phẩm.	`boolean`

Đăng

Bạn không thể đăng bằng cạnh này. Để tạo nhóm, hãy đăng lên cạnh /community/groups.

Xóa

Bạn không thể xóa nhóm bằng nút này. Việc xóa thành viên cuối cùng của nhóm sẽ tự động xóa nhóm đó.

Cập nhật

Bạn có thể cập nhật nhóm bằng cách gửi yêu cầu POST của API Đồ thị đến /{group-id} và chuyển các giá trị cho trường thông tin sẽ được cập nhật trong phần nội dung yêu cầu.

Quyền

Để cập nhật nút nhóm, bạn cần có quyền Quản lý nhóm.

Cạnh

Tên cạnh	Mô tả
`/admins`	Quản trị viên của nhóm Workplace. Hỗ trợ thao tác Thêm và Xóa quản trị viên trên Workplace. Hãy tham khảo các ví dụ dưới đây.
`/albums`	Album ảnh trong nhóm Workplace.
`/auto_membership_rules`	Quy tắc để tự động thêm thành viên vào nhóm.
`/docs`	Tài liệu trong nhóm Workplace.
`/events`	Sự kiện trong nhóm Workplace.
`/feed`	Các bài viết trong nhóm Workplace – được sắp xếp thành nguồn cấp dữ liệu.
`/files`	File được chia sẻ trong nhóm Workplace.
`/member_requests`	Yêu cầu tham gia đang chờ xử lý cho nhóm đã bật tính năng phê duyệt thành viên.
`/members`	Thành viên của nhóm Workplace. Cạnh này hiển thị: administrator: Hiển thị nếu người này là quản trị viên của nhóm joined: Hiển thị khi người dùng này đã tham gia nhóm moderator: Hiển thị nếu người này là người kiểm duyệt của nhóm added_by: Hiển thị người đã thêm người dùng này vào nhóm
`/moderators`	Người kiểm duyệt của nhóm Workplace.
`/pinned_posts`	Bài viết được ghim vào nhóm.
`/groups`	Liệt kê mọi nhóm con (chỉ dành cho những nhóm cũng là cộng đồng)

Ví dụ

Lấy ID, tên, trạng thái lưu trữ và quyền riêng tư của nhóm:

GET graph.facebook.com
  /{group-id}?fields=id,name,archived,privacy

Lưu trữ nhóm:

POST graph.facebook.com
  /{group-id}?archive=true

Lấy thành viên nhóm kèm theo tên, ID và ngày tham gia:

GET graph.facebook.com
  /{group-id}/members?fields=name,id,joined

Lấy quản trị viên và người kiểm duyệt của nhóm trong một lệnh gọi:

GET graph.facebook.com
  /{group-id}?fields=admins,moderators

Lấy tài liệu trong nhóm:

GET graph.facebook.com
  /{group-id}/docs

Lấy bài viết trong nhóm:

GET graph.facebook.com
  /{group-id}/feed

Lấy bài viết trong nhóm theo thứ tự thời gian cập nhật gần đây nhất:

GET graph.facebook.com
  /{group-id}/feed?sorting_setting=RECENT_ACTIVITY

Thông số

sorting_setting

Cho phép sắp xếp thứ tự bài viết theo thời gian cập nhật gần đây nhất thay vì thời gian tạo khi được đặt thành RECENT_ACTIVITY. Hành vi mặc định có thể được đặt rõ bằng cách dùng CHRONOLOGICAL làm giá trị. Thông tin cập nhật có thể bao gồm các chỉnh sửa đối với bài viết cũng như bình luận hoặc cảm xúc đã được thêm.

Lấy bài viết trong nhóm bao gồm file đính kèm bổ sung như video, hình ảnh, file hoặc cuộc thăm dò ý kiến:

GET graph.facebook.com
  /{group-id}/feed?fields=attachments

Các tùy chọn thăm dò ý kiến được liệt kê theo thứ tự giảm dần dựa trên số lượt bình chọn cho mỗi tùy chọn.

Lấy danh sách thành viên nhóm, cùng với ngày tham gia:

GET graph.facebook.com
  /{group-id}/members?fields=name,joined

Thêm thành viên vào nhóm theo ID:

POST graph.facebook.com
  /{group-id}/members/{member-id}

Thêm thành viên vào nhóm theo email:

POST graph.facebook.com
  /{group-id}/members?email=michael%40example.com

Khi đưa địa chỉ email vào URL cho một yêu cầu, hãy đảm bảo địa chỉ email được mã hóa URL. Ví dụ: michael@example.com trở thành michael%40example.com.

Việc xóa thành viên cuối cùng khỏi nhóm sẽ lên lịch xóa nhóm đó.

Xóa thành viên khỏi nhóm theo ID:

DELETE graph.facebook.com
  /{group-id}/members/{member-id}

Xóa thành viên khỏi nhóm theo email:

DELETE graph.facebook.com
  /{group-id}/members?email=michael%40example.com

Khi bạn thêm địa chỉ email vào URL cho một yêu cầu, hãy nhớ mã hóa URL cho địa chỉ email đó. Ví dụ: michael@example.com trở thành michael%40example.com.

Thăng cấp thành viên làm quản trị viên của nhóm:

POST graph.facebook.com
  /{group-id}/admins/{user-id}

Hạ bậc quản trị viên làm thành viên của nhóm:

DELETE graph.facebook.com
  /{group-id}/admins/{user-id}

Tạo Sự kiện mới trong nhóm:

POST graph.facebook.com
  /{group-id}/events
  ?name=New+Event
  &start_time=2017-03-02T14:00:04+00:00
  &end_time=2017-03-02T15:00:04+00:00
  &description=Test+Description
  &location=Boardroom

Tải ảnh mới (qua nhị phân) lên nhóm:

POST graph.facebook.com
  /{group-id}/photos?source={image-data}

Tải ảnh mới (qua url) lên nhóm:

POST graph.facebook.com
  /{group-id}/photos?url={image-data}

Tạo bài viết trong nhóm có file đính kèm hình ảnh và video:

POST graph.facebook.com
  /{group-id}/feed?attached_media=[{"media_fbid":"{photo-id}"},{"media_fbid":"{photo-id}"}]

Thông số

attached_media

Dùng cho ảnh và video, một mảng media_fbids nằm trong dấu ngoặc. Hỗ trợ các định dạng hình ảnh sau: .jpeg, .bmp, .png, .gif, .tiff. Bạn có thể tìm thêm thông tin về các định dạng hình ảnh tại đây. Bạn có thể tìm thấy các file video được hỗ trợ tại đây. Để lấy media_fbids cho hình ảnh, trước tiên, hãy đăng ảnh chưa đăng lên https://graph.facebook.com/me/photos, như được mô tả trong tài liệu tại đây. Để lấy media_fbids cho video (bao gồm file GIF động), trước tiên, hãy đăng video lên https://graph.facebook.com/me/videos?no_story=true.

Việc đặt thông số no_story là true sẽ chặn tin trong bảng feed được tạo tự động trên trang cá nhân của một người khi người đó tải video lên bằng ứng dụng của bạn.

Tạo bài viết trong nhóm có file đính kèm:

POST graph.facebook.com
  /{group-id}/feed?files=[{file-id},{file-id}]

Thông số

files

Dùng cho file, một mảng file_ids (lưu ý rằng những ID này không nằm trong dấu ngoặc). Tính năng lập phiên bản file hiện không được hỗ trợ. Để cập nhật file, vui lòng gỡ file gốc khỏi file đính kèm của bài viết và tải lại file đính kèm mới lên. Hỗ trợ các định dạng file sau:

Tài liệu: .pdf, .csv, .tsv, .docx, .pptx, .xlsx
Hình ảnh: .jpeg, .png
Video: .mp4
File lưu trữ: .rar, .zip

Để lấy file_ids, trước tiên, hãy đăng file lên https://graph.facebook.com/group_file_revisions. Bạn có thể đăng file nguồn từ máy tính của mình.

Bạn không thể kết hợp các thông số attached_media và files trong một lệnh gọi API. Thao tác này sẽ mô phỏng hành vi trong trình soạn thảo của nhóm. Trình soạn thảo này có các tùy chọn riêng để tải "Ảnh/Video" và "File" lên.

Cập nhật quyền đăng, cài đặt tham gia, cài đặt mục đích và cài đặt phê duyệt bài viết

POST graph.facebook.com
  /{group-id}/?post_permissions=NONE&join_setting=ADMIN_ONLY&purpose=WORK_SOCIAL&post_requires_admin_approval=false

Lấy cảm xúc và bình luận về bài viết đã ghim

GET graph.facebook.com
  /{group-id}/pinned_posts?fields=reactions,comments

Xác định xem nhóm có phải là một cộng đồng hay không

GET graph.facebook.com
  /{group-id}?fields=is_community

Lấy quy tắc chọn thành viên vào nhóm

GET graph.facebook.com
  /{group-id}/auto_membership_rules

Phản hồi mẫu (JSON):

{
  "data": [
    {
      "conditions": [
        {
          "field": "TITLE",
          "operator": "CONTAINS",
          "values": [
            "sales"
          ]
        }
      ],
      "id": RULE_ID
    }
  ],
  ...
}

Xóa quy tắc chọn thành viên tự động cho nhóm

DELETE graph.facebook.com
  /RULE_ID

Áp dụng quy tắc chọn thành viên cho nhóm

POST graph.facebook.com
  /{group-id}/auto_membership_rules

Phần tải dữ liệu mẫu:

{
    "conditions": [
        {
            "field": "LOCATION",
            "operator": "CONTAINS",
            "values": ["London", "San Francisco"]
        }
    ]
  }

API này có thể thêm hàng nghìn người dùng vào một nhóm nếu nhầm lẫn. Vì vậy, bạn cần phải hết sức thận trọng khi sử dụng API này và kiểm tra kỹ trước khi thực thi lệnh gọi API.

Lấy ID nhóm và trạng thái nhóm chính thức:

GET graph.facebook.com
  /{group-id}?fields=id,is_official_group

Cập nhật trạng thái nhóm chính thức:

POST graph.facebook.com
  /{group-id?is_official_group={FALSE | TRUE}

Nhóm

Đường dẫn /{group-id}

Nhóm đa công ty

Đọc

Quyền

Trường

Đăng

Xóa

Cập nhật

Quyền

Cạnh

Ví dụ

Lấy ID, tên, trạng thái lưu trữ và quyền riêng tư của nhóm:

Lưu trữ nhóm:

Lấy thành viên nhóm kèm theo tên, ID và ngày tham gia:

Lấy quản trị viên và người kiểm duyệt của nhóm trong một lệnh gọi:

Lấy tài liệu trong nhóm:

Lấy bài viết trong nhóm:

Lấy bài viết trong nhóm theo thứ tự thời gian cập nhật gần đây nhất:

Lấy bài viết trong nhóm bao gồm file đính kèm bổ sung như video, hình ảnh, file hoặc cuộc thăm dò ý kiến:

Lấy danh sách thành viên nhóm, cùng với ngày tham gia:

Thêm thành viên vào nhóm theo ID:

Thêm thành viên vào nhóm theo email:

Xóa thành viên khỏi nhóm theo ID:

Xóa thành viên khỏi nhóm theo email:

Thăng cấp thành viên làm quản trị viên của nhóm:

Hạ bậc quản trị viên làm thành viên của nhóm:

Tạo Sự kiện mới trong nhóm:

Tải ảnh mới (qua nhị phân) lên nhóm:

Tải ảnh mới (qua url) lên nhóm:

Tạo bài viết trong nhóm có file đính kèm hình ảnh và video:

Tạo bài viết trong nhóm có file đính kèm:

Cập nhật quyền đăng, cài đặt tham gia, cài đặt mục đích và cài đặt phê duyệt bài viết

Lấy cảm xúc và bình luận về bài viết đã ghim

Xác định xem nhóm có phải là một cộng đồng hay không

Lấy quy tắc chọn thành viên vào nhóm

Xóa quy tắc chọn thành viên tự động cho nhóm

Áp dụng quy tắc chọn thành viên cho nhóm

Lấy ID nhóm và trạng thái nhóm chính thức:

Cập nhật trạng thái nhóm chính thức:

Đường dẫn `/{group-id}`