Get Portals From Zoho Projects

Table of Contents

Note:

  • Each time the zoho.projects.getPortals integration task is executed, it triggers an API request in the back-end. This call is deducted from the external calls limit available for the service from which the task is executed, based on your pricing plan.
  • Only actual executions that receive a response (whether success or failure) are counted, not the number of times the task appears in the script. For example, if zoho.projects.getPortals integration task is placed inside a for each task that iterates five times, the number of external calls consumed will be five, even though the task appears only once in the script. 

Description

The zoho.projects.getPortals task fetches the details of all your portals in Zoho Projects.

Note: For security reasons, if you execute Zoho Projects integration tasks for more than 100 times under 2 minutes, you will be restricted to execute any Zoho Projects integration task for the next 30 mins.

Syntax

<response>=zoho.projects.getPortals([<connection>]);

where:

ParamsData typeDescription
<response> KEY-VALUEThe details of all your portals in Zoho projects.

<connection>

(optional)

TEXTThe link name of the connection.

Note:

In integration tasks, the parameters must be in the defined order as given in the syntax, for the Deluge task to be executed. If you choose to use an optional parameter, ensure that all preceding parameters in the syntax are explicitly specified. If a preceding optional parameter is not required, a null value can be assigned instead, to maintain the defined syntax order.

For example, in the below syntax, options_map and connection are optional parameters:

<variable> = zoho.crm.v8.task (<module_name>, <record_details>, <options_map>, <connection>);

If you want to use the connection parameter, module_name, record_details and options_map must be specified in the 
exact order as the syntax. You can assign an empty map to the options_map parameter if it is not required.

 

Example

The following script fetches the details of all the portals in Zoho Projects:

response = zoho.projects.getPortals();

where:

response
The KEY-VALUE response returned by Zoho Projects. It represents the details of all your portals in Zoho projects.

Response Format

Success Response

  • The success response will be returned in the following format:

      {
      "login_id": "58XXXX70",
      "portals": [
      {
      "trial_enabled": true,
      "gmt_time_zone": "(GMT 5:30) India Standard Time",
      "project_count": {
      "active": 1
      },
      "role": "admin",
      "avail_user_count": 24,
      "is_crm_partner": false,
      "link": {
      "project": {
      "url": "https://projects.zoho.com/restapi/portal/58572595/projects/"
      }
      },
      "bug_plan": "Enterprise",
      "locale": {
      "country": "United States",
      "code": "en_US",
      "language": "English"
      },
      "layouts": {
      "projects": {
      "module_id": "548XXXXXXXXXXX005"
      },
      "tasks": {
      "module_id": "548XXXXXXXXXXX001"
      }
      },
      "new_user_plan": true,
      "available_projects": -1,
      "default": true,
      "id": 58XXXX95,
      "bug_plural": "Issues",
      "is_new_plan": true,
      "plan": "Enterprise",
      "percentage_calculation": "based_on_status",
      "settings": {
      "business_hours": {
      "business_end": 1440,
      "business_start": 0
      },
      "default_dependency_type": "finish-start",
      "working_days": [
      "Sunday",
      "Monday",
      "Tuesday",
      "Wednesday",
      "Thursday",
      "Friday",
      "Saturday"
      ],
      "timelog_period": {
      "log_future_time": {
      "allowed": false
      },
      "log_past_time": {
      "allowed": true
      }
      },
      "time_zone": "Asia/Kolkata",
      "startday_of_week": "sunday",
      "task_date_format": "MM-dd-yyyy",
      "timesheet": {
      "is_timesheet_approval_enabled": false,
      "default_billing_status": "Billable"
      },
      "holidays": [
      ],
      "is_budget_enabled": false,
      "company_name": "Zylker",
      "date_format": "MM-dd-yyyy hh:mm aaa",
      "has_budget_permission": true
      },
      "is_display_taskprefix": true,
      "bug_singular": "Issue",
      "trial_end_time": 1566412200000,
      "is_display_projectprefix": true,
      "project_prefix": "TE-",
      "is_time_log_restrcition_enabled": false,
      "max_user_count": 25,
      "extensions": {
      "locations": {
      "app_settings": "548XXXXXXXXXXX161",
      "issue_tab": "548XXXXXXXXXXX165",
      "task_tab": "548XXXXXXXXXXX163",
      "attachment_picker": "548XXXXXXXXXXX171",
      "top_band": "548XXXXXXXXXXX169",
      "project_tab": "548XXXXXXXXXXX167"
      }
      },
      "trial_daystogo": 10,
      "profile_id": 548XXXXXXXXXXX320,
      "name": "zylker",
      "id_string": "58XXXX95"
      }
      ]
      }

Related Links