ユーザー: translateExchangeIdsuser: translateExchangeIds

Outlook 関連リソースの ID の形式を変換します。Translate identifiers of Outlook-related resources between formats.

アクセス許可Permissions

この API を呼び出すには、次のいずれかのアクセス許可が必要です。アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

アクセス許可の種類Permission type アクセス許可 (特権の小さいものから大きいものへ)Permissions (from least to most privileged)
委任 (職場または学校のアカウント)Delegated (work or school account) ユーザー. ReadBasic、user. 読み取り、ユーザー. 読み取り/書き込み。すべてのユーザー。すべてのユーザーに対して。User.ReadBasic, User.Read, User.ReadWrite, User.ReadBasic.All, User.Read.All, User.ReadWrite.All
委任 (個人用 Microsoft アカウント)Delegated (personal Microsoft account) ユーザー. ReadBasic、User. 読み取り/書き込みUser.ReadBasic, User.Read, User.ReadWrite
アプリケーションApplication User.Read.All、User.ReadWrite.AllUser.Read.All, User.ReadWrite.All

HTTP 要求HTTP request

POST /me/translateExchangeIds
POST /users/{id|userPrincipalName}/translateExchangeIds

要求ヘッダーRequest headers

名前Name Value
AuthorizationAuthorization ベアラー {トークン}。必須。Bearer {token}. Required.

要求本文Request body

パラメーターParameter Type 説明Description
inputIdsinputIds 文字列コレクションString collection 変換する識別子のコレクション。A collection of identifiers to convert. コレクション内のすべての識別子のソース ID の種類は同じである必要があり、同じメールボックス内のアイテムである必要があります。All identifiers in the collection MUST have the same source ID type, and MUST be for items in the same mailbox. このコレクションの最大サイズは1000文字列です。Maximum size of this collection is 1000 strings.
sourceIdTypesourceIdType exchangeIdFormatexchangeIdFormat InputIdsパラメーターの識別子の id の種類。The ID type of the identifiers in the InputIds parameter.
targetIdTypetargetIdType exchangeIdFormatexchangeIdFormat 変換先となる要求された ID の種類。The requested ID type to convert to.

exchangeIdFormat の値exchangeIdFormat values

Values 説明Description
entryIdentryId MAPI クライアントによって使用されるバイナリエントリ ID 形式。The binary entry ID format used by MAPI clients.
ewsIdewsId Exchange Web サービスクライアントによって使用される ID 形式。The ID format used by Exchange Web Services clients.
immutableEntryIdimmutableEntryId バイナリ MAPI 互換の不変 ID 形式。The binary MAPI-compatible immutable ID format.
restIdrestId Microsoft Graph で使用される既定の ID 形式。The default ID format used by Microsoft Graph.
restImmutableEntryIdrestImmutableEntryId Microsoft Graph で使用される不変の ID 形式。The immutable ID format used by Microsoft Graph.

バイナリ形式 (entryIdおよびimmutableEntryId) は、URL セーフな base64 でエンコードされます。The binary formats (entryId and immutableEntryId) are URL-safe base64 encoded. URL-safeness は、バイナリデータの base64 エンコードを次のように変更することによって実装されます。URL-safeness is implemented by modifying the base64 encoding of the binary data in the following way:

  • 置換+-Replace + with -
  • 置換/_Replace / with _
  • 末尾のパディング文字を削除=する ()Remove any trailing padding characters (=)
  • 文字列の末尾に、元の文字の数 (01、、または2) を示す整数を追加します。Add an integer to the end of the string indicating how many padding characters were in the original (0, 1, or 2)

応答Response

成功した場合、この200 OKメソッドは応答コードと、応答本文でconvertIdResultコレクションを返します。If successful, this method returns 200 OK response code and a convertIdResult collection in the response body.

Example

次の例は、複数の識別子を標準の REST API 形式 (restId) から不変形式 (restImmutableEntryId) に変換する方法を示しています。The following example shows how to convert multiple identifiers from the normal REST API format (restId) to the REST immutable format (restImmutableEntryId).

要求Request

要求の例を次に示します。Here is the example request.

POST https://graph.microsoft.com/v1.0/me/translateExchangeIds
Content-Type: application/json

{
  "inputIds" : [
    "{rest-formatted-id-1}",
    "{rest-formatted-id-2}"
  ],
  "sourceIdType": "restId",
  "targetIdType": "restImmutableEntryId"
}

応答Response

応答の例を次に示します。Here is the example response

HTTP/1.1 200 OK
Content-type: application/json

{
  "value": [
    {
      "sourceId": "{rest-formatted-id-1}",
      "targetId": "{rest-immutable-formatted-id-1}"
    },
    {
      "sourceId": "{rest-formatted-id-2}",
      "targetId": "{rest-immutable-formatted-id-2}"
    }
  ]
}