커뮤니티

경로 /community

대체 경로 /company

Workplace 커뮤니티를 나타냅니다. /community 노드(또는 /company, 서로 대체 가능)는 그룹 유형의 커뮤니티 개체 하나를 반환합니다. API에서는 편의를 위해 루트 커뮤니티 개체를 다른 그룹이나 커뮤니티의 루트 그룹으로 생각하시면 됩니다.

맞춤 통합 액세스 토큰으로 graph.facebook.com/community에 그래프 API GET 호출을 보내면 자신의 커뮤니티 ID를 찾을 수 있습니다.

어떤 경우에는 루트 커뮤니티가 다른 커뮤니티를 포함할 수도 있으며, 이는 루트 커뮤니티의 /groups 에지에 표시됩니다. 루트 커뮤니티의 하위 커뮤니티는 is_community 필드로 하위 그룹과 구분할 수 있습니다.

루트 커뮤니티 내에 하나 이상의 커뮤니티가 있으면 이 Workplace 인스턴스에 커뮤니티가 활성화되었다는 것을 의미합니다.

이런 하위 커뮤니티는 자신의 /groups 에지에서 순서대로 쿼리되어 해당 커뮤니티 내의 그룹을 가져올 수 있습니다. /groups 에지는 언제나 해당 커뮤니티의 직접적인 하위 요소만 표시합니다. 재귀는 수행하지 않습니다.

커뮤니티는 API를 통해 생성할 수 없지만 멤버는 그룹 멤버와 동일한 방식으로 관리할 수 있습니다.

읽기

GET graph.facebook.com
  /community

권한

커뮤니티 노드는 그룹 콘텐츠 읽기 또는 그룹 관리 권한이 필요합니다.

게시

이 노드를 사용해서 Workplace 커뮤니티를 게시할 수 없습니다.

삭제

이 노드를 사용해서 Workplace 커뮤니티를 삭제할 수 없습니다.

업데이트

이 노드를 사용해서 Workplace 커뮤니티를 업데이트할 수 없습니다.

에지

예

새 그룹 만들기

/community/groups 에지로 POST 요청을 보내서 Workplace 커뮤니티에 새 그룹을 만들 수 있습니다. 응답에는 새로 만든 그룹의 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={...}

사용 가능한 배지의 리스트를 표시하는 예는 다음과 같습니다.

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}