グラフAPIバージョン

グループ

Facebookグループ

読み取り

単一のグループオブジェクトに関する情報を戻します。ユーザーが管理するグループのリストを取得するには、代わりに/user/groupsエッジを使用します。

グラフAPIエクスプローラ
GET /v21.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

グループのプライバシー設定。指定できる値は、CLOSEDOPENSECRETです。グループの管理者のアクセストークンが必要です。

string

updated_time

グループの最終更新日時 (グループのプロパティの変更、投稿、コメントを含む)。グループの管理者のアクセストークンが必要です。

datetime

作成

この操作はサポートされていません。

アップデート

この操作はサポートされていません。

削除

この操作はサポートされていません。

エッジ

名称 説明

/admins

このエッジは、2018年4月4日に廃止されました。

/albums

グループが所有する写真アルバム。

/docs

グループが所有するドキュメント。

/events

グループが所有するイベント。

/feed

グループが所有する投稿のフィード。

/files

グループが所有するファイル。

/live_videos

グループが所有するライブ動画。

/members

このエッジは、2018年4月4日に廃止されました。

/photos

グループが所有する写真。

/videos

グループが所有する動画。