Cộng đồng

Đường dẫn /community

Đường dẫn thay thế /company

Biểu thị cộng đồng Workplace của bạn. Nút /community (hoặc /company - hoạt động thay cho nhau) trả về một đối tượng cộng đồng thuộc loại Nhóm. Để thuận tiện cho API, bạn có thể xem đối tượng cộng đồng gốc là một Nhóm gốc cho các nhóm hoặc cộng đồng khác.

Bạn có thể tìm ID cộng đồng của mình bằng cách thực hiện lệnh gọi GET của API Đồ thị đến graph.facebook.com/community bằng mã truy cập tiện ích tích hợp tùy chỉnh.

Trong một số trường hợp, một cộng đồng gốc cũng có thể chứa các cộng đồng khác - sẽ xuất hiện trên cạnh /groups của cộng đồng gốc đó. Có thể phân biệt các cộng đồng con của một cộng đồng gốc với các nhóm con bằng trường is_community.

Sự tồn tại của một hoặc nhiều cộng đồng bên trong một cộng đồng gốc xác định rằng phiên bản Workplace này có hỗ trợ cộng đồng.

Có thể truy vấn lần lượt những cộng đồng con này trên cạnh /groups để lấy các nhóm trong cộng đồng đó. Trong mọi trường hợp, cạnh /groups sẽ chỉ hiển thị cộng đồng con trực tiếp của cộng đồng đó; hệ thống sẽ không thực hiện phép đệ quy.

Không thể tạo cộng đồng qua API này, nhưng có thể quản lý các thành viên theo cách tương tự như thành viên nhóm.

Đọc

GET graph.facebook.com
  /community

Quyền

Nút cộng đồng cần có quyền Đọc nội dung của nhóm hoặc Quản lý nhóm.

Đăng

Bạn không thể dùng nút này để đăng cộng đồng Workplace.

Xóa

Bạn không thể dùng nút này để xóa cộng đồng Workplace.

Cập nhật

Bạn không thể dùng nút này để cập nhật cộng đồng Workplace.

Cạnh

Ví dụ

Tạo nhóm mới

Bạn có thể tạo nhóm mới cho cộng đồng Workplace bằng cách gửi yêu cầu POST đến cạnh /community/groups. Phản hồi sẽ chứa ID của nhóm mới tạo. Lưu ý rằng để nhóm của bạn có thể hiển thị bất kỳ thành viên nào, bạn phải thêm ít nhất một thành viên và đặt thành viên đó làm quản trị viên.

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Lấy danh sách tất cả nhóm và cộng đồng của một cộng đồng gốc:

GET graph.facebook.com
  /community/groups?fields=is_community

Lấy danh sách tất cả thành viên của một cộng đồng gốc:

GET graph.facebook.com
  /community/members

Lấy danh sách tất cả thành viên của một cộng đồng gốc, lọc theo external_id:

GET /community/members?
  external_ids=12356,abc123

Báo cáo một mục nội dung (Lưu ý rằng cạnh này đã ngừng hoạt động từ ngày 30/04/2019):

POST graph.facebook.com
  /community/reported_content?
    content_id={...}

Thêm nhóm mới vào cộng đồng gốc:

POST graph.facebook.com
  /community/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Thêm nhóm mới vào cộng đồng không phải cộng đồng gốc:

POST graph.facebook.com
  /{community-id}/groups?
    name={...}&
    description={...}&
    privacy=OPEN

Cấp phép tài khoản:

POST graph.facebook.com
  /community/accounts?
    name={...}&
    email={...}&
    department={...}&
    division={...}&
    organization={...}&
    title={...}&
    manager={...}&
    hire_date={...}&
    invite={...}&
    active={...}

Liệt kê các huy hiệu có sẵn:

GET graph.facebook.com
  /community/badges?fields=id,name,description,icon,category

Liệt kê các hạng mục ở cấp độ gốc:

GET graph.facebook.com
  /community/knowledge_library_categories

Đăng hạng mục mới ở cấp độ gốc:

POST graph.facebook.com
  /community/knowledge_library_categories?
  title={...}&
  icon={...}&
  color={...}&
  json_content={...}

Liệt kê các liên kết đến những công cụ thường dùng và các tài nguyên khác trong Thư viện kiến thức:

GET graph.facebook.com
        /community/knowledge_quick_links?fields=title,link

Đọc một liên kết nhanh cụ thể trong Thư viện kiến thức

GET graph.facebook.com
        /{quick_link_id}?fields=title,link

Thêm một liên kết nhanh mới trong Thư viện kiến thức

POST graph.facebook.com
        /community/knowledge_quick_links?
        title={...}&
        link={...}

Cập nhật một liên kết nhanh cụ thể trong Thư viện kiến thức

POST graph.facebook.com
        /{quick_link_id}?
        title={...}&
        link={...}

Xóa một liên kết nhanh cụ thể trong Thư viện kiến thức

DELETE graph.facebook.com
        /{quick_link_id}