멤버

경로 `/{member-id}`

사용자 개체를 Workplace 커뮤니티 또는 그룹의 멤버로 나타냅니다.

경로 `/community/members`

모든 현재 사용자 계정의 리스트를 반환합니다. 업무용 프로필 관리 권한이 필요합니다.

`external_id`를 기준으로 필터링합니다.

외부 ID를 기준으로 사용자를 필터링하려면 external_ids 매개변수를 사용하여 원하는 사용자의 외부 ID 리스트(구성 쉼표로 구분됨)를 전달합니다.

경로 `/community/organization_members`

사용자 리스트를 반환합니다. 그룹 멤버 현황 읽기 권한이 필요합니다. 기본적으로 활성 상태의 사용자 계정이 등록됩니다. 비활성화된 사용자 계정은 대신 inactive=1 URL 매개변수를 사용하여 표시할 수 있습니다.

읽기

Workspace 사용자를 나타내는 단일 사용자 개체를 반환합니다. 멤버의 Workspace ID 또는 멤버가 Workspace에 로그인할 때 사용한 이메일 주소를 통해 액세스할 수 있습니다.

/{member_id}
/{email_address}

권한

멤버에 대한 정보를 읽으려면 업무용 프로필 읽기 또는 계정 관리 권한이 필요합니다. 통합에서 계정 관리 권한을 사용하고 특정 그룹으로 범위를 지정하는 경우 일부 멤버 필드에는 액세스할 수 없습니다.

필드

필드 이름	설명	유형
`id`	사용자 계정의 ID입니다.	`string`
`first_name`	사용자의 이름입니다.	`string`
`last_name`	사용자의 성입니다.	`string`
`email`	사용자의 기본 이메일 주소로, Workspace에서 사용자 이름으로 사용할 수도 있습니다.	`string`
`title`	계정 관리 API를 통해 설정된 경우 Workspace에서 사용자의 직책입니다.	`string`
`organization`	계정 관리 API를 통해 설정된 경우 Workspace에서 사용자의 조직입니다.	`string`
`division`	계정 관리 API를 통해 설정된 경우 Workspace에서 사업부입니다.	`string`
`department`	계정 관리 API를 통해 설정된 경우 Workspace에서 부서명입니다.	`string`
`primary_phone`	사용자의 기본 등록된 전화번호입니다. `phoneNumbers` 항목으로 매핑됩니다. 이는 계정 관리 API에서 `primary`로 표시됩니다.	`string`
`primary_address`	사용자의 기본 등록된 주소입니다. `addresses` 항목으로 매핑됩니다. 이는 계정 관리 API에서 `primary`로 표시됩니다.	`string`
`picture`	사용자의 프로필 사진입니다.	`url`
`link`	사용자 프로필 링크입니다.	`url`
`locale`	사용자의 로캘입니다.	`string`
`name`	사용자의 전체 이름입니다.	`string`
`name_format`	중국어, 일본어 또는 한국어 순서를 올바르게 처리하도록 형식이 지정된 사용자의 이름입니다.	`string`
`updated_time`	업데이트된 시간입니다.	`datetime`
`account_invite_time`	UTC 형식의 계정 초대 시간입니다.	`datetime`
`account_claim_time`	UTC 형식의 계정 클레임 시간입니다.	`datetime`
`account_deactivate_time`	UTC 형식의 계정 비활성화 시간입니다.	`datetime`
`external_id`	고객이 정의한 멤버의 식별자입니다. 각 멤버에는 계정 관리 API를 사용하여 설정한 비어 있지 않은 external_id 값이 포함될 수 있습니다. external_id 속성 값은 Workplace에서 지정하지 않습니다.	`string`
`start_date`	계정 관리 API를 통해 설정된 경우 사용자가 회사에 입사한 날짜와 시간입니다.	`datetime`
`about`	사용자에 대한 소개입니다.	`string`
`cost_center`	비용 센터의 이름을 식별합니다.	`string`
`impersonate_token`	통합에서 특정 사용자를 대신하여 호출을 보낼 수 있는 멤버 액세스 토큰입니다. 사칭은 사용 중단된 권한입니다. 이 권한을 사용하여 새 기능을 빌드하지 마세요. 이 권한은 현재 해당 권한을 활성화한 맞춤 통합에만 제공합니다.	`string`
`claim_link`	사용자가 이동하여 Workplace 계정을 클레임할 수 있는 링크를 제공합니다(클레임하지 않은 사용자에게만 제공).	`string`
`access_code`	사용자가 이동하여 Workplace 계정을 클레임할 수 있는 액세스 코드를 제공합니다(클레임하지 않은 사용자에게만 제공).	`string`
`work_locale`	사용자의 로캘입니다. 사용자의 로캘을 확인하는 다른 방법이 생길 때까지 Workplace가 해당 사용자에 대해 사용하는 로캘입니다(예: 브라우저, 기기 언어 설정).	`string` 유효한 값은 'ISO 639-1 2자 언어 코드_ISO 3166-1 2자 국가 코드'의 형식을 취합니다. 예를 들어 en_US는 영어와 미국을 나타냅니다.
`frontline`	사용자 현장 근무 상태에 대한 정보입니다.	`object`(아래 예시 참조)
`active`	사용자 계정이 활성화되었는지 여부입니다.	`boolean`

게시

계정 관리 API(그래프)를 참조하세요.

삭제

계정 관리 API(그래프)를 참조하세요.

업데이트

계정 관리 API(그래프)를 참조하세요.

에지

에지 이름	설명
`/events`	이 사용자에 대한 이벤트입니다. 기본적으로 사용자가 거절하거나 응답하지 않은 이벤트는 포함하지 않습니다.
`/feed`	이 사용자가 게시한 게시물(상태 업데이트 포함)과 링크의 피드입니다.
`/conversations`	사용자 또는 봇 페이지의 Workplace Messages입니다. 사용자의 대화를 보기 위한 모든 메시지 읽기 권한이 필요합니다.
`/managers`	사용자의 등록된 관리자(들)입니다.
`/reports`	사용자의 등록된 보고서입니다.
`/photos`	멤버의 프로필 사진입니다.
`/groups`	멤버와 관련된 그룹입니다.
`/phones`	멤버와 관련된 전화번호입니다.
`/skills`	멤버의 기술입니다.
`/badges`	사용자에게 부여된 배지입니다.
`/logout`	Workplace에서 사용자를 로그아웃시킵니다(`POST`만 해당).
`/remove_profile_information`	비활성화된 사용자의 프로필 정보를 삭제합니다(`POST`만 해당).

예

커뮤니티 멤버에 대한 정보 가져오기

특정 멤버의 이름과 이메일 주소를 가져옵니다.

GET /{member_id}?fields=email,name HTTP/1.1
Host: graph.facebook.com

해당 이메일 주소에서 멤버의 ID를 가져옵니다.

GET /{email_address} HTTP/1.1
Host: graph.facebook.com

사용자의 외부 ID에 기준으로 회사 멤버를 나열합니다.

GET /community/members?external_ids=12356,abc123 HTTP/1.1
Host: graph.facebook.com

비활성화된 계정을 포함하여 회사 멤버를 나열합니다.

GET /community/organization_members?inactive=1 HTTP/1.1
Host: graph.facebook.com

멤버의 이벤트를 가져옵니다.

GET graph.facebook.com
      /{member-id}/events

사용자의 관리자와 보고서에 대한 정보를 가져옵니다.

특정 멤버의 보고서를 가져옵니다.

GET /{member_id}/reports HTTP/1.1
Host: graph.facebook.com

특정 멤버의 관리자를 가져옵니다.

GET /{member_id}/managers HTTP/1.1
Host: graph.facebook.com

멤버에 대한 메시지를 가져옵니다.

메시지, 보낸 사람, 첨부 파일을 포함하여 멤버에 대한 대화를 가져옵니다.

모든 메시지 읽기 권한이 있는 맞춤 통합 토큰이 필요합니다.

GET graph.facebook.com
      /{member-id}/conversations?fields=messages{message,attachments,from}

스레드별로 멤버의 대화 스레드 ID를 가져옵니다.

모든 메시지 읽기 권한이 있는 맞춤 통합 토큰이 필요합니다.

GET graph.facebook.com
      /{member-id}/conversations

특정 사용자의 특정 스레드 ID에 대한 메시지를 가져옵니다.

모든 메시지 읽기 권한이 있는 맞춤 통합 토큰이 필요합니다.

GET graph.facebook.com
      /{thread-id}/messages?user={user-id}

메시지와 첨부 파일을 포함하여 봇 페이지에 대한 대화를 가져옵니다.

GET graph.facebook.com
      /me/conversations?fields=messages{message,attachments}

맞춤 통합 토큰 사용 시 /me 별칭은 봇 페이지를 가리킵니다.

맞춤 통합 토큰을 사용하여 멤버의 받은 메시지함에서 특정 메시지를 삭제합니다.

채팅 메시지 삭제 권한이 있는 맞춤 통합 토큰이 필요합니다.

DELETE graph.facebook.com
      /{message-id}?user={user-id}

'메시지만 삭제'는 요청에서 지정된 멤버의 보기에 표시되는 메시지만 삭제합니다. 메시지를 모두 삭제하려면 해당 메시지에 대한 각 멤버의 보기를 삭제해야 합니다.

멤버가 초대되고 해당 계정이 클레임된 날짜와 시간을 가져옵니다.

계정 관리 권한이 있는 맞춤 통합 토큰이 필요합니다.

GET graph.facebook.com
      /{member-id}?fields=account_invite_time,account_claim_time

이러한 필드는 멤버가 초대되거나 해당 계정을 클레임한 경우에만 표시됩니다.

멤버 계정이 비활성화된 날짜와 시간을 가져옵니다.

계정 관리 권한이 있는 맞춤 통합 토큰이 필요합니다.

GET graph.facebook.com
      /{member-id}?fields=account_deactivate_time

이러한 필드는 멤버 계정이 비활성화된 경우에만 존재합니다.

Workplace에서 사용자를 로그아웃시킵니다.

로그아웃 권한이 있는 액세스 토큰이 필요합니다.

POST graph.facebook.com
      /{member-id}/logout

프로필 사진을 설정합니다.

업무용 프로필 관리 권한이 있는 액세스 토큰이 필요합니다. 요청 내에서 URL과 파일 업로드를 모두 지원합니다.

POST graph.facebook.com
      /{member-id}/profile_pictures?
      image_url={...}&
      caption={...}

POST graph.facebook.com
      /{member-id}/profile_pictures?
      caption={...}
Content-Type: multipart/form-data;
Content-Disposition: form-data; name="image_data"; filename="/profile_picture.png

멤버의 휴대폰을 추가합니다.

업무용 프로필 관리 권한이 있는 액세스 토큰이 필요합니다.

POST graph.facebook.com
      /{member-id}/phones?
      type={...}&
      primary={...}&
      number={...}

멤버의 기술을 가져옵니다.

업무용 프로필 읽기 권한이 있는 액세스 토큰이 필요합니다.

GET graph.facebook.com
      /{member-id}/skills

기술을 추가합니다.

업무용 프로필 관리 권한이 있는 액세스 토큰이 필요합니다.

POST graph.facebook.com
      /{member-id}/skills?name={...}

기술을 삭제합니다.

업무용 프로필 관리 권한이 있는 액세스 토큰이 필요합니다.

DELETE graph.facebook.com
      /{member-id}/skills?name={...}

멤버의 배지를 가져옵니다.

업무용 프로필 읽기 권한이 있는 액세스 토큰이 필요합니다.

GET graph.facebook.com
      /{member-id}/badges?fields=id,name,description,icon,category

사용자에게 기본으로 제공되는 배지를 부여합니다.

배지 관리 권한이 있는 액세스 토큰이 필요합니다. 사용 가능한 배지와 ID의 리스트는 커뮤니티 문서를 참조하세요.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_champion

사용자에게 맞춤 배지를 부여합니다.

배지 관리 권한이 있는 액세스 토큰이 필요합니다. 사용 가능한 배지와 ID의 리스트는 커뮤니티 문서를 참조하세요. 참고로, URL의 #은 URL로 인코딩해야 합니다.

POST graph.facebook.com
      /{member-id}/badges?badge=workplace_custom#{badge_id}

멤버를 비활성화합니다.

사용자 계정 프로비저닝 권한이 있는 액세스 토큰이 필요합니다.

POST graph.facebook.com
      /{member-id}?active=false

멤버를 삭제합니다.

사용자 계정 프로비저닝 권한이 있는 액세스 토큰이 필요합니다.

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

클레임되지 않은 멤버만 삭제할 수 있습니다.

사용자의 현장 근무 상태를 가져옵니다.

GET graph.facebook.com
      /{user-id}?fields=frontline
      
    {
      "frontline": {
        "is_frontline": true
      },
    "id": "100038142594104"
    }

멤버

경로 /{member-id}

경로 /community/members

external_id를 기준으로 필터링합니다.

경로 /community/organization_members

읽기

권한

필드

게시

삭제

업데이트

에지

예

커뮤니티 멤버에 대한 정보 가져오기

특정 멤버의 이름과 이메일 주소를 가져옵니다.

해당 이메일 주소에서 멤버의 ID를 가져옵니다.

사용자의 외부 ID에 기준으로 회사 멤버를 나열합니다.

비활성화된 계정을 포함하여 회사 멤버를 나열합니다.

멤버의 이벤트를 가져옵니다.

사용자의 관리자와 보고서에 대한 정보를 가져옵니다.

특정 멤버의 보고서를 가져옵니다.

특정 멤버의 관리자를 가져옵니다.

멤버에 대한 메시지를 가져옵니다.

메시지, 보낸 사람, 첨부 파일을 포함하여 멤버에 대한 대화를 가져옵니다.

스레드별로 멤버의 대화 스레드 ID를 가져옵니다.

특정 사용자의 특정 스레드 ID에 대한 메시지를 가져옵니다.

메시지와 첨부 파일을 포함하여 봇 페이지에 대한 대화를 가져옵니다.

맞춤 통합 토큰을 사용하여 멤버의 받은 메시지함에서 특정 메시지를 삭제합니다.

멤버가 초대되고 해당 계정이 클레임된 날짜와 시간을 가져옵니다.

멤버 계정이 비활성화된 날짜와 시간을 가져옵니다.

Workplace에서 사용자를 로그아웃시킵니다.

프로필 사진을 설정합니다.

멤버의 휴대폰을 추가합니다.

멤버의 기술을 가져옵니다.

기술을 추가합니다.

기술을 삭제합니다.

멤버의 배지를 가져옵니다.

사용자에게 기본으로 제공되는 배지를 부여합니다.

사용자에게 맞춤 배지를 부여합니다.

멤버를 비활성화합니다.

멤버를 삭제합니다.

사용자의 현장 근무 상태를 가져옵니다.

경로 `/{member-id}`

경로 `/community/members`

`external_id`를 기준으로 필터링합니다.

경로 `/community/organization_members`