그래프 API 버전

그룹

Facebook 그룹입니다.

읽기

단일 그룹 개체에 대한 정보를 반환합니다. 사용자 관리자 그룹 리스트를 가져오려면 /user/groups 에지를 대신 사용하세요.

그래프 API 탐색기
GET /v19.0/{group-id} HTTP/1.1
Host: graph.facebook.com
/* PHP SDK v5.0.0 */
/* make the API call */
try {
  // Returns a `Facebook\FacebookResponse` object
  $response = $fb->get(
    '/{group-id}',
    '{access-token}'
  );
} catch(Facebook\Exceptions\FacebookResponseException $e) {
  echo 'Graph returned an error: ' . $e->getMessage();
  exit;
} catch(Facebook\Exceptions\FacebookSDKException $e) {
  echo 'Facebook SDK returned an error: ' . $e->getMessage();
  exit;
}
$graphNode = $response->getGraphNode();
/* handle the result */
/* make the API call */
FB.api(
    "/{group-id}",
    function (response) {
      if (response && !response.error) {
        /* handle the result */
      }
    }
);
/* make the API call */
new GraphRequest(
    AccessToken.getCurrentAccessToken(),
    "/{group-id}",
    null,
    HttpMethod.GET,
    new GraphRequest.Callback() {
        public void onCompleted(GraphResponse response) {
            /* handle the result */
        }
    }
).executeAsync();
/* make the API call */
FBSDKGraphRequest *request = [[FBSDKGraphRequest alloc]
                               initWithGraphPath:@"/{group-id}"
                                      parameters:params
                                      HTTPMethod:@"GET"];
[request startWithCompletionHandler:^(FBSDKGraphRequestConnection *connection,
                                      id result,
                                      NSError *error) {
    // Handle the result
}];

권한

  • groups_access_member_info — 앱이 그룹 콘텐츠에서 멤버 관련 데이터를 수신할 수 있도록 지원합니다.
  • publish_to_groups — 앱이 사용자를 대신해 그룹에 콘텐츠를 게시하도록 지원합니다.

공개 그룹과 비공개 그룹

사용자 액세스 토큰

비밀 그룹

그룹 관리자용 사용자 액세스 토큰

주의 사항

  • 사용자 정보를 반환하는 필드는 그룹 관리자의 액세스 토큰으로 요청을 보내지 않으면 어떠한 응답에도 포함되지 않습니다.

필드

속성 이름 설명 유형

id

그룹 ID

string

cover

그룹 커버 사진에 대한 정보

CoverPhoto

id

이 커버 사진을 나타내는 사진의 ID

string

source

이 커버 사진을 나타내는 사진의 URL

string

offset_y

바닥에서부터 사진의 수직 오프셋(픽셀 단위)

int

offset_x

왼쪽에서부터 사진의 수평 오프셋(픽셀 단위)

int

description

그룹에 대한 간단한 설명

string

email

그룹에 콘텐츠를 업로드하기 위한 이메일 주소. 그룹의 현재 멤버만 사용할 수 있습니다.

string

icon

그룹 아이콘의 URL

string

member_count

그룹 내 멤버 수

int

member_request_count

대기 중인 멤버 요청 수. 그룹 관리자의 액세스 토큰이 필요합니다. 대기 중인 멤버 요청 수가 50개를 초과하는 경우에만 숫자가 반환됩니다.

int

name

그룹 이름

string

owner

v9.0+에서 사용 중단되었습니다. 2021년 2월 9일에 모든 버전에서 사용 중단됩니다.

User | Page

parent

그룹의 상위 그룹(해당할 경우)

Group | Page

permissions

그룹에 설치된 앱에 대해 사용자가 부여한 권한

string

privacy

그룹의 공개 범위 설정. 가능한 값은 CLOSED, OPENSECRET입니다. 그룹 관리자의 액세스 토큰이 필요합니다.

string

updated_time

그룹이 마지막으로 업데이트된 시각(그룹 속성, 게시물, 댓글 변경 사항 포함). 그룹 관리자의 액세스 토큰이 필요합니다.

datetime

만들기

지원되지 않는 작업입니다.

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.

에지

이름 설명

/admins

이 에지는 2018년 4월 4일에 사용 중단되었습니다.

/albums

그룹이 소유한 사진첩

/docs

그룹이 소유한 문서

/events

그룹이 소유한 이벤트

/feed

그룹이 소유한 게시물 피드

/files

그룹이 소유한 파일

/live_videos

그룹이 소유한 라이브 방송

/members

이 에지는 2018년 4월 4일에 사용 중단되었습니다.

/photos

그룹이 소유한 사진

/videos

그룹이 소유한 동영상