DocsReferenceViewAPI

Reference

ViewAPI

View-scoped calls: rows, columns, formulas, lookups, publishing, private links, tags, alerts and per-view metadata. 51 methods.

ruby
org       = ac.get_org_instance(ORG_ID)
workspace = ac.get_workspace_instance(ORG_ID, WORKSPACE_ID)
view      = ac.get_view_instance(ORG_ID, WORKSPACE_ID, VIEW_ID)
bulk      = ac.get_bulk_instance(ORG_ID, WORKSPACE_ID)

ViewAPI exposes 51 methods. Method names are snake_case and identifiers are string.

Methods#

add_aggregate_formula, add_column, add_favorite, add_formula_column, add_lookup, add_row, add_tags_to_view, auto_analyse, auto_analyse_column, copy_formulas, create_alert, create_private_url, create_similar_views, delete, delete_aggregate_formula, delete_column, delete_formula_column, delete_row, edit_aggregate_formula, edit_formula_column, get_aggregate_formulas, get_alerts_in_view, get_column_dependents, get_embed_url, get_formula_columns, get_last_import_details, get_my_permissions, get_private_url, get_publish_configurations, get_table_metadata, get_view_dependents, get_view_metadata_for_alert, get_view_tags, get_view_url, hide_columns, make_view_public, refetch_data, remove_favorite, remove_lookup, remove_private_access, remove_public_access, remove_tags_from_view, rename, rename_column, reorder_columns, save_as, show_columns, sort_data_by_columns, update_publish_configurations, update_row, update_shared_details

add_aggregate_formula#

ruby
add_aggregate_formula(formula_name, expression, config = {})

Adds an aggregate formula to the table.

ParameterTypeDescription
formula_nameStringFormula name.
expressionStringFormula expression.
configHashAdditional control parameters.

Returns (String) — Formula ID.

add_column#

ruby
add_column(column_name, data_type, config = {})

Add a column to the view.

ParameterTypeDescription
column_nameString—
data_typeString—
configHash—

Returns (Integer) — Integer

add_favorite#

ruby
add_favorite()

Adds a specified view as favorite.

add_formula_column#

ruby
add_formula_column(formula_name, expression, config = {})

Adds a formula column to the table.

ParameterTypeDescription
formula_nameStringName of the formula column.
expressionStringFormula expression.
configHashAdditional control parameters.

Returns (String) — Formula ID.

add_lookup#

ruby
add_lookup(column_id, ref_view_id, ref_column_id, config = {})

Adds a lookup in the specified child table.

ParameterTypeDescription
column_idStringChild column ID.
ref_view_idStringParent table ID.
ref_column_idStringParent column ID.
configHashAdditional control parameters.

add_row#

ruby
add_row(column_values, config = {})

Adds a single row in the specified table.

ParameterTypeDescription
column_valuesHashColumn name to value mapping.
configHashAdditional control parameters.

Returns (Hash) — Response containing column names and added row values.

add_tags_to_view#

ruby
add_tags_to_view(tag_ids, config = {})

Adds multiple tags to the specified view.

ParameterTypeDescription
tag_idsArrayTag ids to be associated with the view
configHashAdditional control parameters

auto_analyse#

ruby
auto_analyse(config = {})

Auto generate reports.

ParameterTypeDescription
configHash—

auto_analyse_column#

ruby
auto_analyse_column(column_id, config = {})

Auto generates reports for the specified column.

ParameterTypeDescription
column_idStringColumn ID.
configHashAdditional control parameters.

copy_formulas#

ruby
copy_formulas(formula_names, dest_workspace_id, config = {}, dest_org_id = nil)

Copy formulas to another workspace or view.

ParameterTypeDescription
formula_namesArrayNames of formulas
dest_workspace_idStringDestination workspace ID
configHashAdditional control parameters
dest_org_idString, nilOptional destination org ID

create_alert#

ruby
create_alert(alert_name, schedule_details, rules, config = {})

Create a data alert for the specified view.

ParameterTypeDescription
alert_nameStringName of the data alert
schedule_detailsHashContains the schedule configurations of the data alert
rulesArrayContains the rules to be evaluated by the data alert
configHashAdditional control parameters

Returns (String) — Created data alert id

create_private_url#

ruby
create_private_url(config = {})

Create private URL for the view.

ParameterTypeDescription
configHash—

Returns (String) — String

create_similar_views#

ruby
create_similar_views(ref_view_id, folder_id, config = {})

Create similar reports based on a reference view.

ParameterTypeDescription
ref_view_idString—
folder_idString—
configHash—

delete#

ruby
delete(config = {})

Delete a specified view in the workspace.

ParameterTypeDescription
configHashAdditional control parameters

delete_aggregate_formula#

ruby
delete_aggregate_formula(formula_id, config = {})

Deletes an aggregate formula.

ParameterTypeDescription
formula_idStringFormula ID.
configHashAdditional control parameters.

delete_column#

ruby
delete_column(column_id, config = {})

Deletes a specified column in the table.

ParameterTypeDescription
column_idStringID of the column.
configHashAdditional control parameters.

delete_formula_column#

ruby
delete_formula_column(formula_id, config = {})

Deletes a formula column.

ParameterTypeDescription
formula_idStringFormula column ID.
configHashAdditional control parameters.

delete_row#

ruby
delete_row(criteria, config = {})

Deletes rows in the specified table.

ParameterTypeDescription
criteriaString, nilCriteria to filter rows for deletion.
configHashAdditional control parameters.

Returns (String) — Deleted row details.

edit_aggregate_formula#

ruby
edit_aggregate_formula(formula_id, expression, config = {})

Edits an aggregate formula.

ParameterTypeDescription
formula_idStringFormula ID.
expressionStringNew formula expression.
configHashAdditional control parameters.

edit_formula_column#

ruby
edit_formula_column(formula_id, expression, config = {})

Edits a formula column.

ParameterTypeDescription
formula_idStringFormula column ID.
expressionStringNew formula expression.
configHashAdditional control parameters.

get_aggregate_formulas#

ruby
get_aggregate_formulas()

Returns list of all aggregate formulas for the table.

Returns (Array) — Aggregate formulas.

get_alerts_in_view#

ruby
get_alerts_in_view()

Returns list of data alerts configured for the specified view.

Returns (Array) — Data alerts list

get_column_dependents#

ruby
get_column_dependents(column_id)

Returns list of dependent views and formulas for the specified column.

ParameterTypeDescription
column_idStringThe ID of the column

Returns (Hash) — Dependent details

get_embed_url#

ruby
get_embed_url(config = {})

Get embed URL of the view.

ParameterTypeDescription
configHash—

Returns (String) — String

get_formula_columns#

ruby
get_formula_columns()

Returns list of all formula columns for the table.

Returns (Array) — Formula columns.

get_last_import_details#

ruby
get_last_import_details()

Returns last import details of the view.

Returns (Hash) — Last import details.

get_my_permissions#

ruby
get_my_permissions()

Get user permissions for the view.

Returns (Hash) — Hash

get_private_url#

ruby
get_private_url(config = {})

Get private URL of the view.

ParameterTypeDescription
configHash—

Returns (String) — String

get_publish_configurations#

ruby
get_publish_configurations()

Get publish configurations of the view.

Returns (Hash) — Hash

get_table_metadata#

ruby
get_table_metadata()

Returns metadata details like columns present for the specified table.

Returns (Hash) — Table metadata details

get_view_dependents#

ruby
get_view_dependents()

Returns the dependent views of this view.

Returns (Array) — List of dependent views.

get_view_metadata_for_alert#

ruby
get_view_metadata_for_alert()

Returns the view metadata that can be used while configuring a data alert for the specified view.

Returns (Hash) — View metadata for data alert configuration

get_view_tags#

ruby
get_view_tags()

Returns the list of tags associated with the specified view.

Returns (Array) — Tags list

get_view_url#

ruby
get_view_url(config = {})

Get the URL to access the view.

ParameterTypeDescription
configHash—

Returns (String) — String

hide_columns#

ruby
hide_columns(column_ids)

Hide columns in the view.

ParameterTypeDescription
column_idsArray—

make_view_public#

ruby
make_view_public(config = {})

Make the view publicly accessible.

ParameterTypeDescription
configHash—

Returns (String) — String

refetch_data#

ruby
refetch_data(config = {})

Syncs data from the available data source for the view.

ParameterTypeDescription
configHashAdditional control parameters.

remove_favorite#

ruby
remove_favorite()

Removes a specified view from favorites.

remove_lookup#

ruby
remove_lookup(column_id, config = {})

Removes the lookup for the specified column in the table.

ParameterTypeDescription
column_idStringColumn ID.
configHashAdditional control parameters.

remove_private_access#

ruby
remove_private_access()

Remove private access for the view.

remove_public_access#

ruby
remove_public_access()

Remove public access for the view.

remove_tags_from_view#

ruby
remove_tags_from_view(tag_ids = nil, dissociate_all = false, config = {})

Removes multiple tags from the specified view.

ParameterTypeDescription
tag_idsArray , nilTag ids to be dissociated. Not required when dissociate_all is true.
dissociate_allBooleanTo dissociate all tags from the view
configHashAdditional control parameters

rename#

ruby
rename(view_name, config = {})

Rename a specified view in the workspace.

ParameterTypeDescription
view_nameStringNew name of the view
configHashAdditional control parameters

rename_column#

ruby
rename_column(column_id, column_name, config = {})

Renames a specified column in the table.

ParameterTypeDescription
column_idStringID of the column.
column_nameStringNew column name.
configHashAdditional control parameters.

reorder_columns#

ruby
reorder_columns(column_ids, config = {})

Updates the column order of the current table.

ParameterTypeDescription
column_idsArrayList of column IDs in the new order
configHashAdditional control parameters

save_as#

ruby
save_as(new_view_name, config = {})

Copy a specified view within the workspace.

ParameterTypeDescription
new_view_nameStringName of the new view
configHashAdditional control parameters

Returns (Integer) — Created view ID

show_columns#

ruby
show_columns(column_ids)

Show hidden columns in the view.

ParameterTypeDescription
column_idsArray—

sort_data_by_columns#

ruby
sort_data_by_columns(columns = nil, sort_order = nil, reset_sort = false, config = {})

Sorts the data in the current table based on the specified columns.

ParameterTypeDescription
columnsArray , nilColumn IDs to sort by
sort_orderInteger, nilSort order (1 = Ascending, 2 = Descending)
reset_sortBooleanWhether to reset existing sort configuration
configHashAdditional control parameters

update_publish_configurations#

ruby
update_publish_configurations(config = {})

Update publish configurations of the view.

ParameterTypeDescription
configHash—

update_row#

ruby
update_row(column_values, criteria, config = {})

Updates rows in the specified table.

ParameterTypeDescription
column_valuesHashColumn name to updated value mapping.
criteriaString, nilCriteria to filter rows for update.
configHashAdditional control parameters.

Returns (Hash) — Updated columns list and row count.

update_shared_details#

ruby
update_shared_details(config = {})

Updates the shared details of the specified view.

ParameterTypeDescription
configHashContains the control parameters
  • Errors — the failure envelope and codes worth branching on.
  • Limits — throttles and quotas that apply to these calls.
Zoho Analytics Ruby SDK · REST API v2 Generated 2026-10-27