Workplace

그룹

경로 /{group-id}

Workplace 그룹을 나타냅니다. /{group-id} 노드는 하나의 그룹을 반환합니다.

기업 간 협력 그룹

기업 간 협력 그룹에 액세스할 때 생각해야 할 특정한 고려 사항이 있습니다.

  • 그룹 콘텐츠는 기업 간 협력 그룹에 포함된 기업에 설치된 모든 앱 통합에서 읽을 수 있습니다.
  • 기업 간 협력 그룹은 일반 그룹과 함께 커뮤니티 또는 그룹에 리스트로 표시됩니다.
    • purpose 필드는 기업 간 협력 그룹을 식별하는 데 사용할 수 있습니다. 이 값은 WORK_MULTI_COMPANY로 설정됩니다.
  • 그룹 멤버도 쿼리할 수 있지만 다른 회사에서 사용자에게 제공하는 앱이라면 id, name 및 picture만 표시됩니다.
  • 그룹 관리 권한이 있는 통합은 기업 간 협력 그룹 멤버를 추가하고 제거할 수 있습니다.
    • 통합은 통합을 설치한 커뮤니티의 멤버인 사용자만 추가하고 제거할 수 있습니다.
    • 그룹 관리자 중 한 명이 통합을 설치한 커뮤니티의 멤버일 경우에만 통합에서 사용자를 추가하고 제거할 수 있습니다.
  • 그룹 콘텐츠 관리 권한이 있는 통합은 다음과 같은 경우 중 하나에 해당하면 기업 간 협력 그룹에 포함된 콘텐츠를 삭제할 수 있습니다.
    • 콘텐츠가 앱 커뮤니티의 멤버에게 속하는 경우
    • 또는, 앱 커뮤니티 멤버가 그룹 관리자인 경우
  • 현재는 기업 간 협력 그룹에 게시할 수 없습니다.
  • 기업 간 협력 그룹은 통합의 그룹 범위 설정에서 선택할 수 있습니다.
  • 기업 간 협력 그룹에서는 봇을 언급할 수 없습니다.

읽기

그래프 API GET 요청을 /{group-id}로 보내서 그룹에 대한 정보를 읽을 수 있습니다.

권한

그룹 노드를 읽으려면 그룹 콘텐츠 읽기 권한이 필요합니다.

필드

필드 이름설명데이터 유형

id

그룹 ID.

string

cover

그룹 커버 사진에 대한 정보

CoverPhoto

cover_url

그룹 표지 사진의 이미지에 포함된 URL.

string

description

그룹에 대한 간단한 설명.

string

icon

그룹 아이콘의 URL.

url

is_workplace_default

그룹이 기본 Workplace 그룹인지 표시합니다(읽기 전용).

boolean

is_community

그룹이 커뮤니티이고 다른 그룹을 포함할 수 있는지 표시합니다(읽기 전용).

boolean

name

그룹 이름.

string

owner

이 그룹을 생성한 멤버.

User

privacy

그룹의 공개 범위 설정. 가능한 값:

  • CLOSED
  • OPEN
  • SECRET

string

updated_time

마지막으로 그룹이 업데이트된 시간. 여기에는 그룹 속성 변경 사항과 게시물 및 댓글의 변경 사항이 포함됩니다.

datetime

archived

그룹이 보관되었는지 표시합니다.

boolean

post_requires_admin_approval

그룹 게시물에 관리자 승인이 필요한지 나타냅니다.

boolean

purpose

그룹의 목적을 나타냅니다.

enum {WORK_ANNOUNCEMENT, WORK_FEEDBACK, WORK_TEAMWORK, WORK_SOCIAL, WORK_MULTI_COMPANY}


사용 중단: WORK_FOR_SALE, WORK_TEAM

post_permissions

게시물에 관리자 승인이 필요한지 표시합니다.

enum {NONE, ADMIN_ONLY}

join_setting

새 멤버가 그룹에 참여하는 방식을 표시합니다.

enum {NONE, ANYONE, ADMIN_ONLY}

sorting_setting

/feed 에지에 반환된 게시물의 순서를 나타냅니다. 기본값은 CHRONOLOGICAL입니다.

enum {RECENT_ACTIVITY, CHRONOLOGICAL}

is_official_group

그룹이 공식 Workplace 그룹인지 표시합니다. 공식 그룹 아이콘이 제품에서 공식 그룹의 이름과 함께 표시됩니다.

boolean

게시

이 에지를 사용하여 게시할 수 없습니다. 그룹을 만들려면/community/groups 에지에 게시합니다.

삭제

이 노드를 사용하여 그룹을 삭제할 수 없습니다. 그룹의 마지막 멤버를 제거하면 해당 그룹이 자동 삭제됩니다.

업데이트

그래프 API POST 요청을 /{group-id}에 보내고 값을 전달하여 요청 본문의 필드를 업데이트함으로써 그룹을 업데이트합니다.

권한

그룹 노드를 업데이트하려면 그룹 관리 권한이 필요합니다.

에지

에지 이름설명

/admins

Workplace 그룹의 관리자. Workplace에서 지원되는 관리자의 추가 및 삭제. 아래의 예시를 참조하세요.

/albums

Workplace 그룹의 사진첩.

/auto_membership_rules

그룹에 멤버를 자동 추가하기 위한 규칙.

/docs

Workplace 그룹의 문서.

/events

Workplace 그룹의 이벤트.

/feed

피드에 정렬된 Workplace 그룹의 게시물.

/files

Workplace 그룹에 공유된 파일.

/member_requests

멤버십 승인의 활성화된 그룹의 대기 중인 멤버십 가입 요청.

/members

Workplace 그룹의 멤버. 이 에지는 다음 정보를 노출합니다.

  • administrator: 이 사용자가 그룹 관리자일 경우 표시됩니다.
  • joined: 이 사용자가 그룹에 가입했을 때 표시됩니다.
  • moderator: 이 사용자가 그룹의 댓글 관리자인 경우 표시됩니다.
  • added_by: 이 사용자를 그룹에 추가한 사용자가 표시됩니다.

/moderators

Workplace 그룹의 댓글 관리자.

/pinned_posts

그룹에 고정된 게시물.

/groups

하위 그룹 리스트(커뮤니티인 그룹에만 적용)

예

그룹 ID, 이름, 아카이브 상태, 공개 범위 가져오기:

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

그룹 보관하기:

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

이름, ID 및 가입 날짜를 포함해 그룹 멤버 가져오기:

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

한 번의 호출에서 그룹 관리자와 댓글 관리자 가져오기:

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

그룹 문서 가져오기:

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

그룹 게시물 가져오기:

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

마지막 업데이트된 순서대로 그룹 게시물 가져오기:

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

매개변수

sorting_setting

RECENT_ACTIVITY로 설정했을 때 생성된 시점이 아니라 마지막으로 업데이트된 시점을 기준으로 게시물 정렬을 허용합니다. 기본 동작은 CHRONOLOGICAL을 값으로 사용하여 명시적으로 설정할 수 있습니다. 업데이트에는 게시물 편집, 추가된 댓글 또는 공감을 포함할 수 있습니다.

동영상, 이미지, 파일 또는 설문 등의 추가적인 첨부 파일을 포함한 그룹 게시물 가져오기:

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

설문 옵션은 각 옵션의 투표 수에 따라 내림차순 리스트로 표시됩니다.

가입 날짜와 함께 그룹 멤버 리스트 가져오기:

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

ID로 그룹에 멤버 추가하기:

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

이메일로 그룹에 멤버 추가하기:

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

요청을 위해 URL에 이메일 주소를 포함할 경우, 이메일 주소가 URL 인코딩되는지 확인하세요. 예: michael@example.com은 michael%40example.com이 됩니다.

그룹에서 마지막 멤버를 삭제하면 해당 그룹이 삭제를 위해 예약됩니다.

ID로 그룹에서 멤버 제거하기:

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

이메일로 그룹에서 멤버 제거하기:

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

요청을 위해 URL에 이메일 주소를 포함할 경우, 이메일 주소가 URL 인코딩되는지 확인하세요. 예: michael@example.com은 michael%40example.com이 됩니다.

멤버를 그룹 관리자로 승격하기:

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

관리자를 그룹 멤버로 강등하기:

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

그룹에서 새 이벤트 만들기:

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

(바이너리를 통해) 새 사진을 그룹에 업로드하기:

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

(URL을 통해) 새 사진을 그룹에 업로드하기:

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

이미지 및 동영상 첨부 파일을 포함한 그룹 게시물 만들기:

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

매개변수

attached_media

사진 및 동영상에 사용, 괄호로 묶은 media_fbids의 배열. 지원하는 이미지 형식: .jpeg, .bmp, .png, .gif, .tiff. 이미지 형식에 대한 자세한 내용은 여기를 참조하세요. 지원되는 동영상 파일에 대한 자세한 내용은 여기를 참조하세요. 이미지에 대한 media_fbids를 가져오려면 먼저 게시되지 않은 사진을 https://graph.facebook.com/me/photos로 게시하세요. 이 문서의 설명을 참조하세요. 동영상(애니메이션 GIF 포함)에 대한 media_fbids를 가져오려면 먼저 동영상을 https://graph.facebook.com/me/videos?no_story=true에 게시하세요.

no_story 매개변수를 true로 설정하면 사용자가 앱을 사용하여 동영상을 업로드할 때 사용자 프로필에 자동으로 생성된 피드 스토리가 숨겨집니다.

파일 첨부 파일을 포함한 그룹 게시물 만들기:

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

매개변수

files

파일에 사용, file_ids의 배열(괄호로 묶지 않음). 현재 파일 버전 관리는 지원되지 않습니다. 파일을 업데이트하려면 원본 파일을 게시물 첨부 파일에서 제거하고 새 첨부 파일을 다시 업로드하세요. 지원되는 파일 형식:

  • 문서: .pdf, .csv, .tsv, .docx, .pptx, .xlsx
  • 이미지: .jpeg, .png
  • 동영상: .mp4
  • 보관: .rar, .zip

file_ids를 가져오려면 먼저 파일을 https://graph.facebook.com/group_file_revisions에 게시하세요. 로컬 컴퓨터에서 소스 파일을 게시할 수도 있습니다.

하나의 API 호출에서 attached_media와 files 매개변수를 결합할 수 없습니다. 이는 그룹 작성 도구의 동작을 모방하며, '사진/동영상'과 '파일'을 업로드하기 위한 별도의 옵션이 있습니다.

게시물 권한, 가입 설정, 목적 및 게시물 승인 설정 업데이트

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

핀으로 고정된 게시물에 대한 공감과 댓글 가져오기

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

그룹이 커뮤니티인지 식별

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

멤버십 가입 규칙을 그룹에 가져오기

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

응답 예시(JSON):

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

그룹의 자동 멤버십 규칙 삭제

DELETE graph.facebook.com
  /RULE_ID

멤버십 가입 규칙을 그룹에 적용

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

페이로드 예시:

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

이 API는 실수할 경우 수천 명의 사용자가 그룹에 추가될 수 있습니다. 그러므로 매우 신중하게 사용하고 API 호출을 실행하기 전에 다시 한번 확인하세요.

그룹 ID 및 공식 그룹 상태 가져오기:

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

공식 그룹 상태 업데이트:

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