共用方式為

適用於 Teams 電話擴充性的 REST API

本文說明 Teams Phone 擴展功能的 REST API。

這很重要

此 Azure 通訊服務功能目前處於預覽狀態。 預覽中的功能可供公開使用，而且可供所有新的和現有的Microsoft客戶使用。

此預覽版本沒有服務等級協定，不建議用於處理生產工作負載。 某些功能可能不受支援，或功能可能會受到限制。

如需詳細資訊，請參閱 Microsoft Azure 預覽版增補使用條款。

新增作業

建立指派，以授與 Teams 使用者或 Teams 資源帳戶對通訊服務資源的存取權。

PUT {endpoint}/access/teamsExtension/tenants/{tenantId}/assignments/{objectId}?api-version=2025-03-02-preview

URI 參數

名稱 在 為必填項目 類型 說明
objectId 路徑 是 字符串 主體的物件識別碼，也就是使用者標識碼或資源帳戶標識碼。
tenantId 路徑 是 字符串 所屬租戶的租戶識別碼。
api-version 查詢 是 字符串 要叫用的 API 版本。

請求主體

名稱 在 為必填項目 類型 說明
request 身體 是 TeamsExtensionAssignmentCreateOrUpdateRequest 請求指派團隊帳戶。

回覆

名稱 類型 說明
200 確定 TeamsExtensionAssignmentResponse 已建立 - 傳回已更新的作業分配。
201 已建立 TeamsExtensionAssignmentResponse 建立 - 傳回已建立的工作分派。
其他狀態碼 CommunicationErrorResponse 錯誤。

取得指派

取得來自 Teams 使用者或 Teams 資源帳戶的資源存取指派。

GET {endpoint}/access/teamsExtension/assignments/{objectId}?api-version=2025-03-02-preview

URI 參數

名稱 在 為必填項目 類型 說明
objectId 路徑 是 字符串 主體的物件識別碼，也就是使用者標識碼或資源帳戶標識碼。

回覆

名稱 類型 說明
200 確定 TeamsExtensionAssignmentResponse 傳回給予的任務。
其他狀態碼 CommunicationErrorResponse 錯誤。

刪除指派

刪除指派，以從 Teams 使用者或 Teams 資源帳戶移除資源存取權。

DELETE {endpoint}/access/teamsExtension/assignments/{objectId}?api-version=2025-03-02-preview

URI 參數

名稱 在 為必填項目 類型 說明
objectId 路徑 是 字符串 主體的物件識別碼，也就是使用者標識碼或資源帳戶標識碼。

回覆

名稱 類型 說明
204 無內容 空 成功狀態代碼。
其他狀態碼 CommunicationErrorResponse 錯誤。

定義

名稱 說明
CommunicationError 通訊服務錯誤。
CommunicationErrorResponse 通訊服務錯誤。
TeamsExtensionAssignmentCreateOrUpdateRequest 建立或取代任務的要求。
principalType 主體存取資源的類型，即"user"或"teamsResourceAccount"。
TeamsExtensionAssignmentResponse Teams 電話指派。

通訊錯誤

名稱 類型 說明
code 字符串 錯誤碼。
details Boolean[] 導致此錯誤之特定錯誤的詳細數據。
innererror CommunicationError 如果有，則為內部錯誤。
message 字符串 錯誤訊息。
target 字符串 錯誤目標。

通信錯誤回應

名稱 類型 說明
error CommunicationError 通訊服務錯誤。

Teams 擴充指派建立或更新請求

名稱 類型 說明
principalType 字符串 主體存取資源的類型，即"user"或"teamsResourceAccount"。
clientIds 字串[] 可供主體存取資源之應用程式 ID 清單 "user"。

團隊擴充指派回應

名稱 類型 說明
objectId 字符串 指派主體的物件標識碼。
tenantId 字符串 租用戶識別碼。
principalType 字符串 主體存取資源的類型，即"user"或"teamsResourceAccount"。
clientIds 字串[] 可供主體存取資源之應用程式 ID 清單 "user"。