Get a shared line group

GET

/phone/shared_line_groups/{sharedLineGroupId}

Phone Shared Line Groups

A shared line group allows Zoom Phone admins to share a phone number and extension with a group of phone users or common area phones. This gives members of the shared line group access to the group's direct phone number and voicemail. Use this API to list all the Shared Line Groups.

Prerequisties:

Pro or higher account with Zoom Phone license.

Account owner or admin privileges

Scopes: phone:read:admin or phone:write:admin

Rate Limit Label: Light

请求示例

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://api.zoom.us/v2/phone/shared_line_groups/'

响应示例

{
    "display_name": "Bay Area Shared Line Group",
    "extension_number": 123,
    "id": "jsehdfrrg4",
    "members": {
        "common_area_phones": [
            {
                "id": "eu34gcogfft5nsectetur",
                "name": "Lobby Phone"
            }
        ],
        "users": [
            {
                "id": "gdfsx57ytcfgg",
                "name": "ipsum reprehenderit"
            },
            {
                "id": "nisi3t5hgvsed",
                "name": "dolore sed"
            }
        ]
    },
    "phone_numbers": [
        {
            "id": "dsfdg3r",
            "number": "1365435426"
        },
        {
            "id": "hfgdcfhjj",
            "number": "5673856375"
        }
    ],
    "primary_number": "5673856375",
    "site": {
        "id": "dhfdhsf4",
        "name": "Engineering Site"
    },
    "status": "active",
    "timezone": "America/Los_Angeles"
}

请求参数

Path 参数

sharedLineGroupId

string

必需

Unique Identifier of the Shared Line Group.

返回响应

🟢200成功

application/json

Body

display_name

string

可选

Display Name of the Shared Line Group.

extension_number

integer

可选

Extension number assigned to the Shared Line Group.

string

可选

Unique Identifier of the Shared Line Group.

members

object

可选

View current members of the shared line group.

common_area_phones

array [object {2}]

可选

Common Area Phones that are members of the shared line group.

users

array [object {2}]

可选

Users who are members of the Shared Line Group.

phone_numbers

array [object {2}]

可选

Object representing information about phone number(s) assigned to the group.

string

可选

Unique identifier of the phone number.

number

string

可选

Phone number in E164 format.

primary_number

string

可选

If you have multiple direct phone numbers assigned to the shared line group, this is the primary number selected for desk phones. The primary number shares the same line as the extension number. This means if a caller is routed to the shared line group through an auto receptionist, the line associated with the primary number will be used.

site

object

可选

Site assigned to the Shared Line Group.

string

可选

Unique Identifier of the Site.

name

string

可选

Name of the Site.

status