参加者
The Participants resource is a subresource of a Rooms instance resource. It represents participants currently connected to a given Room. A Participant instance resource represents an individual Room participant.
The Participant Instance resource lets you kick Participants out of a Room they are connected to. You can query the Participants List resource to get a list of participants currently connected
to the Room. You can also get a list of Participants that are disconnected
from the Room.
Participantインスタンス リソース
This resource represents a single Room participant, identified by the ParticipantSid or a ParticipantIdentity.
リソースURI
/v1/Rooms/{RoomNameOrSid}/Participants/{ParticipantIdentityOrSid}/
リソースのプロパティ
Resource Properties in REST API format | |
---|---|
sid
|
The unique string that we created to identify the RoomParticipant resource. |
room_sid
|
The SID of the participant's room. |
account_sid
|
The SID of the Account that created the RoomParticipant resource. |
status
|
The status of the Participant. Can be: |
identity
|
The application-defined string that uniquely identifies the resource's User within a Room. If a client joins with an existing Identity, the existing client is disconnected. See access tokens and limits for more info. |
date_created
|
The date and time in GMT when the resource was created specified in ISO 8601 format. |
date_updated
|
The date and time in GMT when the resource was last updated specified in ISO 8601 format. |
start_time
|
The time of participant connected to the room in ISO 8601 format. |
end_time
|
The time when the participant disconnected from the room in ISO 8601 format. |
duration
|
The duration in seconds that the participant was |
url
|
The absolute URL of the resource. |
links
|
The URLs of related resources. |
HTTP GET
Returns a single Participant resource represented by {ParticipantNameOrSid}
Naming behavior
GET /Participants/{ParticipantIdentity}
implicitly searches only connected
Participants for the given ParticipantIdentity
and returns either an instance or a 404.
Retrieve a connected
Participant from a Room by Identity
Will return the Participant instance object for the Participant Alice
whose Status is connected
, from the in-progress
Room named DailyStandup
.
HTTP POST
Modifies a Participant resource.
Parameters in REST API format | |
---|---|
room_sid
Path
|
The SID of the room with the participant to update. |
sid
Path
|
The SID of the RoomParticipant resource to update. |
status
オプション
|
The new status of the resource. Can be: |
Kick/Remove Participant from a Room
Update a Participant’s status to disconnected
to remove the Participant from a Room.
Participant リスト リソース
リソースURI
/v1/Rooms/{RoomNameOrSid}/Participants/
HTTP GET
Returns a list of Participant resources associated with this Room. The list includes paging information. You can filter the results by providing query string parameters.
リストフィルター
The following GET query string parameters allow you to limit the list returned. Note, parameters are case-sensitive.
Parameters in REST API format | |
---|---|
room_sid
Path
|
The SID of the room with the Participant resources to read. |
status
オプション
|
Read only the participants with this status. Can be: |
identity
オプション
|
Read only the Participants with this User |
date_created_after
オプション
|
Read only Participants that started after this date in ISO 8601 format. |
date_created_before
オプション
|
Read only Participants that started before this date in ISO 8601 format. |
ヘルプが必要ですか?
誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。