Workplace

社群

路徑 /community

替代路徑 /company

代表您的 Workplace 社群。此 /community 節點（或 /company，可互換運作）將傳回 Group 類型的單一社群物件。為了方便 API，您可以將根社群物件視為其他社團或社群的根社團。

若要尋找您的社群 ID，可以透過發出圖形 API GET 呼叫至 graph.facebook.com/community 並加入自訂整合存取權杖。

在部分情況下，根社群也可包含其他社群，其將出現在根社群的 /groups 關係連線中。根社群的子社群可透過 is_community 欄位與子社團分開來。

根社群中存在一或多個社群，表示此 Workplace 執行個體已啟用社群。

可以依次查詢這些子社群的 /groups 關係連線以取得該社群內的社團。在所有情況下， /groups 關係連線只會顯示該社群的直接後代；不會執行遞歸。

無法透過 API 建立社群，但可以像管理社團成員一樣管理成員。

讀取

GET graph.facebook.com
  /community

權限

社群節點需要讀取社團內容或管理社團權限。

發佈

您無法使用此節點發佈 Workplace 社群。

刪除

您無法使用此節點刪除 Workplace 社群。

更新

您無法使用此節點更新 Workplace 社群。

關係連線

名稱說明

/accounts

使用此關係連線在 Workplace 社群中建立/停用/刪除帳號。佈建用戶帳號權限為此關係連線所需

/admins

Workplace 社群的系統管理員。管理帳號權限為此關係連線所需

/badges

可用的標章清單

/events

Workplace 社群的活動。

/former_members

Workplace 社群之前的成員，其帳號現已停用。

/groups

Workplace 社群中的社團和子社群。

/knowledge_library_categories

根層級類別的清單

/knowledge_quick_links

知識資料庫中常用工具和其他資源的連結清單

/members

Workplace 社群的成員。若要對用戶的外部編號進行篩選，可使用 external_ids 參數

/reported_content

供社群管理員審查的檢舉內容項目清單。請注意，此關係連線已於 2019 年 4 月 30 日停用。

/skills

可以新增至此社群成員的個人檔案中的技能。

例如

建立新的社團

若要建立 Workplace 社群的新社團，可以發出 POST 要求至 /community/groups 關係連線。回應將包含新建立的社團的 ID。請注意，為了讓您的社團顯示任何成員，您必須新增至少一名成員並將該成員設為管理員。

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

取得根社群所有社團和社群的清單：

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

取得根社群所有成員的清單：

GET graph.facebook.com
  /community/members

取得根社群所有成員的清單，以 external_id 篩選：

GET /community/members?
  external_ids=12356,abc123

檢舉內容項目（請注意，此關係連線已於 2019 年 4 月 30 日停用）：

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

新增新社團至根社群：

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

新增新社團至非根社群：

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

佈建帳號：

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

更新帳號需有管理工作個人檔案權限，且應使用以下端點

POST /{member-id}

如需詳細資訊，請參閱帳號管理頁面。

列出可用的標章：

此動作需要管理標章權限

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

列出根層級類別：

此動作需要讀取知識資料庫內容權限

GET graph.facebook.com
  /community/knowledge_library_categories

發佈新的根層級類別：

此動作需要管理知識資料庫內容權限。如需每個欄位值的詳細資料，請參閱此處。

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

列出知識資料庫中常用工具和其他資源的連結：

此動作需要讀取知識資料庫內容權限

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

讀取知識資料庫中的特定快速連結

此動作需要讀取知識資料庫內容權限

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

在知識資料庫中新增新快速連結

此動作需要管理知識資料庫內容權限

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

更新知識資料庫中的特定快速連結

此動作需要管理知識資料庫內容權限

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

刪除知識資料庫中的特定快速連結

此動作需要管理知識資料庫內容權限

DELETE graph.facebook.com
        /{quick_link_id}