機械翻訳について

移動先

• リクエスト
• レスポンス

指定した会話に新規メンバーを追加

post

/social/api/v1/conversations/{conversationID}/members

リクエスト

サポートされているメディア・タイプ

• application/json

パス・パラメータ

• conversationID: integer(int64)
  会話ID。 オブジェクトのlong integer表現の一意識別子。

本文()

リクエスト本文は、リクエストの詳細を定義します。

ルート・スキーマ: XV1ConversationMemberCreateInfo

型: object

V1会話直接メンバー変更情報。

ソースを表示

• groupOriginType(optional): object XV1GroupOriginType
• isGroup(optional): boolean
  メンバーがグループの場合はtrue。
• isHidden(optional): boolean
  メンバーは非表示になります。
• isLocked(optional): boolean
  メンバーはロックされます。
• member(optional): string
  メンバー名。 必須。
• role(optional): object XV1ConversationRole

{
    "description":"V1 Conversation Direct Member Change Information.",
    "properties":{
        "groupOriginType":{
            "description":"The caller of the API should provide the groupOriginType of the group. If the groupOriginType does not match with the group then the group as a member would not be added in conversation and 404 error response returned.",
            "$ref":"#/definitions/XV1GroupOriginType"
        },
        "isGroup":{
            "description":"True if the member is a group.",
            "type":"boolean"
        },
        "isHidden":{
            "description":"The member should be hidden.",
            "type":"boolean"
        },
        "isLocked":{
            "description":"The member should be locked.",
            "type":"boolean"
        },
        "member":{
            "description":"The member name. Required.",
            "type":"string"
        },
        "role":{
            "$ref":"#/definitions/XV1ConversationRole"
        }
    }
}

ネストされたスキーマ : XV1GroupOriginType

型: object

ソースを表示

• field(optional): string
  許容値: [ "CEC", "IDP" ]

  グループの作成元の元を表示する列挙型。

{
    "properties":{
        "field":{
            "type":"string",
            "description":"Enum to list the source of origin from where the Groups are originally created.",
            "enum":[
                "CEC",
                "IDP"
            ]
        }
    }
}

ネストされたスキーマ: XV1ConversationRole

型: object

ソースを表示

• field(optional): string
  許容値: [ "ADMIN", "BYPASS", "CONTRIBUTOR", "DISCOVERER", "GROUP_MANAGER", "GROUP_MEMBER", "HOST", "MANAGER", "MEMBER", "MODERATOR", "NONE", "VIEWER" ]

  V1会話ロール。

  会話ロールは、会話への許可および非許可のアクセスを定義するために使用されます。

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Conversation Roles. <p/> Conversation roles are used to define grantable and nongrantable access to conversations.",
            "enum":[
                "ADMIN",
                "BYPASS",
                "CONTRIBUTOR",
                "DISCOVERER",
                "GROUP_MANAGER",
                "GROUP_MEMBER",
                "HOST",
                "MANAGER",
                "MEMBER",
                "MODERATOR",
                "NONE",
                "VIEWER"
            ]
        }
    }
}

トップに戻る

レスポンス

サポートされているメディア・タイプ

• application/json

200レスポンス

操作の成功

本文()

ルート・スキーマ: XV1ConversationMemberInfo

型: object

V1会話直接メンバー情報DTO。

ソースを表示

• altitude(optional): number(double)
  オブジェクトの高度。
• collectionURL(optional): string(url)
  コレクションを含むこのオブジェクトのURL。
• conversationURL(optional): string(url)
  このオブジェクトに含まれる会話へのURL。
• createdByID(optional):
  オブジェクトのlong integer表現の一意識別子。
• createdByURL(optional): string(url)
  このオブジェクトを作成したユーザーへのURL。
• createdByUserDisplayName(optional): string
  このオブジェクトを作成したユーザーの表示名。
• createdByUserName(optional): string
  このオブジェクトを作成したユーザーの名前。
• createdDate(optional): string(date)
  このオブジェクトが作成された日付。
• createdDateInISO8601Format(optional): string
  このオブジェクトが作成された日付(ISO 8601書式)。
• displayName(optional): string
  このオブジェクトの表示名。
• id(optional):
  オブジェクトのlong integer表現の一意識別子。
• isDirect(optional): boolean
  メンバーの直接ステータス。
• isHidden(optional): boolean
  メンバーの非表示ステータス。
• isHierarchical(optional): boolean
  メンバーの階層ステータス。
• isLocked(optional): boolean
  メンバーのロック・ステータス。
• isRemoved(optional): boolean
  このメッセージが削除された場合はTrue。
• latitude(optional): number(double)
  オブジェクトの緯度。
• longitude(optional): number(double)
  オブジェクトの経度。
• membersURL(optional): string(url)
  メンバーのコレクションへのURL。
• modifiedByID(optional):
  オブジェクトのlong integer表現の一意識別子。
• modifiedByURL(optional): string(url)
  このオブジェクトを最後に変更したユーザーへのURL。
• modifiedByUserDisplayName(optional): string
  このオブジェクトを最後に変更したユーザーの表示名。
• modifiedByUserName(optional): string
  このオブジェクトを最後に変更したユーザーの名前。
• modifiedDate(optional): string(date)
  このオブジェクトが最後に変更された日付。
• modifiedDateInISO8601Format(optional): string
  このオブジェクトが最後に変更された日付(ISO 8601書式)。
• name(optional): string
  このオブジェクトの名前。
• objectType(optional): string
  このオブジェクトのタイプ。
• originalPictureURL(optional): string(url)
  元のピクチャのURL。
• profilePictureURL(optional): string(url)
  プロファイル・ピクチャのURL (150×150ピクセル)。
• removedByID(optional):
  オブジェクトのlong integer表現の一意識別子。
• removedByURL(optional): string(url)
  このオブジェクトを最後に削除したユーザーへのURL。
• removedByUserDisplayName(optional): string
  このオブジェクトを最後に削除したユーザーの表示名。
• removedByUserName(optional): string
  このオブジェクトを最後に削除したユーザーの名前。
• removedDate(optional): string(date)
  このオブジェクトが削除された日付。
• removedDateInISO8601Format(optional): string
  このオブジェクトが削除された日付(ISO 8601書式)。
• role(optional): object XV1ConversationRole
• scaledPictureURL(optional): string(url)
  スケール調整済ピクチャのURL (44×44ピクセル)。
• socialObjectURL(optional): string(url)
  このオブジェクトの格納されているコラボレーション・オブジェクトへのURL。
• url(optional): string(url)
  このオブジェクトへのURL。

{
    "description":"V1 Conversation Direct Member Information DTO.",
    "properties":{
        "isDirect":{
            "description":"The member's direct status.",
            "type":"boolean"
        },
        "isHidden":{
            "description":"The member's hidden status.",
            "type":"boolean"
        },
        "isHierarchical":{
            "description":"The member's hierarchical status.",
            "type":"boolean"
        },
        "isLocked":{
            "description":"The member's locked status.",
            "type":"boolean"
        },
        "membersURL":{
            "description":"A URL to the collection of members.",
            "type":"string",
            "format":"url"
        },
        "role":{
            "$ref":"#/definitions/XV1ConversationRole"
        },
        "originalPictureURL":{
            "description":"The original picture URL.",
            "type":"string",
            "format":"url"
        },
        "profilePictureURL":{
            "description":"The profile picture URL (150 px by 150 px).",
            "type":"string",
            "format":"url"
        },
        "scaledPictureURL":{
            "description":"The scaled picture URL (44 px by 44 px).",
            "type":"string",
            "format":"url"
        },
        "altitude":{
            "description":"The object's altitude.",
            "type":"number",
            "format":"double"
        },
        "collectionURL":{
            "description":"A URL to this object's containing collection.",
            "type":"string",
            "format":"url"
        },
        "conversationURL":{
            "description":"A URL to this object's containing conversation.",
            "type":"string",
            "format":"url"
        },
        "createdByID":{
            "$ref":"#/definitions/XObjectID"
        },
        "createdByURL":{
            "description":"A URL to the user that created this object.",
            "type":"string",
            "format":"url"
        },
        "createdByUserDisplayName":{
            "description":"The display name of the user that created this object.",
            "type":"string"
        },
        "createdByUserName":{
            "description":"The name of the user that created this object.",
            "type":"string"
        },
        "createdDate":{
            "description":"The date this object was created.",
            "type":"string",
            "format":"date"
        },
        "createdDateInISO8601Format":{
            "description":"The date this object was created, in ISO 8601 format.",
            "type":"string"
        },
        "displayName":{
            "description":"The display name of this object.",
            "type":"string"
        },
        "id":{
            "$ref":"#/definitions/XObjectID"
        },
        "isRemoved":{
            "description":"True if this message has been removed.",
            "type":"boolean"
        },
        "latitude":{
            "description":"The object's latitude.",
            "type":"number",
            "format":"double"
        },
        "longitude":{
            "description":"The object's longitude.",
            "type":"number",
            "format":"double"
        },
        "modifiedByID":{
            "$ref":"#/definitions/XObjectID"
        },
        "modifiedByURL":{
            "description":"A URL to the user that last modified this object.",
            "type":"string",
            "format":"url"
        },
        "modifiedByUserDisplayName":{
            "description":"The display name of the user that last modified this object.",
            "type":"string"
        },
        "modifiedByUserName":{
            "description":"The name of the user that last modified this object.",
            "type":"string"
        },
        "modifiedDate":{
            "description":"The date this object was last modified.",
            "type":"string",
            "format":"date"
        },
        "modifiedDateInISO8601Format":{
            "description":"The date this object was last modified, in ISO 8601 format.",
            "type":"string"
        },
        "name":{
            "description":"The name of this object.",
            "type":"string"
        },
        "objectType":{
            "description":"The type of this object.",
            "type":"string"
        },
        "removedByID":{
            "$ref":"#/definitions/XObjectID"
        },
        "removedByURL":{
            "description":"A URL to the user that last removed this object.",
            "type":"string",
            "format":"url"
        },
        "removedByUserDisplayName":{
            "description":"The display name of the user that last removed this object.",
            "type":"string"
        },
        "removedByUserName":{
            "description":"The name of the user that last removed this object.",
            "type":"string"
        },
        "removedDate":{
            "description":"The date this object was removed.",
            "type":"string",
            "format":"date"
        },
        "removedDateInISO8601Format":{
            "description":"The date this object was removed, in ISO 8601 format.",
            "type":"string"
        },
        "socialObjectURL":{
            "description":"A URL to this object's containing collaboration object.",
            "type":"string",
            "format":"url"
        },
        "url":{
            "description":"A URL to this object.",
            "type":"string",
            "format":"url"
        }
    }
}

ネストされたスキーマ: XV1ConversationRole

型: object

ソースを表示

• field(optional): string
  許容値: [ "ADMIN", "BYPASS", "CONTRIBUTOR", "DISCOVERER", "GROUP_MANAGER", "GROUP_MEMBER", "HOST", "MANAGER", "MEMBER", "MODERATOR", "NONE", "VIEWER" ]

  V1会話ロール。

  会話ロールは、会話への許可および非許可のアクセスを定義するために使用されます。

{
    "properties":{
        "field":{
            "type":"string",
            "description":"V1 Conversation Roles. <p/> Conversation roles are used to define grantable and nongrantable access to conversations.",
            "enum":[
                "ADMIN",
                "BYPASS",
                "CONTRIBUTOR",
                "DISCOVERER",
                "GROUP_MANAGER",
                "GROUP_MEMBER",
                "HOST",
                "MANAGER",
                "MEMBER",
                "MODERATOR",
                "NONE",
                "VIEWER"
            ]
        }
    }
}

404レスポンス

操作に失敗しました。 GroupOriginTypeがグループと一致しません。

本文()

ルート・スキーマ : XV1GroupOriginType

型: object

ソースを表示

• field(optional): string
  許容値: [ "CEC", "IDP" ]

  グループの作成元の元を表示する列挙型。

{
    "properties":{
        "field":{
            "type":"string",
            "description":"Enum to list the source of origin from where the Groups are originally created.",
            "enum":[
                "CEC",
                "IDP"
            ]
        }
    }
}

先頭に戻る