게시물

경로 `/{POST-id}`

Workplace 게시물을 나타냅니다. /{post-id} 노드는 단일 게시물을 반환합니다.

읽기

그룹, 이벤트 또는 사용자 프로필의 게시물을 나타내는 단일 게시물 개체를 반환합니다.

권한

게시물 노드를 읽으려면 그룹 콘텐츠 읽기 권한이 필요합니다. 사용자 프로필의 게시물을 읽으려면 사용자 타임라인 읽기 권한이 필요합니다.

필드

필드 이름	설명	유형
`id`	`{group-id}_{id}` 형식을 사용하는 게시물 ID.	`string`
`created_time`	게시물이 최초로 게시된 시간.	`datetime`
`formatting`	게시물이 형식 지정 마크업 언어를 사용하여 생성되었는지 여부를 나타냅니다. 반환 값은 사용한 마크업 언어를 나타냅니다. Workplace는 마크다운과 일반 텍스트를 지원합니다.	`enum {MARKDOWN\|PLAINTEXT}`
`from`	메시지를 게시한 사용자나 프로필에 대한 정보.	`Profile`
`icon`	이 게시물의 유형을 나타내는 아이콘에 대한 링크.	`url`
`link`	이 게시물에 첨부된 링크.	`url`
`message`	게시물의 상태 메시지.	`string`
`name`	`link`의 이름(게시물에 첨부된 경우).	`string`
`object_id`	게시물에 첨부하여 업로드한 사진 또는 동영상의 ID.	`string`
`permalink_url`	게시물의 퍼머링크 페이지 URL.	`url`
`picture`	게시물과 함께 포함된 `link`에서 스크래핑한 사진.	`url`
`place`	게시물에 첨부된 위치 정보.	`Place`
`poll`	게시물이 설문일 경우, 이 필드는 첨부된 질문 개체를 반환하여 `options`와 사용자가 선택한 `votes` 옵션을 볼 수 있도록 합니다.	`Question`
`properties`	첨부된 동영상의 속성 리스트(예: 동영상 길이).	`object[]`
`status_type`	상태 업데이트 유형에 대한 설명.	`enum {mobile_status_update, created_note, added_photos, added_video, shared_story, created_group, created_event, wall_post, app_created_story, published_story, tagged_in_photo}`
`story`	사용자가 의도적으로 생성하지 않은 스토리의 텍스트.	`string`
`to`	이 게시물에서 언급되거나 타게팅된 프로필.	`Profile[]`
`type`	이 게시물의 개체 유형을 나타내는 문자열.	`enum{link, status, photo, video}`
`updated_time`	게시물이 생성된 시간, 마지막으로 수정된 시간 또는 게시물에 마지막 댓글이 남겨진 시간.	`datetime`

게시

이 에지를 사용하여 게시할 수 없습니다. 그룹에서 새 게시물을 만들려면 /group/feed 에지를 사용합니다.

삭제

/{post_id} 경로에서 DELETE 요청을 보내면 그래프 API를 통해 게시물을 삭제할 수 있습니다.

권한

게시물 노드를 삭제하려면 그룹에 게시 권한, 그리고 모든 콘텐츠 읽기 또는 공개 콘텐츠만 읽기 권한 중 하나가 있어야 합니다. 이는 게시물이 게시된 그룹에 따라 다릅니다.

사용자 타임라인에서 게시물을 삭제하려면 사용자 타임라인 관리 권한이 필요합니다.

업데이트

봇이 생성한 게시물만 업데이트할 수 있으며, 사용자를 대신해 impersonate_token으로 생성한 게시물은 업데이트할 수 없습니다. 본문에 업데이트된 message를 포함하여 /{post-id} 에지에서 POST 요청을 보내면 게시물을 수정할 수 있습니다.

에지

에지 이름	설명
`/attachments`	이 게시물과 연결된 모든 미디어 첨부 파일.
`/comments`	이 게시물의 댓글. 총 개수를 가져오는 `summary` 필드를 지원합니다.
`/reactions`	이 게시물에 공감한 사용자. 총 개수를 가져오는 `summary` 필드를 지원합니다. 어떤 기간 내에 발생한 공감 수를 가져오는 `since=unix_timstamp` 및 `until=unix_timestamp` 필드를 지원합니다.
`/seen`	이 게시물을 본 사용자. 총 개수를 가져오는 `summary` 필드를 지원합니다. 어떤 기간 내에 게시물을 본 사용자 수를 가져오는 `since=unix_timstamp` 및 `until=unix_timestamp` 필드를 지원합니다. 이 경우 여기에서 설명하는 것과 동일한 제한이 적용됩니다.

지원되는 마크다운 구문

Workplace에 게시물을 게시할 때 다음 마크다운 구문이 지원됩니다.

형식 지정	구문
굵게	`Bold`
강조	`Emphasize`
링크	`[Link](https://workplace.fb.com)`
`Inline code`	`Inline code`
`code block`	``` code block ```
리스트	`* List`
번호 지정 리스트	`1. Numbered list`
인용	`> Quote`
제목 1	`# Heading 1`
제목 2	`## Heading 2`

예

게시물의 `ID`, `source` 및 `story` 가져오기

GET graph.facebook.com
  /{post-id}?fields=id,source,story

게시물에서 댓글 가져오기

GET graph.facebook.com
  /{post-id}/comments

총 개수 요약을 포함해서 게시물의 확인된 상태 가져오기

GET graph.facebook.com
  /{group-id}_{post-id}/seen?
  summary=true

그룹에 게시하기

POST graph.facebook.com
  /{group-id}/feed?
  message=Hello+World&
  link=https://developers.facebook.com/docs/workplace/custom-integrations/apps

그룹 게시물에서 사용자 태그하기

POST graph.facebook.com
  /{group-id}/feed?
  message=Hi+@[100013325822531]

마크다운 형식을 지정하여 그룹에 게시하기

POST graph.facebook.com
  /{group-id}/feed?
  message=This+is+a+**formatted**+*post*&
  formatting=MARKDOWN

필드 확장을 사용하여 설문 게시물에서 설문 질문 옵션 및 투표 읽기

GET graph.facebook.com
  /{post-id}?
  fields=message,poll{options{name,vote_count,votes}}

게시물 삭제하기

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

일정 기간 내 발생한 공감/게시물을 확인한 사용자

GET graph.facebook.com
  /{post-id}/seen?
        since=1577836800&
        until=1593561600

게시물

경로 /{POST-id}

읽기

권한

필드

게시

삭제

권한