项目状态

项目状态对于了解项目进展至关重要。

属性

id (长整型)
项目状态的唯一标识符

名称 (字符串)
用于定义项目状态的名称。名称应唯一。默认可用项目状态有“Open”，“Closed”，“Canceled”和“Onhold”

描述 (字符串)
关于项目状态的简短描述

进行中 (布尔型)
项目状态是否指示项目已完成/待处理

颜色 (颜色)
用于在应用中标识项目状态的颜色代码

索引 (整数)read only
表示项目状态的顺序

更多属性 全部展开

内部名称 (字符串)read only

项目状态的内部名称

已删除 (布尔型)

表示该项目状态是否可继续使用。

添加项目状态

此操作帮助您添加项目状态。必填字段：-

必填字段：- [“name”]

Url

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

属性

id (长整型)
项目状态的唯一标识符

名称 (字符串)
用于定义项目状态的名称。名称应唯一。默认可用项目状态有“Open”，“Closed”，“Canceled”和“Onhold”

描述 (字符串)
关于项目状态的简短描述

进行中 (布尔型)
项目状态是否指示项目已完成/待处理

颜色 (颜色)
用于在应用中标识项目状态的颜色代码

索引 (整数)read only
表示项目状态的顺序

更多属性 全部展开

内部名称 (字符串)read only

项目状态的内部名称

已删除 (布尔型)

表示该项目状态是否可继续使用。

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/project_statuses\
      -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='{
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}'

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/project_statuses";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
};
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/project_statuses"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}
'@
$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/project_statuses"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}'''
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"
  },
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "internal_name": "Open",
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description",
    "index": 1,
    "id": "1970625432584455"
  }
}

编辑项目状态

此操作帮助您更新项目状态。

Url

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

属性

id (长整型)
项目状态的唯一标识符

名称 (字符串)
用于定义项目状态的名称。名称应唯一。默认可用项目状态有“Open”，“Closed”，“Canceled”和“Onhold”

描述 (字符串)
关于项目状态的简短描述

进行中 (布尔型)
项目状态是否指示项目已完成/待处理

颜色 (颜色)
用于在应用中标识项目状态的颜色代码

索引 (整数)read only
表示项目状态的顺序

更多属性 全部展开

内部名称 (字符串)read only

项目状态的内部名称

已删除 (布尔型)

表示该项目状态是否可继续使用。

Curl

$ curl <service domain|custom domain>/app/<portal>/api/v3/project_statuses/{project_status_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='{
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}'

Deluge

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/project_statuses/{project_status_id}";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
};
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/project_statuses/{project_status_id}"
$headers = @{"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
$input_data = @'
{
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}
'@
$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/project_statuses/{project_status_id}"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description"
  }
}'''
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"
  },
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "internal_name": "Open",
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description",
    "index": 1,
    "id": "1676855164551544"
  }
}

获取项目状态

此操作帮助您获取项目状态。

Url

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

属性

id (长整型)
项目状态的唯一标识符

名称 (字符串)
用于定义项目状态的名称。名称应唯一。默认可用项目状态有“Open”，“Closed”，“Canceled”和“Onhold”

描述 (字符串)
关于项目状态的简短描述

进行中 (布尔型)
项目状态是否指示项目已完成/待处理

颜色 (颜色)
用于在应用中标识项目状态的颜色代码

索引 (整数)read only
表示项目状态的顺序

更多属性 全部展开

内部名称 (字符串)read only

项目状态的内部名称

已删除 (布尔型)

表示该项目状态是否可继续使用。

Curl

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/project_statuses/{project_status_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/project_statuses/{project_status_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/project_statuses/{project_status_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/project_statuses/{project_status_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"
  },
  "project_status": {
    "in_progress": false,
    "deleted": false,
    "internal_name": "Open",
    "color": "#ffffff",
    "name": "Open",
    "description": "test-description",
    "index": 1,
    "id": "2206108515617687"
  }
}

获取项目状态列表

此操作帮助您获取所有项目状态。

Url

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

属性

id (长整型)
项目状态的唯一标识符

名称 (字符串)
用于定义项目状态的名称。名称应唯一。默认可用项目状态有“Open”，“Closed”，“Canceled”和“Onhold”

描述 (字符串)
关于项目状态的简短描述

进行中 (布尔型)
项目状态是否指示项目已完成/待处理

颜色 (颜色)
用于在应用中标识项目状态的颜色代码

索引 (整数)read only
表示项目状态的顺序

更多属性 全部展开

内部名称 (字符串)read only

项目状态的内部名称

已删除 (布尔型)

表示该项目状态是否可继续使用。

Curl

$ curl -G <service domain|custom domain>/app/<portal>/api/v3/project_statuses\
      -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/project_statuses";
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/project_statuses"
$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/project_statuses"
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"
    }
  ],
  "project_statuses": [
    {
      "in_progress": false,
      "deleted": false,
      "internal_name": "Open",
      "color": "#ffffff",
      "name": "Open",
      "description": "test-description",
      "index": 1,
      "id": "2447588681207994"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

删除项目状态

此操作帮助您删除项目状态。

Url

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

Curl

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