非建筑物

它代表校园内的一个结构，无法细分为楼层和房间。

属性

id （长整型）
用于标识非建筑物的唯一标识符

name （字符串）
用于识别非建筑物的名称 [最大长度：250]

description （字符串）
非建筑物的描述

space_code （字符串）
用于识别非建筑物的唯一名称 [最大长度：250]

display_image （字符串）
包含作为默认非建筑物图像使用的图片附件 id

total_capacity （长整型）
表示非建筑物的总容量

更多属性 展开全部

occupied_capacity （长整型）

表示非建筑物的已用容量

type （sp_type）

表示非建筑物的类型

space_attributes （space_attributes）

包含非建筑物的自定义字段

site （site）

表示非建筑物所在站点

amenities (sp_amenity)

包含非建筑物中存在的设施集合

关键性 (sp_criticality)

包含非建筑物中存在的关键性集合

状态 (sp_status)

表示非建筑物的状态

附件 (attachment)

包含非建筑物的附件

主管 (technician)

表示非建筑物的主管

区域 (JSONObject)

表示非建筑物的区域及单位
显示属性

创建者 (user)read only

表示创建非建筑物的用户

创建时间 (datetime)read only

表示非建筑物创建的时间

最近更新者 (user)read only

表示最近编辑非建筑物的用户

最近更新时间 (datetime)read only

表示非建筑物最近编辑的时间

可用容量 （长整型）read only

表示非建筑物的可用容量【只读】

结构类型 （字符串）

表示结构是“Building”还是“Nonbuilding Structure”

空间校园 (space)

表示建筑所在的校园

空间校园 (space)
表示建筑所在的校园

示例

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

添加非建筑物

此操作用于创建非建筑物

必填字段：- name

URL

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

属性

id （长整型）
用于标识非建筑物的唯一标识符

name （字符串）
用于识别非建筑物的名称 [最大长度：250]

description （字符串）
非建筑物的描述

space_code （字符串）
用于识别非建筑物的唯一名称 [最大长度：250]

display_image （字符串）
包含作为默认非建筑物图像使用的图片附件 id

total_capacity （长整型）
表示非建筑物的总容量

更多属性 展开全部

occupied_capacity （长整型）

表示非建筑物的已用容量

type （sp_type）

表示非建筑物的类型

space_attributes （space_attributes）

包含非建筑物的自定义字段

site （site）

表示非建筑物所在站点

amenities (sp_amenity)

包含非建筑物中存在的设施集合

关键性 (sp_criticality)

包含非建筑物中存在的关键性集合

状态 (sp_status)

表示非建筑物的状态

附件 (attachment)

包含非建筑物的附件

主管 (technician)

表示非建筑物的主管

区域 (JSONObject)

表示非建筑物的区域及单位
显示属性

创建者 (user)read only

表示创建非建筑物的用户

创建时间 (datetime)read only

表示非建筑物创建的时间

最近更新者 (user)read only

表示最近编辑非建筑物的用户

最近更新时间 (datetime)read only

表示非建筑物最近编辑的时间

可用容量 （长整型）read only

表示非建筑物的可用容量【只读】

结构类型 （字符串）

表示结构是“Building”还是“Nonbuilding Structure”

空间校园 (space)

表示建筑所在的校园

空间校园 (space)
表示建筑所在的校园

示例

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

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_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_defaultnonbuilding": {
    "name": "Non building",
    "description": "a simple space",
    "space_campus": {
      "id": "100000000000043080"
    },
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "10000",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "0",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041898"
      }
    ],
    "space_code": "non-building",
    "amenities": [
      {
        "id": "100000000000040461"
      },
      {
        "id": "100000000000040470"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040536"
      }
    ],
    "attachments": [
      {
        "file_id": "53"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_building": null,
    "space_floor": null,
    "space_room": null,
    "display_image": "53"
  }
}'

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_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_defaultnonbuilding": {
    "name": "Non building",
    "description": "a simple space",
    "space_campus": {
      "id": "100000000000043080"
    },
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "10000",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "0",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041898"
      }
    ],
    "space_code": "non-building",
    "amenities": [
      {
        "id": "100000000000040461"
      },
      {
        "id": "100000000000040470"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040536"
      }
    ],
    "attachments": [
      {
        "file_id": "53"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_building": null,
    "space_floor": null,
    "space_room": null,
    "display_image": "53"
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: POST
    parameters: params
    headers: headers
];
info response;

Powershell

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_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_defaultnonbuilding": {
    "name": "Non building",
    "description": "a simple space",
    "space_campus": {
      "id": "100000000000043080"
    },
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "10000",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "0",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041898"
      }
    ],
    "space_code": "non-building",
    "amenities": [
      {
        "id": "100000000000040461"
      },
      {
        "id": "100000000000040470"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040536"
      }
    ],
    "attachments": [
      {
        "file_id": "53"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_building": null,
    "space_floor": null,
    "space_room": null,
    "display_image": "53"
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method post -Body $data -Headers $headers
$response

Python

#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/{nonbuilding_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_defaultnonbuilding": {
    "name": "Non building",
    "description": "a simple space",
    "space_campus": {
      "id": "100000000000043080"
    },
    "status": {
      "id": "100000000000040570"
    },
    "area": {
      "space_area": "10000",
      "area_unit": {
        "id": "100000000000040548"
      }
    },
    "total_capacity": "0",
    "occupied_capacity": "0",
    "supervisors": [
      {
        "id": "100000000000041898"
      }
    ],
    "space_code": "non-building",
    "amenities": [
      {
        "id": "100000000000040461"
      },
      {
        "id": "100000000000040470"
      }
    ],
    "criticalities": [
      {
        "id": "100000000000040536"
      }
    ],
    "attachments": [
      {
        "file_id": "53"
      }
    ],
    "site": {
      "id": "100000000000006824"
    },
    "space_building": null,
    "space_floor": null,
    "space_room": null,
    "display_image": "53"
  }
}'''
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_defaultnonbuilding": {
        "occupied_capacity": "0",
        "common_module": "space_nonbuilding",
        "amenities": [
            {
                "name": "Indoor Games",
                "description": null,
                "id": "100000000000040461",
                "icon_name": "indoor_games"
            },
            {
                "name": "Laundry",
                "description": null,
                "id": "100000000000040470",
                "icon_name": "laundry"
            }
        ],
        "attachments": [
            {
                "size": "558912",
                "content_type": "image/png",
                "file_id": "53",
                "name": "Screenshot 2025-01-24 at 3.35.48\u202fPM.png",
                "content_url": "/space_defaultnonbuildings/100000000000043186/_uploads/53",
                "id": "100000000000043188"
            }
        ],
        "space_building": null,
        "structure_type": "Nonbuilding",
        "description": "a simple space",
        "space_code": "non-building",
        "criticalities": [
            {
                "name": "Hazardous",
                "description": "The Space contains hazardous substance.",
                "id": "100000000000040536",
                "icon_name": "hazardous"
            }
        ],
        "type": {
            "api_plural_name": "space_defaultnonbuildings",
            "name": "space_defaultnonbuilding",
            "display_name_plural": "Default Nonbuilding Structure",
            "id": "100000000000037124",
            "display_name": "Default Nonbuilding Structure",
            "icon_name": null
        },
        "last_updated_by": null,
        "id": "100000000000043186",
        "display_image": "53",
        "total_capacity": "0",
        "space_campus": {
            "name": "Estancia",
            "id": "100000000000043080",
            "type": {
                "id": "100000000000037120"
            }
        },
        "area": {
            "area_unit": {
                "deleted": false,
                "name": "Sq.meter",
                "id": "100000000000040548",
                "is_default": true
            },
            "space_area": "10000"
        },
        "created_time": {
            "display_value": "Jan 30, 2025 01:24 PM",
            "value": "1738223684528"
        },
        "space_room": null,
        "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": 0,
        "room_layouts": [],
        "space_floor": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "100000000000006824",
            "is_default": true
        },
        "last_updated_time": null,
        "name": "Non building",
        "status": {
            "color": "#00C408",
            "name": "Active",
            "id": "100000000000040570"
        },
        "supervisors": [
            {
                "email_id": "john.roberts@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "Roberts",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "id": "100000000000006824"
                },
                "phone": null,
                "employee_id": "1003",
                "name": "John Roberts",
                "id": "100000000000041898",
                "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": "John",
                "job_title": null
            }
        ],
        "building_type": null
    }
}

编辑非建筑物

此操作用于编辑非建筑物

URL

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

属性

id （长整型）
用于标识非建筑物的唯一标识符

name （字符串）
用于识别非建筑物的名称 [最大长度：250]

description （字符串）
非建筑物的描述

space_code （字符串）
用于识别非建筑物的唯一名称 [最大长度：250]

display_image （字符串）
包含作为默认非建筑物图像使用的图片附件 id

total_capacity （长整型）
表示非建筑物的总容量

更多属性 展开全部

occupied_capacity （长整型）

表示非建筑物的已用容量

type （sp_type）

表示非建筑物的类型

space_attributes （space_attributes）

包含非建筑物的自定义字段

site （site）

表示非建筑物所在站点

amenities (sp_amenity)

包含非建筑物中存在的设施集合

关键性 (sp_criticality)

包含非建筑物中存在的关键性集合

附件 (attachment)

包含非建筑物的附件

主管 (technician)

表示非建筑物的主管

区域 (JSONObject)

表示非建筑物的区域及单位
显示属性

创建者 (user)read only

表示创建非建筑物的用户

创建时间 (datetime)read only

表示非建筑物创建的时间

最近更新者 (user)read only

表示最近编辑非建筑物的用户

最近更新时间 (datetime)read only

表示非建筑物最近编辑的时间

可用容量 （长整型）read only

表示非建筑物的可用容量【只读】

结构类型 （字符串）

表示结构是“Building”还是“Nonbuilding Structure”

空间校园 (space)

表示建筑所在的校园

空间校园 (space)
表示建筑所在的校园

示例

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

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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_defaultnonbuilding": {
    "description": "Situated in GST Road, Guduvancherry"
  }
}'

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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_defaultnonbuilding": {
    "description": "Situated in GST Road, Guduvancherry"
  }
};
params = {"input_data": input_data};
response = invokeurl
[
    url: url
    type: PUT
    parameters: params
    headers: headers
];
info response;

Powershell

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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_defaultnonbuilding": {
    "description": "Situated in GST Road, Guduvancherry"
  }
}
'@
$data = @{ 'input_data' = $input_data}
$response = Invoke-RestMethod -Uri $url -Method put -Body $data -Headers $headers
$response

Python

#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/{nonbuilding_type_api_name}/{nonbuilding_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_defaultnonbuilding": {
    "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_defaultnonbuilding": {
        "occupied_capacity": "0",
        "common_module": "space_nonbuilding",
        "amenities": [
            {
                "name": "Indoor Games",
                "description": null,
                "id": "100000000000040461",
                "icon_name": "indoor_games"
            },
            {
                "name": "Laundry",
                "description": null,
                "id": "100000000000040470",
                "icon_name": "laundry"
            }
        ],
        "attachments": [
            {
                "size": "558912",
                "content_type": "image/png",
                "file_id": "53",
                "name": "Screenshot 2025-01-24 at 3.35.48\u202fPM.png",
                "content_url": "/space_defaultnonbuildings/100000000000043186/_uploads/53",
                "id": "100000000000043188"
            }
        ],
        "space_building": null,
        "structure_type": "Nonbuilding",
        "description": "Situated in GST Road, Guduvancherry",
        "space_code": "non-building",
        "criticalities": [
            {
                "name": "Hazardous",
                "description": "The Space contains hazardous substance.",
                "id": "100000000000040536",
                "icon_name": "hazardous"
            }
        ],
        "type": {
            "api_plural_name": "space_defaultnonbuildings",
            "name": "space_defaultnonbuilding",
            "display_name_plural": "Default Nonbuilding Structure",
            "id": "100000000000037124",
            "display_name": "Default Nonbuilding Structure",
            "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": "100000000000043186",
        "display_image": "53",
        "total_capacity": "0",
        "space_campus": {
            "name": "Estancia",
            "id": "100000000000043080",
            "type": {
                "id": "100000000000037120"
            }
        },
        "area": {
            "area_unit": {
                "deleted": false,
                "name": "Sq.meter",
                "id": "100000000000040548",
                "is_default": true
            },
            "space_area": "10000"
        },
        "created_time": {
            "display_value": "Jan 30, 2025 01:24 PM",
            "value": "1738223684528"
        },
        "space_room": null,
        "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": 0,
        "room_layouts": [],
        "space_floor": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "100000000000006824",
            "is_default": true
        },
        "last_updated_time": {
            "display_value": "Jan 30, 2025 01:26 PM",
            "value": "1738223812215"
        },
        "name": "Non building",
        "status": {
            "color": "#00C408",
            "name": "Active",
            "id": "100000000000040570"
        },
        "supervisors": [
            {
                "email_id": "john.roberts@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "Roberts",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "id": "100000000000006824"
                },
                "phone": null,
                "employee_id": "1003",
                "name": "John Roberts",
                "id": "100000000000041898",
                "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": "John",
                "job_title": null
            }
        ],
        "building_type": null
    }
}

获取非建筑物

此操作用于获取单个非建筑物

URL

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

属性

id （长整型）
用于标识非建筑物的唯一标识符

name （字符串）
用于识别非建筑物的名称 [最大长度：250]

description （字符串）
非建筑物的描述

space_code （字符串）
用于识别非建筑物的唯一名称 [最大长度：250]

display_image （字符串）
包含作为默认非建筑物图像使用的图片附件 id

total_capacity （长整型）
表示非建筑物的总容量

更多属性 展开全部

occupied_capacity （长整型）

表示非建筑物的已用容量

type （sp_type）

表示非建筑物的类型

space_attributes （space_attributes）

包含非建筑物的自定义字段

site （site）

表示非建筑物所在站点

amenities (sp_amenity)

包含非建筑物中存在的设施集合

关键性 (sp_criticality)

包含非建筑物中存在的关键性集合

状态 (sp_status)

表示非建筑物的状态

附件 (attachment)

包含非建筑物的附件

主管 (technician)

表示非建筑物的主管

区域 (JSONObject)

表示非建筑物的区域及单位
显示属性

创建者 (user)read only

表示创建非建筑物的用户

创建时间 (datetime)read only

表示非建筑物创建的时间

最近更新者 (user)read only

表示最近编辑非建筑物的用户

最近更新时间 (datetime)read only

表示非建筑物最近编辑的时间

可用容量 （长整型）read only

表示非建筑物的可用容量【只读】

结构类型 （字符串）

表示结构是“Building”还是“Nonbuilding Structure”

空间校园 (space)

表示建筑所在的校园

空间校园 (space)
表示建筑所在的校园

示例

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

Curl

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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

#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/{nonbuilding_type_api_name}/{nonbuilding_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_defaultnonbuilding": {
        "occupied_capacity": "0",
        "common_module": "space_nonbuilding",
        "amenities": [
            {
                "name": "Indoor Games",
                "description": null,
                "id": "100000000000040461",
                "icon_name": "indoor_games"
            },
            {
                "name": "Laundry",
                "description": null,
                "id": "100000000000040470",
                "icon_name": "laundry"
            }
        ],
        "attachments": [
            {
                "size": "558912",
                "content_type": "image/png",
                "file_id": "53",
                "name": "Screenshot 2025-01-24 at 3.35.48\u202fPM.png",
                "content_url": "/space_defaultnonbuildings/100000000000043186/_uploads/53",
                "id": "100000000000043188"
            }
        ],
        "space_building": null,
        "structure_type": "Nonbuilding",
        "description": "a simple space",
        "space_code": "non-building",
        "criticalities": [
            {
                "name": "Hazardous",
                "description": "The Space contains hazardous substance.",
                "id": "100000000000040536",
                "icon_name": "hazardous"
            }
        ],
        "type": {
            "api_plural_name": "space_defaultnonbuildings",
            "name": "space_defaultnonbuilding",
            "display_name_plural": "Default Nonbuilding Structure",
            "id": "100000000000037124",
            "display_name": "Default Nonbuilding Structure",
            "icon_name": null
        },
        "last_updated_by": null,
        "id": "100000000000043186",
        "display_image": "53",
        "total_capacity": "0",
        "space_campus": {
            "name": "Estancia",
            "id": "100000000000043080",
            "type": {
                "id": "100000000000037120"
            }
        },
        "area": {
            "area_unit": {
                "deleted": false,
                "name": "Sq.meter",
                "id": "100000000000040548",
                "is_default": true
            },
            "space_area": "10000"
        },
        "created_time": {
            "display_value": "Jan 30, 2025 01:24 PM",
            "value": "1738223684528"
        },
        "space_room": null,
        "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": 0,
        "room_layouts": [],
        "space_floor": null,
        "site": {
            "deleted": false,
            "name": "Base Site",
            "id": "100000000000006824",
            "is_default": true
        },
        "last_updated_time": null,
        "name": "Non building",
        "status": {
            "color": "#00C408",
            "name": "Active",
            "id": "100000000000040570"
        },
        "supervisors": [
            {
                "email_id": "john.roberts@zylker.com",
                "is_technician": true,
                "sms_mail": null,
                "mobile": null,
                "last_name": "Roberts",
                "user_scope": "internal_user",
                "sms_mail_id": null,
                "cost_per_hour": "0",
                "site": {
                    "id": "100000000000006824"
                },
                "phone": null,
                "employee_id": "1003",
                "name": "John Roberts",
                "id": "100000000000041898",
                "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": "John",
                "job_title": null
            }
        ],
        "building_type": null
    }
}

获取非建筑物列表

此操作用于获取所有结构的列表

URL

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

属性

id （长整型）
用于标识非建筑物的唯一标识符

name （字符串）
用于识别非建筑物的名称 [最大长度：250]

description （字符串）
非建筑物的描述

space_code （字符串）
用于识别非建筑物的唯一名称 [最大长度：250]

display_image （字符串）
包含作为默认非建筑物图像使用的图片附件 id

total_capacity （长整型）
表示非建筑物的总容量

更多属性 展开全部

occupied_capacity （长整型）

表示非建筑物的已用容量

type （sp_type）

表示非建筑物的类型

space_attributes （space_attributes）

包含非建筑物的自定义字段

site （site）

表示非建筑物所在站点

amenities (sp_amenity)

包含非建筑物中存在的设施集合

关键性 (sp_criticality)

包含非建筑物中存在的关键性集合

状态 (sp_status)

表示非建筑物的状态

附件 (attachment)

包含非建筑物的附件

主管 (technician)

表示非建筑物的主管

区域 (JSONObject)

表示非建筑物的区域及单位
显示属性

创建者 (user)read only

表示创建非建筑物的用户

创建时间 (datetime)read only

表示非建筑物创建的时间

最近更新者 (user)read only

表示最近编辑非建筑物的用户

最近更新时间 (datetime)read only

表示非建筑物最近编辑的时间

结构类型 （字符串）

表示结构是“Building”还是“Nonbuilding Structure”

空间校园 (space)

表示建筑所在的校园

空间校园 (space)
表示建筑所在的校园

示例

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

Curl

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/space_nonbuildings\
      -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

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/space_nonbuildings";
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

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/space_nonbuildings"
$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

#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_nonbuildings"
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())

{
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "space_nonbuildings": [
    {
      "occupied_capacity": "0",
      "area": {
        "area_unit": {
          "deleted": false,
          "name": "Sq.meter",
          "id": "100000000000040548",
          "is_default": true
        },
        "space_area": "10000"
      },
      "common_module": "space_nonbuilding",
      "created_time": {
        "display_value": "Jan 30, 2025 01:26 PM",
        "value": "1738223778940"
      },
      "space_building": null,
      "structure_type": "Nonbuilding",
      "space_room": null,
      "description": "a simple space",
      "space_code": null,
      "type": {
        "api_plural_name": "space_defaultnonbuildings",
        "name": "space_defaultnonbuilding",
        "display_name_plural": "Default Nonbuilding Structure",
        "id": "100000000000037124",
        "display_name": "Default Nonbuilding Structure",
        "icon_name": null
      },
      "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": 0,
      "space_floor": null,
      "last_updated_by": null,
      "site": {
        "deleted": false,
        "name": "Base Site",
        "id": "100000000000006824",
        "is_default": true
      },
      "last_updated_time": null,
      "name": "Copy of Non building-3",
      "id": "100000000000043202",
      "display_image": null,
      "total_capacity": "0",
      "space_campus": {
        "name": "Estancia",
        "id": "100000000000043080",
        "type": {
          "id": "100000000000037120"
        }
      },
      "status": {
        "color": "#00C408",
        "name": "Active",
        "id": "100000000000040570"
      },
      "building_type": null
    },
    {
      "occupied_capacity": "0",
      "area": {
        "area_unit": {
          "deleted": false,
          "name": "Sq.meter",
          "id": "100000000000040548",
          "is_default": true
        },
        "space_area": "10000"
      },
      "common_module": "space_nonbuilding",
      "created_time": {
        "display_value": "Jan 30, 2025 01:24 PM",
        "value": "1738223684528"
      },
      "space_building": null,
      "structure_type": "Nonbuilding",
      "space_room": null,
      "description": "Situated in GST Road, Guduvancherry",
      "space_code": "non-building",
      "type": {
        "api_plural_name": "space_defaultnonbuildings",
        "name": "space_defaultnonbuilding",
        "display_name_plural": "Default Nonbuilding Structure",
        "id": "100000000000037124",
        "display_name": "Default Nonbuilding Structure",
        "icon_name": null
      },
      "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": 0,
      "space_floor": 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": ""
      },
      "site": {
        "deleted": false,
        "name": "Base Site",
        "id": "100000000000006824",
        "is_default": true
      },
      "last_updated_time": {
        "display_value": "Jan 30, 2025 01:26 PM",
        "value": "1738223812215"
      },
      "name": "Non building",
      "id": "100000000000043186",
      "display_image": "53",
      "total_capacity": "0",
      "space_campus": {
        "name": "Estancia",
        "id": "100000000000043080",
        "type": {
          "id": "100000000000037120"
        }
      },
      "status": {
        "color": "#00C408",
        "name": "Active",
        "id": "100000000000040570"
      },
      "building_type": null
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "sort_field": "name",
    "row_count": 2
  }
}

删除非建筑物

此操作允许删除非建筑物

URL

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

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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

#Powershell version - 5.1
$url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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

#Python version - 3.10
from urllib.error import HTTPError
from urllib.request import urlopen,Request

url = "<service domain|custom domain>/app/<portal>/api/v3/{nonbuilding_type_api_name}/{nonbuilding_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"
  }
}