跳转到内容

项目成员

高效的员工单独并不能保证项目的成功。对项目员工的细致规划；赋予项目角色的权限；项目角色变更的灵活性等因素，都在确保整个项目最终成功中发挥作用。

属性

id （长整型）
项目成员的唯一标识

id （长整型）
被视为具有较大值的数字

示例 

234759602834500

project （项目）read only
项目成员所关联的项目

project （项目）
表示与项目成员关联的项目

示例 

{
  "project": {
    "display_id": {
      "display_value": "PJT-131",
      "value": "131"
    },
    "project_code": "test-project_code",
    "id": "2037672456177497",
    "title": "test-title"
  }
}

user （用户）
将被称为项目成员的用户

user （用户）
将被称为项目成员的用户

示例 

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

is_active （布尔型）
表示该成员是否在该项目中处于激活状态

is_active （布尔型）
布尔值，可取两个值。取值为 true 或 false。

role （project_role）
项目成员在该项目中的角色

role （project_role）
表示项目成员的角色

示例 

{
  "role": {
    "name": "test-role",
    "id": "234567890123456"
  }
}

添加项目成员

此操作帮助您添加项目成员。

必填字段：project，user

地址

<service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members

属性

id （长整型）
项目成员的唯一标识

id （长整型）
被视为具有较大值的数字

示例 

234759602834500

project （项目）read only
项目成员所关联的项目

project （项目）
表示与项目成员关联的项目

示例 

{
  "project": {
    "display_id": {
      "display_value": "PJT-131",
      "value": "131"
    },
    "project_code": "test-project_code",
    "id": "2037672456177497",
    "title": "test-title"
  }
}

user （用户）
将被称为项目成员的用户

user （用户）
将被称为项目成员的用户

示例 

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

is_active （布尔型）
表示该成员是否在该项目中处于激活状态

is_active （布尔型）
布尔值，可取两个值。取值为 true 或 false。

role （project_role）
项目成员在该项目中的角色

role （project_role）
表示项目成员的角色

示例 

{
  "role": {
    "name": "test-role",
    "id": "234567890123456"
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members\
      -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_member": {
    "role": {
      "name": "test-name",
      "id": "2140696265297055"
    },
    "is_active": true,
    "user": {
      "name": "Lincoln",
      "id": "1571806137496913"
    }
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members";
headers = {"Accept":"application/vnd.manageengine.sdp.v3+json",
           "Content-Type": "application/x-www-form-urlencoded",
           "Authorization": "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"};
input_data = {
  "project_member": {
    "role": {
      "name": "test-name",
      "id": "2140696265297055"
    },
    "is_active": true,
    "user": {
      "name": "Lincoln",
      "id": "1571806137496913"
    }
  }
};
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/projects/{project_id}/project_members"
$headers = @{ "Accept" = "application/vnd.manageengine.sdp.v3+json"
    "Authorization" = "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx"
    "Content-Type" = "application/x-www-form-urlencoded"}
$input_data = @'
{
  "project_member": {
    "role": {
      "name": "test-name",
      "id": "2140696265297055"
    },
    "is_active": true,
    "user": {
      "name": "Lincoln",
      "id": "1571806137496913"
    }
  }
}
'@
$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/projects/{project_id}/project_members"
headers ={"Accept": "application/vnd.manageengine.sdp.v3+json", 
          "Authorization" : "Zoho-oauthtoken 1000.7xxx98976ab0xxxxxx19901e7551be57.bxxxx921ed64c04f79622bebcfxxxxxx", 
          "Content-Type" : "application/x-www-form-urlencoded"}
input_data = '''{
  "project_member": {
    "role": {
      "name": "test-name",
      "id": "2140696265297055"
    },
    "is_active": true,
    "user": {
      "name": "Lincoln",
      "id": "1571806137496913"
    }
  }
}'''
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_member": {
    "role": {
      "name": "test-name",
      "id": "2140696265297055"
    },
    "is_active": true,
    "project": {
      "project_code": "test-project_code",
      "id": "2037672456177497",
      "display_id": {
          "display_value": "PJT-131",
          "value": "131"
        },
      "title": "test-title"
    },
    "id": "2340028203510438",
    "user": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "022-1234567890",
      "name": "Lincoln",
      "mobile": "1234567890",
      "id": "1571806137496913",
      "photo_url": "https://contacts.zoho.com/file?exp\u003d10\u0026ID\u003d123\u0026t\u003duser\u0026height\u003d60\u0026width\u003d60",
      "is_vip_user": false,
      "department": null
    }
  }
}

编辑项目成员

此操作帮助您编辑项目成员。

地址

<service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members/{project_member_id}

属性

id （长整型）
项目成员的唯一标识

id （长整型）
被视为具有较大值的数字

示例 

234759602834500

project （项目）read only
项目成员所关联的项目

project （项目）
表示与项目成员关联的项目

示例 

{
  "project": {
    "display_id": {
      "display_value": "PJT-131",
      "value": "131"
    },
    "project_code": "test-project_code",
    "id": "2037672456177497",
    "title": "test-title"
  }
}

user （用户）
将被称为项目成员的用户

user （用户）
将被称为项目成员的用户

示例 

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

is_active （布尔型）
表示该成员是否在该项目中处于激活状态

is_active （布尔型）
布尔值，可取两个值。取值为 true 或 false。

role （project_role）
项目成员在该项目中的角色

role （project_role）
表示项目成员的角色

示例 

{
  "role": {
    "name": "test-role",
    "id": "234567890123456"
  }
}


$ curl <service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members/{project_member_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_member": {
    "role": {
      "name": "test-name",
      "id": "1503425018311239"
    },
    "is_active": true
  }
}'

// Deluge Sample script
url = "<service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members/{project_member_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_member": {
    "role": {
      "name": "test-name",
      "id": "1503425018311239"
    },
    "is_active": true
  }
};
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/projects/{project_id}/project_members/{project_member_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_member": {
    "role": {
      "name": "test-name",
      "id": "1503425018311239"
    },
    "is_active": true
  }
}
'@
$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/projects/{project_id}/project_members/{project_member_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_member": {
    "role": {
      "name": "test-name",
      "id": "1503425018311239"
    },
    "is_active": true
  }
}'''
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_member": {
    "role": {
      "name": "test-name",
      "id": "1503425018311239"
    },
    "is_active": true,
    "project": {
      "project_code": "test-project_code",
      "id": "2296836596123761",
      "display_id": {
          "display_value": "PJT-131",
          "value": "131"
        },
      "title": "test-title"
    },
    "id": "2057778741006835",
    "user": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "test-phone",
      "name": "Lincoln",
      "mobile": "test-mobile",
      "id": "1840929278646902",
      "photo_url": "test-photo_url",
      "is_vip_user": false,
      "department": null
    }
  }
}

获取项目成员

此操作帮助您获取项目成员。

地址

<service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members/{project_member_id}

属性

id （长整型）
项目成员的唯一标识

id （长整型）
被视为具有较大值的数字

示例 

234759602834500

project （项目）read only
项目成员所关联的项目

project （项目）
表示与项目成员关联的项目

示例 

{
  "project": {
    "display_id": {
      "display_value": "PJT-131",
      "value": "131"
    },
    "project_code": "test-project_code",
    "id": "2037672456177497",
    "title": "test-title"
  }
}

user （用户）
将被称为项目成员的用户

user （用户）
将被称为项目成员的用户

示例 

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

is_active （布尔型）
表示该成员是否在该项目中处于激活状态

is_active （布尔型）
布尔值，可取两个值。取值为 true 或 false。

role （project_role）
项目成员在该项目中的角色

role （project_role）
表示项目成员的角色

示例 

{
  "role": {
    "name": "test-role",
    "id": "234567890123456"
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members/{project_member_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/projects/{project_id}/project_members/{project_member_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/projects/{project_id}/project_members/{project_member_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/projects/{project_id}/project_members/{project_member_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_member": {
    "role": {
      "name": "test-name",
      "id": "2247344807415048"
    },
    "is_active": true,
    "project": {
      "project_code": "test-project_code",
      "id": "2015824399822285",
      "display_id": {
          "display_value": "PJT-131",
          "value": "131"
        },
      "title": "test-title"
    },
    "id": "1846636898485574",
    "user": {
      "email_id": "lincoln@zmail.com",
      "is_technician": false,
      "sms_mail": "linc123@xys_sms.co",
      "phone": "022-1234567890",
      "name": "Lincoln",
      "mobile": "1234567890",
      "id": "2254267900366325",
      "photo_url": "https://contacts.zoho.com/file?exp\u003d10\u0026ID\u003d123\u0026t\u003duser\u0026height\u003d60\u0026width\u003d60",
      "is_vip_user": false,
      "department": null
    }
  }
}

获取项目成员列表

此操作帮助您获取所有项目成员。

地址

<service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members

属性

id （长整型）
项目成员的唯一标识

id （长整型）
被视为具有较大值的数字

示例 

234759602834500

project （项目）read only
项目成员所关联的项目

project （项目）
表示与项目成员关联的项目

示例 

{
  "project": {
    "display_id": {
      "display_value": "PJT-131",
      "value": "131"
    },
    "project_code": "test-project_code",
    "id": "2037672456177497",
    "title": "test-title"
  }
}

user （用户）
将被称为项目成员的用户

user （用户）
将被称为项目成员的用户

示例 

{
  "user": {
    "name": "test-user",
    "id": "234567890123456"
  }
}

is_active （布尔型）
表示该成员是否在该项目中处于激活状态

is_active （布尔型）
布尔值，可取两个值。取值为 true 或 false。

role （project_role）
项目成员在该项目中的角色

role （project_role）
表示项目成员的角色

示例 

{
  "role": {
    "name": "test-role",
    "id": "234567890123456"
  }
}


$ curl -G <service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members\
      -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/projects/{project_id}/project_members";
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/projects/{project_id}/project_members"
$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/projects/{project_id}/project_members"
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())

{
  "project_members": [
    {
      "role": {
        "name": "test-name",
        "id": "1938468691038229"
      },
      "is_active": true,
      "project": {
        "project_code": "test-project_code",
        "id": "2403852132888536",
        "display_id": {
          "display_value": "PJT-131",
          "value": "131"
        },
        "title": "test-title"
      },
      "id": "1737053296810100",
      "user": {
        "email_id": "lincoln@zmail.com",
        "is_technician": false,
        "sms_mail": "linc123@xys_sms.co",
        "phone": "022-1234567890",
        "name": "Lincoln",
        "mobile": "1234567890",
        "id": "2030622424592627",
        "photo_url": "https://contacts.zoho.com/file?exp\u003d10\u0026ID\u003d123\u0026t\u003duser\u0026height\u003d60\u0026width\u003d60",
        "is_vip_user": false,
        "department": null
      }
    }
  ],
  "response_status": [
    {
      "status_code": 2000,
      "status": "success"
    }
  ],
  "list_info": {
    "has_more_rows": false,
    "row_count": 1
  }
}

删除项目成员

此操作可帮助您删除项目成员。

地址

<service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members/{project_member_id}


$ curl <service domain|custom domain>/app/<portal>/api/v3/projects/{project_id}/project_members/{project_member_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/projects/{project_id}/project_members/{project_member_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/projects/{project_id}/project_members/{project_member_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/projects/{project_id}/project_members/{project_member_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"
  }
}