AddImContactToGroup 操作AddImContactToGroup operation

Addimcontacttogroup EWS 操作に関する情報を検索します。Find information about the AddImContactToGroup EWS operation.

Addimcontacttogroup Exchange Web サービス (EWS) 操作は、既存のインスタントメッセージング (IM) 連絡先をグループに追加します。The AddImContactToGroup Exchange Web Services (EWS) operation adds an existing instant messaging (IM) contact to a group.

この操作は Exchange Server 2013 で導入されました。This operation was introduced in Exchange Server 2013.

AddImContactToGroup 操作の使用Using the AddImContactToGroup operation

Addimcontacttogroup操作では、IM の連絡先のみを受け入れることができます。The AddImContactToGroup operation can only accept IM contacts. 新しい IM 連絡先を統合連絡先ストアに追加する場合は、 AddNewImContactToGroup操作を使用します。If you want to add a new IM contact to the Unified Contact Store, use the AddNewImContactToGroup operation.

Addimcontacttogroup操作では、次の表に示す SOAP ヘッダーを使用できます。The AddImContactToGroup operation can use the SOAP headers that are listed in the following table.

表1AddImContactToGroup 操作 SOAP ヘッダーTable 1. AddImContactToGroup operation SOAP headers

ヘッダー名Header name 要素Element 説明Description
偽装Impersonation
ExchangeImpersonationExchangeImpersonation
クライアントアプリケーションが偽装しているユーザーを識別します。Identifies the user whom the client application is impersonating. このヘッダーは、要求に適用されます。This header is applicable to a request.
MailboxCultureMailboxCulture
MailboxCultureMailboxCulture
RFC 3066 で定義されているように、メールボックスへのアクセスに使用されるカルチャ (言語の識別用のタグ) を識別します。Identifies the culture, as defined in RFC 3066, "Tags for the Identification of Languages", to be used to access the mailbox. このヘッダーは、要求に適用されます。This header is applicable to a request.
RequestVersionRequestVersion
RequestServerVersionRequestServerVersion
操作要求のスキーマバージョンを識別します。Identifies the schema version for the operation request. このヘッダーは、要求に適用されます。This header is applicable to a request.
ServerVersionServerVersion
ServerVersionInfoServerVersionInfo
要求に応答したサーバーのバージョンを識別します。Identifies the version of the server that responded to the request. このヘッダーは応答に適用されます。This header is applicable to a response.

AddImContactToGroup 操作要求の例: 既存の IM 連絡先を IM グループに追加します。AddImContactToGroup operation request example: Add an existing IM contact to an IM group

Addimcontacttogroup操作要求の次の例は、既存の im 連絡先を im グループに追加する方法を示しています。The following example of an AddImContactToGroup operation request shows how to add an existing IM contact an IM group.

<?xml version="1.0" encoding="UTF-8"?>
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"
               xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types"
               xmlns:m="https://schemas.microsoft.com/exchange/services/2006/messages">
   <soap:Header>
      <t:RequestServerVersion Version="Exchange2013" />
      <t:MailboxCulture>en-US</t:MailboxCulture>
   </soap:Header>
   <soap:Body >
      <m:AddImContactToGroup>
         <m:ContactId Id="AAMkAGQ1MjJjMTBkLTc4Y2AA="
                      ChangeKey="EQAAABYAAABtF8oI7i"/>
         <m:GroupId Id="AAMkAGQ1MjJjMTBkzzAAAQKAAA="
                    ChangeKey="EgAAAA=="/>
      </m:AddImContactToGroup>
   </soap:Body>
</soap:Envelope>

要求 SOAP 本文には、次の要素が含まれています。The request SOAP body contains the following elements:

正常な AddImContactToGroup 操作の応答Successful AddImContactToGroup operation response

次の例は、 Addimcontacttogroup操作要求に対する正常な応答を示しています。The following example shows a successful response to an AddImContactToGroup operation request.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <AddImContactToGroupResponse ResponseClass="Success" 
                                   xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
      </AddImContactToGroupResponse>
   </s:Body>
</s:Envelope>

応答 SOAP 本文には、次の要素が含まれています。The response SOAP body contains the following elements:

AddImContactToGroup 操作 ErrorInvalidImContactId エラー応答AddImContactToGroup operation ErrorInvalidImContactId error response

次の例は、 Addimcontacttogroup操作要求へのエラー応答を示しています。The following example shows an error response to an AddImContactToGroup operation request. IM 連絡先ではない連絡先を追加しようとすると、次のエラー応答が発生します。The following error response occurs when an attempt is made to add a contact that is not an IM contact.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15"
                           MinorVersion="0" 
                           MajorBuildNumber="349" 
                           MinorBuildNumber="0" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types"
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
                           xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/>
   </s:Header>
   <s:Body xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
           xmlns:xsd="http://www.w3.org/2001/XMLSchema">
      <AddImContactToGroupResponse ResponseClass="Error" 
                                   xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified Im Contact Id is invalid.</MessageText>
         <ResponseCode>ErrorInvalidImContactId</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
         </AddImContactToGroupResponse>
      </s:Body>
</s:Envelope>

エラー応答 SOAP 本文には、次の要素が含まれています。The error response SOAP body contains the following elements:

関連項目See also