Using Smartsheet API, how do I fetch the metadata such as _OUTLINELEVEL_ or _ROWNUM_?
I am able to get the Row and Column data from the Smartsheet API JSON response but in it there are no metadata such as _OUTLINELEVEL_ or _ROWNUM_.
When requesting the data from Smartsheet API, I also sent additional params such as:
params = {'include': 'objectValue,objectProperties,format,formula,columnType,options'}
and sent it with the request. But I still do not get any metadata. Specifically, I am trying to get the _OUTLINELEVEL_ column that is present in the Smartsheet.
If I view the Smartsheet online then I can see those columns.
Could someone please help me get this data? Thank you!
The API does support getting the row number for rows within a sheet. For example, the following snippet uses the Smartsheet Python SDK to get a sheet, then iterates through the rows in the response to print out the value of the row_number property for each row.
# Specify access token
os.environ['SMARTSHEET_ACCESS_TOKEN'] = 'ADD_YOUR_TOKEN_VALUE_HERE'
# Initialize client. f
# Uses the API token in the environment variable SMARTSHEET_ACCESS_TOKEN.
smartsheet_client = smartsheet.Smartsheet()
sheetId = 3932034054809476
# get the sheet
sheet = smartsheet_client.Sheets.get_sheet(sheetId)
# iterate through the rows array and print row number of each row
for row in sheet.rows:
print('rowNumber= ' + str(row.row_number))
As far as I know, it's not possible to get the outline level of a row via the Smartsheet API -- unless a user has manually added such a column to the sheet and populated it using a formula -- for example, as described in this Smartsheet Community post: https://community.smartsheet.com/discussion/77827/work-breakdown-structure-wbs-column-formula-configuration#latest.
If this is the case -- i.e., a column has been (manually) created in the sheet and populated with an outline level value -- then you'd obtain that cell value for a row in the same way as you'd obtain the cell value of any other cell within the sheet -- i.e., by using the Get Sheet operation or the Get Row operation and then evaluating the value of that cell within the row object(s) of the API response. For example, the following code snippet uses the Smartsheet Python SDK to get a sheet and then iterates through the rows of the sheet, and for each row prints the value of the cell I'm interested in (i.e., in this example, the value in the column that has column id = 5228827298293636).
# Specify access token
os.environ['SMARTSHEET_ACCESS_TOKEN'] = 'ADD_YOUR_TOKEN_VALUE_HERE'
# Initialize client. f
# Uses the API token in the environment variable SMARTSHEET_ACCESS_TOKEN.
smartsheet_client = smartsheet.Smartsheet()
sheetId = 3932034054809476
# get the sheet
sheet = smartsheet_client.Sheets.get_sheet(sheetId)
# iterate through the rows
for row in sheet.rows:
# iterate through the cells for the row and print value of specific cell
for cell in row.cells:
if cell.column_id == 5228827298293636:
print('value of cell= ' + cell.value)
UPDATE: how to determine row hierarchy via API
You can use information within the rows collection of a Get Sheet response to programmatically identify the row hierarchy (i.e., parent-child-sibling relationships) within a sheet.
For example, consider the following sheet:
Please note -- I've manually added (and populated) the last three columns in this sheet to show the data (ID values) that'll be returned for row.id, row.parent_id, and row.sibling_id in the API response. Further, I've color coded the various ID values to make it easy to see which IDs show up where. As this example shows, the parent_id attribute and the sibling_id attribute for each row in the response indicate where the row appears in the sheet relative to other rows in the sheet. Here's the logic for how these attributes get populated:
parent_id:
- If the
parent_idattribute is present for a row, its value is the ID of the parent row. - If the
parent_idattribute is not present for a row, this indicates it's a top-level (i.e., non-indented) row in the sheet.
sibling_id:
- If the
sibling_idattribute is present for a row, its value is the ID of the row that immediately precedes it at the same level of hierarchy (in that location) within the sheet. - If the
sibling_idattribute is not present for a row, this indicates that the row is the first row present in that hierarchy (at that location) of the sheet -- i.e., it's either the first top-level (non-indented) row in the sheet or the first child row in that location within the sheet.
Here's the Get Sheet API response for the sheet that's shown in the screenshot above.
{
"id": 3932034054809476,
...
"columns": [
...
],
"rows": [
{
"id": 6933706290423684,
"rowNumber": 1,
"expanded": true,
"createdAt": "2022-08-23T20:13:19Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": 1.0,
"displayValue": "1"
},
{
"columnId": 5228827298293636,
"value": "white",
"displayValue": "white"
},
{
"columnId": 5678576703590276,
"value": 6.933706290423684E15,
"displayValue": "6933706290423684"
},
{
"columnId": 2055191968829316
},
{
"columnId": 6558791596199812
}
]
},
{
"id": 5556441535434628,
"rowNumber": 2,
"parentId": 6933706290423684,
"expanded": true,
"createdAt": "2023-04-26T19:49:40Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": "1a",
"displayValue": "1a"
},
{
"columnId": 5228827298293636,
"value": "child1a",
"displayValue": "child1a"
},
{
"columnId": 5678576703590276,
"value": 5.556441535434628E15,
"displayValue": "5556441535434628"
},
{
"columnId": 2055191968829316,
"value": 6.933706290423684E15,
"displayValue": "6933706290423684"
},
{
"columnId": 6558791596199812
}
]
},
{
"id": 3304641721749380,
"rowNumber": 3,
"parentId": 6933706290423684,
"siblingId": 5556441535434628,
"expanded": true,
"createdAt": "2023-04-26T19:49:40Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": "1b",
"displayValue": "1b"
},
{
"columnId": 5228827298293636,
"value": "child1b",
"displayValue": "child1b"
},
{
"columnId": 5678576703590276,
"value": 3.30464172174938E15,
"displayValue": "3304641721749380"
},
{
"columnId": 2055191968829316,
"value": 6.933706290423684E15,
"displayValue": "6933706290423684"
},
{
"columnId": 6558791596199812,
"value": 5.556441535434628E15,
"displayValue": "5556441535434628"
}
]
},
{
"id": 4992620981079940,
"rowNumber": 4,
"parentId": 6933706290423684,
"siblingId": 3304641721749380,
"expanded": true,
"createdAt": "2023-04-28T21:15:57Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": "1c",
"displayValue": "1c"
},
{
"columnId": 5228827298293636
},
{
"columnId": 5678576703590276,
"value": 4.99262098107994E15,
"displayValue": "4992620981079940"
},
{
"columnId": 2055191968829316,
"value": 6.933706290423684E15,
"displayValue": "6933706290423684"
},
{
"columnId": 6558791596199812,
"value": 3.30464172174938E15,
"displayValue": "3304641721749380"
}
]
},
{
"id": 3480469833469828,
"rowNumber": 5,
"parentId": 4992620981079940,
"expanded": true,
"createdAt": "2023-04-28T21:12:11Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": "1c-1",
"displayValue": "1c-1"
},
{
"columnId": 5228827298293636,
"value": "child 1c-1",
"displayValue": "child 1c-1"
},
{
"columnId": 5678576703590276,
"value": 3.480469833469828E15,
"displayValue": "3480469833469828"
},
{
"columnId": 2055191968829316,
"value": 4.99262098107994E15,
"displayValue": "4992620981079940"
},
{
"columnId": 6558791596199812
}
]
},
{
"id": 770536852088708,
"rowNumber": 6,
"siblingId": 6933706290423684,
"expanded": true,
"createdAt": "2022-07-11T13:32:02Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": 2.0,
"displayValue": "2"
},
{
"columnId": 5228827298293636,
"value": "green",
"displayValue": "green"
},
{
"columnId": 5678576703590276,
"value": 7.70536852088708E14,
"displayValue": "770536852088708"
},
{
"columnId": 2055191968829316
},
{
"columnId": 6558791596199812,
"value": 6.933706290423684E15,
"displayValue": "6933706290423684"
}
]
},
{
"id": 7046650170566532,
"rowNumber": 7,
"siblingId": 770536852088708,
"expanded": true,
"createdAt": "2022-10-02T13:49:03Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": 3.0,
"displayValue": "3"
},
{
"columnId": 5228827298293636,
"value": "white",
"displayValue": "white"
},
{
"columnId": 5678576703590276,
"value": 7.046650170566532E15,
"displayValue": "7046650170566532"
},
{
"columnId": 2055191968829316
},
{
"columnId": 6558791596199812,
"value": 7.70536852088708E14,
"displayValue": "770536852088708"
}
]
},
{
"id": 6903384426145668,
"rowNumber": 8,
"siblingId": 7046650170566532,
"expanded": true,
"createdAt": "2023-02-23T17:30:36Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": 4.0,
"displayValue": "4"
},
{
"columnId": 5228827298293636,
"value": "red",
"displayValue": "red"
},
{
"columnId": 5678576703590276,
"value": 6.903384426145668E15,
"displayValue": "6903384426145668"
},
{
"columnId": 2055191968829316
},
{
"columnId": 6558791596199812,
"value": 7.046650170566532E15,
"displayValue": "7046650170566532"
}
]
},
{
"id": 7984069460840324,
"rowNumber": 9,
"parentId": 6903384426145668,
"expanded": true,
"createdAt": "2023-04-28T21:12:11Z",
"modifiedAt": "2023-04-28T21:25:45Z",
"cells": [
{
"columnId": 6101753539127172,
"value": "4a",
"displayValue": "4a"
},
{
"columnId": 5228827298293636,
"value": "child 4a",
"displayValue": "child 4a"
},
{
"columnId": 5678576703590276
},
{
"columnId": 2055191968829316,
"value": 6.903384426145668E15,
"displayValue": "6903384426145668"
},
{
"columnId": 6558791596199812
}
]
}
]
}
- AttributeError: install_layout when attempting to install a package in a virtual environment
- Python list comprehension - want to avoid repeated evaluation
- Hash algorithm for dynamic growing/streaming data?
- matplotlib - making labels for violin plots
- Python How to I check if last element has been reached in iterator tool chain?
- Polars and the Lazy API: How to drop columns that contain only null values?
- Why are my Mean, Var, and Std outputs from NumPy different from what the online grader expects?
- Correlation dataframe convertion from results from pl.corr
- Polars DataFrame transformation
- Discord rate limiting while only sending 1 request per minute
- Check if column contains (/,-,_, *or~) and split in another column - Pandas
- How to draw a rectangle at (x,y) in a PyQt GraphicsView?
- how to calculate correlation between ten columns with polars
- How to set class attribute with await in __init__
- Detect hindi encoding, response received from Facebook API in Python
- Is it possible to write a horizontal if statement with a multi-line body?
- Max length of items in list
- Cannot subclass multiprocessing Queue in Python 3.5
- How can I get notified of updates to Python packages in a unified way?
- Using python AST to traverse code and extract return statements
- merge groups of columns in a polars dataframe to single columns
- Group Pandas DataFrame by Continuous Date Ranges
- Flask login @login_required not working
- Odoo: one2many and many2one? KeyError:'___'
- merge some columns in a Polars dataframe and duplicate the others
- Python: Create table from string mixed with separators using FOR loops
- How do I type hint a method with the type of the enclosing class?
- How can I verify an emails DKIM signature in Python?
- Writing a class that accepts a callback in Python?
- Python Paramiko channel.exec_command not returning output intermittently