この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。

Group Members—Private

非公開グループのメンバーシップを要求するか、非公開グループへの参加要求の状況を取得します。

非公開グループのメンバーシップを要求するには、Group Members リソースを使用します。

メモ

リソース

1/chatter/groups/groupId/members/requests

1/connect/communities/communityId/chatter/groups/groupId/members/requests

適用開始バージョン

27.0

Chatter が必要かどうか

はい

HTTP メソッド

GET、HEAD、および POST

GET の要求パラメータ

パラメータ名	型	説明	適用開始バージョン
`status`	String	省略可能。このパラメータを含めると、指定した状況と一致するものを含むように結果が絞り込まれます。有効な値は次のとおりです。 `Accepted` `Declined` `Pending`	27.0

GET または HEAD のレスポンスボディ

Group Membership Request Collection

POST のレスポンスボディ

Group Membership Request

次の表に、このリソースに固有の HTTP 応答コードの説明を示します。他の HTTP 応答コードの説明は、「状況コードとエラー応答」を参照してください。

HTTP 応答コード	説明
201	次のいずれかになります。成功ユーザは、このグループに対してメンバーシップを要求済みです。
204	ユーザは、すでにこのグループのメンバーです。
403	次のいずれかになります。非公開のグループ: `INSUFFICIENT_ACCESS_OR_READONLY` 外部ユーザ: `INSUFFICIENT_ACCESS`

GET の例

次の例は、この非公開グループに対して承認されたすべての参加要求に関する情報を取得します。

1/chatter/groups/0F9D00000000izfKAA/members/requests?status=Accepted

JSON Group Membership Request Collection レスポンスボディには、ユーザ Gordon Johnson からの 1 つの要求が含まれます。

1{
2   "requests": [{
3      "createdDate": "2012-10-19T00:23:23.000Z",
4      "id": "0I5D000000002fmKAA",
5      "lastUpdateDate": "2012-10-19T00:24:06.000Z",
6      "requestedGroup": {
7         "id": "0F9D00000000izfKAA",
8         "url": "/services/data/v36.0/chatter/groups/0F9D00000000izfKAA"
9      },
10      "responseMessage": null,
11      "status": "Accepted",
12      "url": "/services/data/v36.0/chatter/group-membership-requests/0I5D000000002fmKAA",
13      "user": {
14         "companyName": "Universal Containers",
15         "firstName": "Gordon",
16         "id": "005D0000001LLO1IAO",
17         "isActive": true,
18         "lastName": "Johnson",
19         "motif": {
20            "color": "1797C0",
21            "largeIconUrl": "/img/icon/profile64.png",
22            "mediumIconUrl": "/img/icon/profile32.png",
23            "smallIconUrl": "/img/icon/profile16.png"
24         },
25         "mySubscription": {
26            "id": "0E8D0000000T5ZUKA0",
27            "url": "/services/data/v36.0/chatter/subscriptions/0E8D0000000T5ZUKA0"
28         },
29         "name": "Gordon Johnson",
30         "photo": {
31            "fullEmailPhotoUrl": "https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cPhK
32rC7plNhUw5eOz7Aj1u-zWLMxsSybO7lwUPg5_Xne",
33            "largePhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/F",
34            "photoVersionId": "729D00000000LJLIA2",
35            "smallPhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/T",
36            "standardEmailPhotoUrl": "https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0
37cPhKrC7plNhUw5eOz7Aj1u_2Vnyzx4jZ2zFiKBz_sTt2",
38            "url": "/services/data/v36.0/chatter/users/005D0000001LLO1IAO/photo"
39         },
40         "title": "VP Sales",
41         "type": "User",
42         "url": "/services/data/v36.0/chatter/users/005D0000001LLO1IAO",
43         "userType": "Internal"
44      }
45   }],
46   "total": 1
47}

POST の例

次の例は、ID が 0F9D00000000lpK である非公開グループのメンバーシップを要求します。

1/chatter/groups/0F9D00000000lpK/members/requests

JSON 形式の Group Membership Request レスポンスボディです。

1{
2   "createdDate": "2013-04-02T23:44:25.000Z",
3   "id": "0I5D000000002kOKAQ",
4   "lastUpdateDate": "2013-04-02T23:44:25.000Z",
5   "requestedGroup": {
6      "id": "0F9D00000000lpKKAQ",
7      "url": "/services/data/v36.0/chatter/groups/0F9D00000000lpKKAQ"
8   },
9   "responseMessage": null,
10   "status": "Pending",
11   "url": "/services/data/v36.0/chatter/group-membership-requests/0I5D000000002kOKAQ",
12   "user": {
13      "companyName": "Universal Containers",
14      "firstName": "Gordon",
15      "id": "005D0000001LLO1IAO",
16      "isActive": true,
17      "isInThisCommunity": true,
18      "lastName": "Johnson",
19      "motif": {
20         "color": "1797C0",
21         "largeIconUrl": "/img/icon/profile64.png",
22         "mediumIconUrl": "/img/icon/profile32.png",
23         "smallIconUrl": "/img/icon/profile16.png"
24      },
25      "mySubscription": null,
26      "name": "Gordon Johnson",
27      "photo": {
28         "fullEmailPhotoUrl": "https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cPhKrC7plNhUw5eOz7Aj1u-oFL0K-ff2oe04ZAmT2MqC",
29         "largePhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/F",
30         "photoVersionId": "729D00000000LJLIA2",
31         "smallPhotoUrl": "https://instance_name/profilephoto/729D00000000LJL/T",
32         "standardEmailPhotoUrl": "https://instance_name/ncsphoto/SqRfG_-PUTY6KtfOp_f0cPhKrC7plNhUw5eOz7Aj1u-6d5rE2mNaMaBZfGnFX65O",
33         "url": "/services/data/v36.0/chatter/users/005D0000001LLO1IAO/photo"
34      },
35      "title": "VP Sales",
36      "type": "User",
37      "url": "/services/data/v36.0/chatter/users/005D0000001LLO1IAO",
38      "userType": "Internal"
39   }
40}

Chatter REST API 開発者ガイド

Group Members—Private

関連項目: