AddNewTelUriContactToGroup 操作AddNewTelUriContactToGroup operation

AddNewTelUriContactToGroup EWS 操作の使用方法に関する情報を検索します。Find information about how to use the AddNewTelUriContactToGroup EWS operation.

AddNewTelUriContactToGroup操作は、連絡先の電話番号に基づいてグループに新しい連絡先を追加します。The AddNewTelUriContactToGroup operation adds a new contact to a group based on a contact's phone number.

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

AddNewTelUriContactToGroup 操作の使用Using the AddNewTelUriContactToGroup operation

AddNewTelUriContactToGroup操作要求は、連絡先の TEL URI、SIP uri、電話番号、連絡先を追加するグループを送信します。An AddNewTelUriContactToGroup operation request submits a contact's TEL URI, SIP URI, phone number, and the group to add the contact to. AddNewTelUriContactToGroup操作の応答では、新しい連絡先のペルソナが作成されます。An AddNewTelUriContactToGroup operation response creates a persona for the new contact. この操作により、連絡先が名前を持たない場合でも、クライアントは新しい連絡先を追加できます。This operation allows clients to add a new contact even if the contact does not have a name.

AddNewTelUriContactToGroup 操作の SOAP ヘッダーAddNewTelUriContactToGroup operation SOAP headers

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

ヘッダー名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.

AddNewTelUriContactToGroup 操作要求の例: 新しい連絡先をグループに追加します。AddNewTelUriContactToGroup operation request example: Add a new contact to a group

次のAddNewTelUriContactToGroup操作要求の例は、連絡先の TEL および SIP uri を使用して、新しい連絡先を作成し、インスタントメッセージング (IM) グループに新しい連絡先を追加する方法を示しています。The following example of an AddNewTelUriContactToGroup operation request shows how to create a new contact and add the new contact to an instant messaging (IM) group by using the contact's TEL and SIP URIs.

注意

この記事のすべてのアイテム識別子と変更キーは、読みやすくするために短縮されています。All item identifiers and change keys in this article have been shortened to preserve readability.

<?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:AddNewTelUriContactToGroup>
         <m:TelUriAddress>tel:5625550100</m:TelUriAddress>
         <m:ImContactSipUriAddress>sip:john@contoso.com</m:ImContactSipUriAddress>
         <m:ImTelephoneNumber>5625550100</m:ImTelephoneNumber>
         <m:GroupId Id="AAMkADEzOTm4QrAABY7+0GAAA="/>
      </m:AddNewTelUriContactToGroup>
   </soap:Body>
</soap:Envelope>

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

成功した AddNewTelUriContactToGroup 操作の応答Successful AddNewTelUriContactToGroup operation response

次の例は、連絡先を作成するためのAddNewTelUriContactToGroup操作要求に対する正常な応答を示しています。The following example shows a successful response to an AddNewTelUriContactToGroup operation request to create a contact. 応答には、連絡先の関連付けられたペルソナ識別子、この例では連絡先の電話番号に基づき、連絡先のアイテムの識別子が含まれています。これは、送信元識別子の一部として表示されます。The response contains the associated persona identifier for the contact, the display name of the persona, which in this case is based on the contact's phone number, and the contact's item identifier, which is displayed as part of the source identifier attribution.

<?xml version="1.0" encoding="utf-8"?>
<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/"                           
            xmlns:xsd="http://www.w3.org/2001/XMLSchema"
            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
            xmlns:t="https://schemas.microsoft.com/exchange/services/2006/types">
   <s:Header>
      <h:ServerVersionInfo MajorVersion="15" 
                           MinorVersion="0" 
                           MajorBuildNumber="545" 
                           MinorBuildNumber="11" 
                           Version="Exchange2013" 
                           xmlns:h="https://schemas.microsoft.com/exchange/services/2006/types" 
                           xmlns="https://schemas.microsoft.com/exchange/services/2006/types" />
   </s:Header>
   <s:Body>
      <AddNewTelUriContactToGroupResponse ResponseClass="Success" 
                                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <ResponseCode>NoError</ResponseCode>
         <Persona>
            <t:PersonaId Id="AAQkADE686dX3s="/>
            <t:PersonaType>Person</t:PersonaType>
            <t:CreationTime>2012-10-29T23:10:13Z</t:CreationTime>
            <t:DisplayName/>
            <t:DisplayNameFirstLast>5625550100</t:DisplayNameFirstLast>
            <t:DisplayNameLastFirst>5625550100</t:DisplayNameLastFirst>
            <t:FileAs/>
            <t:FileAsId >None</t:FileAsId>
            <t:RelevanceScore >2147483647</t:RelevanceScore>
            <t:Attributions>
               <t:Attribution>
                  <t:Id>0</t:Id>
                  <t:SourceId Id="ABhHuhCAAA=" ChangeKey="EQAAABxFU"/>
                  <t:DisplayName>Lync Contacts</t:DisplayName>
                  <t:IsWritable>false</t:IsWritable>
                  <t:IsQuickContact>true</t:IsQuickContact>
                  <t:IsHidden>false</t:IsHidden>
               </t:Attribution>
            </t:Attributions>
            <t:FileAsIds>
               <t:StringAttributedValue>
                  <t:Value>None</t:Value>
                  <t:Attributions>
                     <t:Attribution>0</t:Attribution>
                  </t:Attributions>
               </t:StringAttributedValue>
            </t:FileAsIds>
            <t:OtherTelephones>
               <t:PhoneNumberAttributedValue>
                  <t:Value>
                     <t:Number>5625550100</t:Number>
                     <t:Type>Other</t:Type>
                  </t:Value>
                  <t:Attributions>
                     <t:Attribution>0</t:Attribution>
                  </t:Attributions>
               </t:PhoneNumberAttributedValue>
            </t:OtherTelephones>
         </Persona>
      </AddNewTelUriContactToGroupResponse>
   </s:Body>
</s:Envelope>

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

AddNewTelUriContactToGroup 操作エラー応答の例AddNewTelUriContactToGroup operation error response example

次の例は、グループ識別子に、メールボックス内のグループを識別しない整形式の値が含まれている場合の、 AddNewTelUriContactToGroup操作要求へのエラー応答を示しています。The following example shows an error response to an AddNewTelUriContactToGroup operation request when the group identifier contains a well-formed value that does not identify a group in the mailbox.

<?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="545" 
                           MinorBuildNumber="11" 
                           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">
      <AddNewTelUriContactToGroupResponse ResponseClass="Error" 
                                          xmlns="https://schemas.microsoft.com/exchange/services/2006/messages">
         <MessageText>The specified object was not found in the store.</MessageText>
         <ResponseCode>ErrorItemNotFound</ResponseCode>
         <DescriptiveLinkKey>0</DescriptiveLinkKey>
      </AddNewTelUriContactToGroupResponse>
   </s:Body>
</s:Envelope>

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

関連項目See also