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

Đă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

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

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

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

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.

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.

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

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}