跳转到内容

Room

它表示楼层内的一个封闭空间 

属性

id (long)
唯一标识符,用于标识 Room

id (long)
被认为具有较大值的数字位数。

示例

234759602834500

name (string)
用于标识 Room 的名称 [最大长度:250]

name (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

description (string)
Room 描述

description (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

space_code (string)
唯一名称,用于标识 Room [最大长度:250]

space_code (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

display_image (string)
包含用作默认 Room 图片的图像附件 id

display_image (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

total_capacity (long)
表示 Room 的总容量

total_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

更多属性 展开全部

occupied_capacity (long)

表示 Room 的已占用容量

occupied_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

type (sp_type)

表示 Room 的类型

type (sp_type)

space_attributes (space_attributes)

包含 Room 的 udf 字段

space_attributes (space_attributes)

site (site)

表示 Room 所属站点

site (site)

设施 (sp_amenity)

包含房间内所有设施的集合

设施 (sp_amenity)

criticalities (sp_criticality)

包含房间内所有关键性的集合

criticalities (sp_criticality)

room_layouts (room_layout_mapping)

包含空间内所有可用房间布局及其容量的集合

room_layouts (room_layout_mapping)

status (sp_status)

指示房间的状态

status (sp_status)

attachments (attachment)

包含房间的所有附件

attachments (attachment)

supervisors (technician)

指示房间的主管

supervisors (technician)

area (JSONObject)

指示房间的面积及其单位 
show attribute

area (JSONObject)

created_by (user)read only

指示创建房间的用户

created_by (user)

created_time (datetime)read only

指示房间创建的时间

created_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

last_updated_by (user)read only

指示最近编辑房间的用户

last_updated_by (user)

last_updated_time (datetime)read only

指示房间最近编辑的时间

last_updated_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

available_capacity (long)read only

指示房间的可用容量

available_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

space_campus (space)

指示房间所在的校园

space_campus (space)
指示房间所在的校园

示例

{
  "space_campus": {
    "id": "99999000000043495",
    "name": "Estancia",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036766"
    }
  }
}

space_building (space)

指示房间所在的大楼

space_building (space)
指示房间所在的大楼

示例

{
  "space_building": {
    "id": "99999000000043501",
    "name": "Signture Tower",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036768"
    }
  }
}

space_floor (space)

指示房间所在的楼层

space_floor (space)
指示房间所在的楼层

示例

{
  "space_floor": {
    "id": "99999000000043511",
    "name": "First Floor",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036772"
    }
  }
}

department (department)

指示房间所属的部门

department (department)
指示房间所属的部门

示例

{
  "department": {
    "id": "99999000000038431",
    "name": "Facility Services",
    "site": {
      "id": "99999000000006750"
    }
  }
}

is_room_partitionable (boolean)

指示房间是否包含隔断

is_room_partitionable (boolean)
指示房间是否包含隔断

示例

false

is_floating_capacity (boolean)

指示房间的总容量和占用容量是否包含在父级容量计算中

is_floating_capacity (boolean)
指示房间的总容量和占用容量是否包含在父级容量计算中

示例

false

添加 Room

此操作用于创建房间

必填字段 :- name

Url

<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}

属性

id (long)
唯一标识符,用于标识 Room

id (long)
被认为具有较大值的数字位数。

示例

234759602834500

name (string)
用于标识 Room 的名称 [最大长度:250]

name (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

description (string)
Room 描述

description (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

space_code (string)
唯一名称,用于标识 Room [最大长度:250]

space_code (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

display_image (string)
包含用作默认 Room 图片的图像附件 id

display_image (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

total_capacity (long)
表示 Room 的总容量

total_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

更多属性 展开全部

occupied_capacity (long)

表示 Room 的已占用容量

occupied_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

type (sp_type)

表示 Room 的类型

type (sp_type)

space_attributes (space_attributes)

包含 Room 的 udf 字段

space_attributes (space_attributes)

site (site)

表示 Room 所属站点

site (site)

设施 (sp_amenity)

包含房间内所有设施的集合

设施 (sp_amenity)

criticalities (sp_criticality)

包含房间内所有关键性的集合

criticalities (sp_criticality)

room_layouts (room_layout_mapping)

包含空间内所有可用房间布局及其容量的集合

room_layouts (room_layout_mapping)

status (sp_status)

指示房间的状态

status (sp_status)

attachments (attachment)

包含房间的所有附件

attachments (attachment)

supervisors (technician)

指示房间的主管

supervisors (technician)

area (JSONObject)

指示房间的面积及其单位 
show attribute

area (JSONObject)

created_by (user)read only

指示创建房间的用户

created_by (user)

created_time (datetime)read only

指示房间创建的时间

created_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

last_updated_by (user)read only

指示最近编辑房间的用户

last_updated_by (user)

last_updated_time (datetime)read only

指示房间最近编辑的时间

last_updated_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

available_capacity (long)read only

指示房间的可用容量

available_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

space_campus (space)

指示房间所在的校园

space_campus (space)
指示房间所在的校园

示例

{
  "space_campus": {
    "id": "99999000000043495",
    "name": "Estancia",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036766"
    }
  }
}

space_building (space)

指示房间所在的大楼

space_building (space)
指示房间所在的大楼

示例

{
  "space_building": {
    "id": "99999000000043501",
    "name": "Signture Tower",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036768"
    }
  }
}

space_floor (space)

指示房间所在的楼层

space_floor (space)
指示房间所在的楼层

示例

{
  "space_floor": {
    "id": "99999000000043511",
    "name": "First Floor",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036772"
    }
  }
}

department (department)

指示房间所属的部门

department (department)
指示房间所属的部门

示例

{
  "department": {
    "id": "99999000000038431",
    "name": "Facility Services",
    "site": {
      "id": "99999000000006750"
    }
  }
}

is_room_partitionable (boolean)

指示房间是否包含隔断

is_room_partitionable (boolean)
指示房间是否包含隔断

示例

false

is_floating_capacity (boolean)

指示房间的总容量和占用容量是否包含在父级容量计算中

is_floating_capacity (boolean)
指示房间的总容量和占用容量是否包含在父级容量计算中

示例

false

$ curl <service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}\
      -X POST\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "space_defaultroom": {
    "name": "Conference hall",
    "description": "meetings will be held here",
    "space_campus": {
      "id": "100000000000043080"
    },
    "space_building": {
      "id": "100000000000043152"
    },
    "space_floor": {
      "id": "100000000000043222"
    },
    "is_room_partitionable": false,
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "500",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "20",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041924"
      }
    ],
    "space_code": "Conf",
    "is_floating_capacity": false,
    "department": {
      "id": "100000000000038648"
    },
    "amenities": [
      {
        "id": "100000000000040482"
      },
      {
        "id": "100000000000040512"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040533"
      }
    ],
    "room_layouts": [
      {
        "layout": {
          "id": "100000000000040521"
        },
        "capacity": "10"
      },
      {
        "layout": {
          "id": "100000000000040524"
        },
        "capacity": "10"
      }
    ],
    "attachments": [
      {
        "file_id": "55"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_room": null,
    "display_image": "55"
  }
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "space_defaultroom": {
    "name": "Conference hall",
    "description": "meetings will be held here",
    "space_campus": {
      "id": "100000000000043080"
    },
    "space_building": {
      "id": "100000000000043152"
    },
    "space_floor": {
      "id": "100000000000043222"
    },
    "is_room_partitionable": false,
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "500",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "20",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041924"
      }
    ],
    "space_code": "Conf",
    "is_floating_capacity": false,
    "department": {
      "id": "100000000000038648"
    },
    "amenities": [
      {
        "id": "100000000000040482"
      },
      {
        "id": "100000000000040512"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040533"
      }
    ],
    "room_layouts": [
      {
        "layout": {
          "id": "100000000000040521"
        },
        "capacity": "10"
      },
      {
        "layout": {
          "id": "100000000000040524"
        },
        "capacity": "10"
      }
    ],
    "attachments": [
      {
        "file_id": "55"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_room": null,
    "display_image": "55"
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "space_defaultroom": {
    "name": "Conference hall",
    "description": "meetings will be held here",
    "space_campus": {
      "id": "100000000000043080"
    },
    "space_building": {
      "id": "100000000000043152"
    },
    "space_floor": {
      "id": "100000000000043222"
    },
    "is_room_partitionable": false,
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "500",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "20",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041924"
      }
    ],
    "space_code": "Conf",
    "is_floating_capacity": false,
    "department": {
      "id": "100000000000038648"
    },
    "amenities": [
      {
        "id": "100000000000040482"
      },
      {
        "id": "100000000000040512"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040533"
      }
    ],
    "room_layouts": [
      {
        "layout": {
          "id": "100000000000040521"
        },
        "capacity": "10"
      },
      {
        "layout": {
          "id": "100000000000040524"
        },
        "capacity": "10"
      }
    ],
    "attachments": [
      {
        "file_id": "55"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_room": null,
    "display_image": "55"
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "space_defaultroom": {
    "name": "Conference hall",
    "description": "meetings will be held here",
    "space_campus": {
      "id": "100000000000043080"
    },
    "space_building": {
      "id": "100000000000043152"
    },
    "space_floor": {
      "id": "100000000000043222"
    },
    "is_room_partitionable": false,
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "500",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "20",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041924"
      }
    ],
    "space_code": "Conf",
    "is_floating_capacity": false,
    "department": {
      "id": "100000000000038648"
    },
    "amenities": [
      {
        "id": "100000000000040482"
      },
      {
        "id": "100000000000040512"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040533"
      }
    ],
    "room_layouts": [
      {
        "layout": {
          "id": "100000000000040521"
        },
        "capacity": "10"
      },
      {
        "layout": {
          "id": "100000000000040524"
        },
        "capacity": "10"
      }
    ],
    "attachments": [
      {
        "file_id": "55"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_room": null,
    "display_image": "55"
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="POST")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "space_defaultroom": {
        "occupied_capacity": "0",
        "common_module": "space_room",
        "amenities": [
            {
                "name": "Wifi Access",
                "description": null,
                "id": "100000000000040482",
                "icon_name": "wifi_access"
            },
            {
                "name": "Uninterrupted Power",
                "description": null,
                "id": "100000000000040512",
                "icon_name": "uninterrupted_power"
            }
        ],
        "attachments": [
            {
                "size": "486641",
                "content_type": "image/png",
                "file_id": "55",
                "name": "Screenshot 2025-01-24 at 11.06.42\u202fAM.png",
                "content_url": "/space_defaultrooms/100000000000043254/_uploads/55",
                "id": "100000000000043260"
            }
        ],
        "space_building": {
            "name": "Signature Tower",
            "id": "100000000000043152",
            "type": {
                "id": "100000000000037122"
            }
        },
        "description": "meetings will be held here",
        "space_code": "Conf",
        "criticalities": [
            {
                "name": "Chemical waste",
                "description": "The Space contains chemical waste.",
                "id": "100000000000040533",
                "icon_name": "chemical_waste"
            }
        ],
        "type": {
            "api_plural_name": "space_defaultrooms",
            "name": "space_defaultroom",
            "display_name_plural": "Default Room",
            "id": "100000000000037128",
            "display_name": "Default Room",
            "icon_name": null
        },
        "last_updated_by": null,
        "id": "100000000000043254",
        "department": {
            "site": {
                "id": "100000000000006824"
            },
            "name": "Space",
            "id": "100000000000038648"
        },
        "display_image": "55",
        "total_capacity": "20",
        "space_campus": {
            "name": "Estancia",
            "id": "100000000000043080",
            "type": {
                "id": "100000000000037120"
            }
        },
        "area": {
            "area_unit": {
                "deleted": false,
                "name": "Sq.meter",
                "id": "100000000000040548",
                "is_default": true
            },
            "space_area": "500"
        },
        "created_time": {
            "display_value": "Jan 30, 2025 01:37 PM",
            "value": "1738224452757"
        },
        "is_room_partitionable": false,
        "space_room": null,
        "is_floating_capacity": false,
        "created_by": {
            "email_id": "test@zmail.com",
            "is_technician": true,
            "sms_mail": "",
            "mobile": "",
            "last_name": "",
            "user_scope": "internal_user",
            "sms_mail_id": "",
            "cost_per_hour": "0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "100000000000006824",
                "is_default": true
            },
            "phone": "",
            "employee_id": "",
            "name": "tech",
            "id": "100000000000043064",
            "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=16704982&t=user&height=60&width=60",
            "is_vip_user": false,
            "department": null,
            "first_name": "tech",
            "job_title": ""
        },
        "available_capacity": 20,
        "room_layouts": [
            {
                "layout": {
                    "name": "Boardroom",
                    "description": "Centrally located table.",
                    "id": "100000000000040521",
                    "icon_name": "boardroom"
                },
                "id": "100000000000043256",
                "capacity": 10
            },
            {
                "layout": {
                    "name": "Theatre",
                    "description": "Row wise seating towards one side.",
                    "id": "100000000000040524",
                    "icon_name": "theatre"
                },
                "id": "100000000000043258",
                "capacity": 10
            }
        ],
        "space_floor": {
            "name": "Ground floor",
            "id": "100000000000043222",
            "type": {
                "id": "100000000000037126"
            }
        },
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "100000000000006824",
            "is_default": true
        },
        "last_updated_time": null,
        "available_partition_capacity": "0",
        "name": "Conference hall",
        "partition_capacity": 0,
        "status": {
            "color": "#00C408",
            "name": "Active",
            "id": "100000000000040570"
        },
        "supervisors": [
            {
                "email_id": "jeniffer.doe@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "Doe",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "id": "100000000000006824"
                },
                "phone": null,
                "employee_id": "1005",
                "name": "Jeniffer Doe",
                "id": "100000000000041924",
                "is_vip_user": false,
                "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=-1&t=user&height=60&width=60",
                "department": null,
                "first_name": "Jeniffer",
                "job_title": null
            }
        ]
    }
}

编辑 Room

此操作用于编辑房间

Url

<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}

属性

id (long)
唯一标识符,用于标识 Room

id (long)
被认为具有较大值的数字位数。

示例

234759602834500

name (string)
用于标识 Room 的名称 [最大长度:250]

name (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

description (string)
Room 描述

description (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

space_code (string)
唯一名称,用于标识 Room [最大长度:250]

space_code (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

display_image (string)
包含用作默认 Room 图片的图像附件 id

display_image (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

total_capacity (long)
表示 Room 的总容量

total_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

更多属性 展开全部

occupied_capacity (long)

表示 Room 的已占用容量

occupied_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

type (sp_type)

表示 Room 的类型

type (sp_type)

space_attributes (space_attributes)

包含 Room 的 udf 字段

space_attributes (space_attributes)

site (site)

表示 Room 所属站点

site (site)

设施 (sp_amenity)

包含房间内所有设施的集合

设施 (sp_amenity)

criticalities (sp_criticality)

包含房间内所有关键性的集合

criticalities (sp_criticality)

room_layouts (room_layout_mapping)

包含空间内所有可用房间布局及其容量的集合

room_layouts (room_layout_mapping)

status (sp_status)

指示房间的状态

status (sp_status)

attachments (attachment)

包含房间的所有附件

attachments (attachment)

supervisors (technician)

指示房间的主管

supervisors (technician)

area (JSONObject)

指示房间的面积及其单位 
show attribute

area (JSONObject)

created_by (user)read only

指示创建房间的用户

created_by (user)

created_time (datetime)read only

指示房间创建的时间

created_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

last_updated_by (user)read only

指示最近编辑房间的用户

last_updated_by (user)

last_updated_time (datetime)read only

指示房间最近编辑的时间

last_updated_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

available_capacity (long)read only

指示房间的可用容量

available_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

space_campus (space)

指示房间所在的校园

space_campus (space)
指示房间所在的校园

示例

{
  "space_campus": {
    "id": "99999000000043495",
    "name": "Estancia",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036766"
    }
  }
}

space_building (space)

指示房间所在的大楼

space_building (space)
指示房间所在的大楼

示例

{
  "space_building": {
    "id": "99999000000043501",
    "name": "Signture Tower",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036768"
    }
  }
}

space_floor (space)

指示房间所在的楼层

space_floor (space)
指示房间所在的楼层

示例

{
  "space_floor": {
    "id": "99999000000043511",
    "name": "First Floor",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036772"
    }
  }
}

department (department)

指示房间所属的部门

department (department)
指示房间所属的部门

示例

{
  "department": {
    "id": "99999000000038431",
    "name": "Facility Services",
    "site": {
      "id": "99999000000006750"
    }
  }
}

is_room_partitionable (boolean)

指示房间是否包含隔断

is_room_partitionable (boolean)
指示房间是否包含隔断

示例

false

is_floating_capacity (boolean)

指示房间的总容量和占用容量是否包含在父级容量计算中

is_floating_capacity (boolean)
指示房间的总容量和占用容量是否包含在父级容量计算中

示例

false

$ curl <service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}\
      -X PUT\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      -d input_data='{
  "space_defaultroom": {
    "description": "Situated in GST Road, Guduvancherry"
  }
}'
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "space_defaultroom": {
    "description": "Situated in GST Road, Guduvancherry"
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
  "space_defaultroom": {
    "description": "Situated in GST Road, Guduvancherry"
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "space_defaultroom": {
    "description": "Situated in GST Road, Guduvancherry"
  }
}'''
data = urlencode({"input_data":input_data}).encode()
httprequest = Request(url, headers=headers,data=data, method="PUT")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "space_defaultroom": {
        "occupied_capacity": "0",
        "common_module": "space_room",
        "amenities": [
            {
                "name": "Wifi Access",
                "description": null,
                "id": "100000000000040482",
                "icon_name": "wifi_access"
            },
            {
                "name": "Uninterrupted Power",
                "description": null,
                "id": "100000000000040512",
                "icon_name": "uninterrupted_power"
            }
        ],
        "attachments": [
            {
                "size": "486641",
                "content_type": "image/png",
                "file_id": "55",
                "name": "Screenshot 2025-01-24 at 11.06.42\u202fAM.png",
                "content_url": "/space_defaultrooms/100000000000043254/_uploads/55",
                "id": "100000000000043260"
            }
        ],
        "space_building": {
            "name": "Signature Tower",
            "id": "100000000000043152",
            "type": {
                "id": "100000000000037122"
            }
        },
        "description": "Situated in GST Road, Guduvancherry",
        "space_code": "Conf",
        "criticalities": [
            {
                "name": "Chemical waste",
                "description": "The Space contains chemical waste.",
                "id": "100000000000040533",
                "icon_name": "chemical_waste"
            }
        ],
        "type": {
            "api_plural_name": "space_defaultrooms",
            "name": "space_defaultroom",
            "display_name_plural": "Default Room",
            "id": "100000000000037128",
            "display_name": "Default Room",
            "icon_name": null
        },
        "last_updated_by": {
            "email_id": "test@zmail.com",
            "is_technician": true,
            "sms_mail": "",
            "mobile": "",
            "last_name": "",
            "user_scope": "internal_user",
            "sms_mail_id": "",
            "cost_per_hour": "0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "100000000000006824",
                "is_default": true
            },
            "phone": "",
            "employee_id": "",
            "name": "tech",
            "id": "100000000000043064",
            "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=16704982&t=user&height=60&width=60",
            "is_vip_user": false,
            "department": null,
            "first_name": "tech",
            "job_title": ""
        },
        "id": "100000000000043254",
        "department": {
            "site": {
                "id": "100000000000006824"
            },
            "name": "Space",
            "id": "100000000000038648"
        },
        "display_image": "55",
        "total_capacity": "20",
        "space_campus": {
            "name": "Estancia",
            "id": "100000000000043080",
            "type": {
                "id": "100000000000037120"
            }
        },
        "area": {
            "area_unit": {
                "deleted": false,
                "name": "Sq.meter",
                "id": "100000000000040548",
                "is_default": true
            },
            "space_area": "500"
        },
        "created_time": {
            "display_value": "Jan 30, 2025 01:37 PM",
            "value": "1738224452757"
        },
        "is_room_partitionable": false,
        "space_room": null,
        "is_floating_capacity": false,
        "created_by": {
            "email_id": "test@zmail.com",
            "is_technician": true,
            "sms_mail": "",
            "mobile": "",
            "last_name": "",
            "user_scope": "internal_user",
            "sms_mail_id": "",
            "cost_per_hour": "0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "100000000000006824",
                "is_default": true
            },
            "phone": "",
            "employee_id": "",
            "name": "tech",
            "id": "100000000000043064",
            "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=16704982&t=user&height=60&width=60",
            "is_vip_user": false,
            "department": null,
            "first_name": "tech",
            "job_title": ""
        },
        "available_capacity": 20,
        "room_layouts": [
            {
                "layout": {
                    "name": "Boardroom",
                    "description": "Centrally located table.",
                    "id": "100000000000040521",
                    "icon_name": "boardroom"
                },
                "id": "100000000000043256",
                "capacity": 10
            },
            {
                "layout": {
                    "name": "Theatre",
                    "description": "Row wise seating towards one side.",
                    "id": "100000000000040524",
                    "icon_name": "theatre"
                },
                "id": "100000000000043258",
                "capacity": 10
            }
        ],
        "space_floor": {
            "name": "Ground floor",
            "id": "100000000000043222",
            "type": {
                "id": "100000000000037126"
            }
        },
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "100000000000006824",
            "is_default": true
        },
        "last_updated_time": {
            "display_value": "Jan 30, 2025 01:39 PM",
            "value": "1738224582367"
        },
        "available_partition_capacity": "0",
        "name": "Conference hall",
        "partition_capacity": 0,
        "status": {
            "color": "#00C408",
            "name": "Active",
            "id": "100000000000040570"
        },
        "supervisors": [
            {
                "email_id": "jeniffer.doe@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "Doe",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "id": "100000000000006824"
                },
                "phone": null,
                "employee_id": "1005",
                "name": "Jeniffer Doe",
                "id": "100000000000041924",
                "is_vip_user": false,
                "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=-1&t=user&height=60&width=60",
                "department": null,
                "first_name": "Jeniffer",
                "job_title": null
            }
        ]
    }
}

获取 Room

此操作用于获取单个房间

Url

<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}

属性

id (long)
唯一标识符,用于标识 Room

id (long)
被认为具有较大值的数字位数。

示例

234759602834500

name (string)
用于标识 Room 的名称 [最大长度:250]

name (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

description (string)
Room 描述

description (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

space_code (string)
唯一名称,用于标识 Room [最大长度:250]

space_code (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

display_image (string)
包含用作默认 Room 图片的图像附件 id

display_image (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

total_capacity (long)
表示 Room 的总容量

total_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

更多属性 展开全部

occupied_capacity (long)

表示 Room 的已占用容量

occupied_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

type (sp_type)

表示 Room 的类型

type (sp_type)

space_attributes (space_attributes)

包含 Room 的 udf 字段

space_attributes (space_attributes)

site (site)

表示 Room 所属站点

site (site)

设施 (sp_amenity)

包含房间内所有设施的集合

设施 (sp_amenity)

criticalities (sp_criticality)

包含房间内所有关键性的集合

criticalities (sp_criticality)

room_layouts (room_layout_mapping)

包含空间内所有可用房间布局及其容量的集合

room_layouts (room_layout_mapping)

status (sp_status)

指示房间的状态

status (sp_status)

attachments (attachment)

包含房间的所有附件

attachments (attachment)

supervisors (technician)

指示房间的主管

supervisors (technician)

area (JSONObject)

指示房间的面积及其单位 
show attribute

area (JSONObject)

created_by (user)read only

指示创建房间的用户

created_by (user)

created_time (datetime)read only

指示房间创建的时间

created_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

last_updated_by (user)read only

指示最近编辑房间的用户

last_updated_by (user)

last_updated_time (datetime)read only

指示房间最近编辑的时间

last_updated_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

available_capacity (long)read only

指示房间的可用容量

available_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

space_campus (space)

指示房间所在的校园

space_campus (space)
指示房间所在的校园

示例

{
  "space_campus": {
    "id": "99999000000043495",
    "name": "Estancia",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036766"
    }
  }
}

space_building (space)

指示房间所在的大楼

space_building (space)
指示房间所在的大楼

示例

{
  "space_building": {
    "id": "99999000000043501",
    "name": "Signture Tower",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036768"
    }
  }
}

space_floor (space)

指示房间所在的楼层

space_floor (space)
指示房间所在的楼层

示例

{
  "space_floor": {
    "id": "99999000000043511",
    "name": "First Floor",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036772"
    }
  }
}

department (department)

指示房间所属的部门

department (department)
指示房间所属的部门

示例

{
  "department": {
    "id": "99999000000038431",
    "name": "Facility Services",
    "site": {
      "id": "99999000000006750"
    }
  }
}

is_room_partitionable (boolean)

指示房间是否包含隔断

is_room_partitionable (boolean)
指示房间是否包含隔断

示例

false

is_floating_capacity (boolean)

指示房间的总容量和占用容量是否包含在父级容量计算中

is_floating_capacity (boolean)
指示房间的总容量和占用容量是否包含在父级容量计算中

示例

false

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}\
      -X GET\
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};          
response = invokeurl
[
    url: url
    type: GET
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}  
$response = Invoke-RestMethod -Uri $url -Method get -Headers $headers 
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
    "response_status": {
        "status_code": 2000,
        "status": "success"
    },
    "space_defaultroom": {
        "occupied_capacity": "0",
        "common_module": "space_room",
        "amenities": [
            {
                "name": "Wifi Access",
                "description": null,
                "id": "100000000000040482",
                "icon_name": "wifi_access"
            },
            {
                "name": "Uninterrupted Power",
                "description": null,
                "id": "100000000000040512",
                "icon_name": "uninterrupted_power"
            }
        ],
        "attachments": [
            {
                "size": "486641",
                "content_type": "image/png",
                "file_id": "55",
                "name": "Screenshot 2025-01-24 at 11.06.42\u202fAM.png",
                "content_url": "/space_defaultrooms/100000000000043254/_uploads/55",
                "id": "100000000000043260"
            }
        ],
        "space_building": {
            "name": "Signature Tower",
            "id": "100000000000043152",
            "type": {
                "id": "100000000000037122"
            }
        },
        "description": "meetings will be held here",
        "space_code": "Conf",
        "criticalities": [
            {
                "name": "Chemical waste",
                "description": "The Space contains chemical waste.",
                "id": "100000000000040533",
                "icon_name": "chemical_waste"
            }
        ],
        "type": {
            "api_plural_name": "space_defaultrooms",
            "name": "space_defaultroom",
            "display_name_plural": "Default Room",
            "id": "100000000000037128",
            "display_name": "Default Room",
            "icon_name": null
        },
        "last_updated_by": null,
        "id": "100000000000043254",
        "department": {
            "site": {
                "id": "100000000000006824"
            },
            "name": "Space",
            "id": "100000000000038648"
        },
        "display_image": "55",
        "total_capacity": "20",
        "space_campus": {
            "name": "Estancia",
            "id": "100000000000043080",
            "type": {
                "id": "100000000000037120"
            }
        },
        "area": {
            "area_unit": {
                "deleted": false,
                "name": "Sq.meter",
                "id": "100000000000040548",
                "is_default": true
            },
            "space_area": "500"
        },
        "created_time": {
            "display_value": "Jan 30, 2025 01:37 PM",
            "value": "1738224452757"
        },
        "is_room_partitionable": false,
        "space_room": null,
        "is_floating_capacity": false,
        "created_by": {
            "email_id": "test@zmail.com",
            "is_technician": true,
            "sms_mail": "",
            "mobile": "",
            "last_name": "",
            "user_scope": "internal_user",
            "sms_mail_id": "",
            "cost_per_hour": "0",
            "site": {
                "deleted": false,
                "name": "Base Site",
                "id": "100000000000006824",
                "is_default": true
            },
            "phone": "",
            "employee_id": "",
            "name": "tech",
            "id": "100000000000043064",
            "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=16704982&t=user&height=60&width=60",
            "is_vip_user": false,
            "department": null,
            "first_name": "tech",
            "job_title": ""
        },
        "available_capacity": 20,
        "room_layouts": [
            {
                "layout": {
                    "name": "Boardroom",
                    "description": "Centrally located table.",
                    "id": "100000000000040521",
                    "icon_name": "boardroom"
                },
                "id": "100000000000043256",
                "capacity": 10
            },
            {
                "layout": {
                    "name": "Theatre",
                    "description": "Row wise seating towards one side.",
                    "id": "100000000000040524",
                    "icon_name": "theatre"
                },
                "id": "100000000000043258",
                "capacity": 10
            }
        ],
        "space_floor": {
            "name": "Ground floor",
            "id": "100000000000043222",
            "type": {
                "id": "100000000000037126"
            }
        },
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "100000000000006824",
            "is_default": true
        },
        "last_updated_time": null,
        "available_partition_capacity": "0",
        "name": "Conference hall",
        "partition_capacity": 0,
        "status": {
            "color": "#00C408",
            "name": "Active",
            "id": "100000000000040570"
        },
        "supervisors": [
            {
                "email_id": "jeniffer.doe@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "Doe",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "id": "100000000000006824"
                },
                "phone": null,
                "employee_id": "1005",
                "name": "Jeniffer Doe",
                "id": "100000000000041924",
                "is_vip_user": false,
                "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=-1&t=user&height=60&width=60",
                "department": null,
                "first_name": "Jeniffer",
                "job_title": null
            }
        ]
    }
}

获取 Room 列表

此操作用于获取所有房间列表

Url

<service domain|custom domain>/app/<portal>/api/v3/space_rooms

属性

id (long)
唯一标识符,用于标识 Room

id (long)
被认为具有较大值的数字位数。

示例

234759602834500

name (string)
用于标识 Room 的名称 [最大长度:250]

name (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

description (string)
Room 描述

description (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

space_code (string)
唯一名称,用于标识 Room [最大长度:250]

space_code (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

display_image (string)
包含用作默认 Room 图片的图像附件 id

display_image (string)
纯文本格式。不允许富文本或换行符。

示例

Sample Content

total_capacity (long)
表示 Room 的总容量

total_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

更多属性 展开全部

occupied_capacity (long)

表示 Room 的已占用容量

occupied_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

type (sp_type)

表示 Room 的类型

type (sp_type)

space_attributes (space_attributes)

包含 Room 的 udf 字段

space_attributes (space_attributes)

site (site)

表示 Room 所属站点

site (site)

设施 (sp_amenity)

包含房间内所有设施的集合

设施 (sp_amenity)

criticalities (sp_criticality)

包含房间内所有关键性的集合

criticalities (sp_criticality)

room_layouts (room_layout_mapping)

包含空间内所有可用房间布局及其容量的集合

room_layouts (room_layout_mapping)

status (sp_status)

指示房间的状态

status (sp_status)

attachments (attachment)

包含房间的所有附件

attachments (attachment)

supervisors (technician)

指示房间的主管

supervisors (technician)

area (JSONObject)

指示房间的面积及其单位 
show attribute

area (JSONObject)

created_by (user)read only

指示创建房间的用户

created_by (user)

created_time (datetime)read only

指示房间创建的时间

created_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

last_updated_by (user)read only

指示最近编辑房间的用户

last_updated_by (user)

last_updated_time (datetime)read only

指示房间最近编辑的时间

last_updated_time (datetime)
以 JSON 对象形式表示日期/时间。包含 value 和 display_value 属性。

value :以长整型格式表示的时间(从1970年1月1日起的毫秒数)。

display_value :以用户个性化格式显示的可读时间。如果未个性化,将使用默认格式。

available_capacity (long)read only

指示房间的可用容量

available_capacity (long)
被认为具有较大值的数字位数。

示例

234759602834500

space_campus (space)

指示房间所在的校园

space_campus (space)
指示房间所在的校园

示例

{
  "space_campus": {
    "id": "99999000000043495",
    "name": "Estancia",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036766"
    }
  }
}

space_building (space)

指示房间所在的大楼

space_building (space)
指示房间所在的大楼

示例

{
  "space_building": {
    "id": "99999000000043501",
    "name": "Signture Tower",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036768"
    }
  }
}

space_floor (space)

指示房间所在的楼层

space_floor (space)
指示房间所在的楼层

示例

{
  "space_floor": {
    "id": "99999000000043511",
    "name": "First Floor",
    "status": {
      "id": "99999000000040433"
    },
    "type": {
      "id": "99999000000036772"
    }
  }
}

department (department)

指示房间所属的部门

department (department)
指示房间所属的部门

示例

{
  "department": {
    "id": "99999000000038431",
    "name": "Facility Services",
    "site": {
      "id": "99999000000006750"
    }
  }
}

is_room_partitionable (boolean)

指示房间是否包含隔断

is_room_partitionable (boolean)
指示房间是否包含隔断

示例

false

is_floating_capacity (boolean)

指示房间的总容量和占用容量是否包含在父级容量计算中

is_floating_capacity (boolean)
指示房间的总容量和占用容量是否包含在父级容量计算中

示例

false

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/space_rooms\
      -X GET\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"\
      --data-urlencode input_data=''
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/space_rooms";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = ;
params = {"input_data":input_data};           
response = invokeurl
[
    url: url
    type: GET
    parameters:params
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/space_rooms"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @''@
$data = @{ 'input_data' = $input_data}    
$response = Invoke-RestMethod -Uri $url -Method get -Body $data -Headers $headers 
$response
#Python version - 3.8
#This script requires requests module installed in python.
from urllib.error import HTTPError
from urllib.parse import urlencode
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/space_rooms"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = ''''''       
url += "?" + urlencode({"input_data":input_data})
httprequest = Request(url, headers=headers)
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
  "space_rooms": [
    {
      "occupied_capacity": "0",
      "common_module": "space_room",
      "space_building": {
        "name": "Signature Tower",
        "id": "100000000000043152",
        "type": {
          "id": "100000000000037122"
        }
      },
      "description": "meetings will be held here",
      "space_code": "Conf",
      "type": {
        "api_plural_name": "space_defaultrooms",
        "name": "space_defaultroom",
        "display_name_plural": "Default Room",
        "id": "100000000000037128",
        "display_name": "Default Room",
        "icon_name": null
      },
      "last_updated_by": null,
      "id": "100000000000043254",
      "department": {
        "site": {
          "id": "100000000000006824"
        },
        "name": "Space",
        "id": "100000000000038648"
      },
      "display_image": "55",
      "total_capacity": "20",
      "space_campus": {
        "name": "Estancia",
        "id": "100000000000043080",
        "type": {
          "id": "100000000000037120"
        }
      },
      "area": {
        "area_unit": {
          "deleted": false,
          "name": "Sq.meter",
          "id": "100000000000040548",
          "is_default": true
        },
        "space_area": "500"
      },
      "created_time": {
        "display_value": "Jan 30, 2025 01:37 PM",
        "value": "1738224452757"
      },
      "is_room_partitionable": false,
      "space_room": null,
      "is_floating_capacity": false,
      "created_by": {
        "email_id": "test@zmail.com",
        "is_technician": true,
        "sms_mail": "",
        "mobile": "",
        "last_name": "",
        "user_scope": "internal_user",
        "sms_mail_id": "",
        "cost_per_hour": "0",
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "100000000000006824",
          "is_default": true
        },
        "phone": "",
        "employee_id": "",
        "name": "tech",
        "id": "100000000000043064",
        "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=16704982&t=user&height=60&width=60",
        "is_vip_user": false,
        "department": null,
        "first_name": "tech",
        "job_title": ""
      },
      "available_capacity": 20,
      "space_floor": {
        "name": "Ground floor",
        "id": "100000000000043222",
        "type": {
          "id": "100000000000037126"
        }
      },
      "site": {
        "deleted": false,
        "name": "Base Site",
        "id": "100000000000006824",
        "is_default": true
      },
      "last_updated_time": null,
      "available_partition_capacity": "0",
      "name": "Conference hall",
      "partition_capacity": 0,
      "status": {
        "color": "#00C408",
        "name": "Active",
        "id": "100000000000040570"
      }
    },
    {
      "occupied_capacity": "0",
      "common_module": "space_room",
      "space_building": {
        "name": "Signature Tower",
        "id": "100000000000043152",
        "type": {
          "id": "100000000000037122"
        }
      },
      "description": "meetings will be held here",
      "space_code": null,
      "type": {
        "api_plural_name": "space_defaultrooms",
        "name": "space_defaultroom",
        "display_name_plural": "Default Room",
        "id": "100000000000037128",
        "display_name": "Default Room",
        "icon_name": null
      },
      "last_updated_by": null,
      "id": "100000000000043274",
      "department": {
        "site": {
          "id": "100000000000006824"
        },
        "name": "Space",
        "id": "100000000000038648"
      },
      "display_image": null,
      "total_capacity": "20",
      "space_campus": {
        "name": "Estancia",
        "id": "100000000000043080",
        "type": {
          "id": "100000000000037120"
        }
      },
      "area": {
        "area_unit": {
          "deleted": false,
          "name": "Sq.meter",
          "id": "100000000000040548",
          "is_default": true
        },
        "space_area": "500"
      },
      "created_time": {
        "display_value": "Jan 30, 2025 01:38 PM",
        "value": "1738224510358"
      },
      "is_room_partitionable": false,
      "space_room": null,
      "is_floating_capacity": false,
      "created_by": {
        "email_id": "test@zmail.com",
        "is_technician": true,
        "sms_mail": "",
        "mobile": "",
        "last_name": "",
        "user_scope": "internal_user",
        "sms_mail_id": "",
        "cost_per_hour": "0",
        "site": {
          "deleted": false,
          "name": "Base Site",
          "id": "100000000000006824",
          "is_default": true
        },
        "phone": "",
        "employee_id": "",
        "name": "tech",
        "id": "100000000000043064",
        "photo_url": "https://contacts.csez.zohocorpin.com/file?exp=10&ID=16704982&t=user&height=60&width=60",
        "is_vip_user": false,
        "department": null,
        "first_name": "tech",
        "job_title": ""
      },
      "available_capacity": 20,
      "space_floor": {
        "name": "Ground floor",
        "id": "100000000000043222",
        "type": {
          "id": "100000000000037126"
        }
      },
      "site": {
        "deleted": false,
        "name": "Base Site",
        "id": "100000000000006824",
        "is_default": true
      },
      "last_updated_time": null,
      "available_partition_capacity": "0",
      "name": "Copy of Conference hall-1",
      "partition_capacity": 0,
      "status": {
        "color": "#00C408",
        "name": "Active",
        "id": "100000000000040570"
      }
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "sort_field": "name",
    "row_count": 2
  }
}

删除 Room

此操作允许删除房间

Url

<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}

$ curl <service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}\
      -X DELETE\ 
      -H "Accept: application/vnd.manageengine.sdp.v3+json"\
      -H "Authorization: Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"\
      -H "Content-Type: application/x-www-form-urlencoded"
// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
response = invokeurl
[
    url: url
    type: DELETE
    headers: headers
];
info response;
#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$response = Invoke-RestMethod -Uri $url -Method delete -Headers $headers
$response
#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/{room_type_api_name}/{room_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
httprequest = Request(url, headers=headers,method="DELETE")
try:
    with urlopen(httprequest) as response:
        print(response.read().decode())
except HTTPError as e:
    print(e.read().decode())
{
  "response_status": {
    "status_code": 2000,
    "status": "success"
  }
}