介绍Smartsheet Ruby SDK

发表在2017年11月11日

对于ruby开发者来说,使用Smartsheet API变得简单多了!

我们很高兴地宣布加入内容Ruby SDK到我们稳定的本地语言sdk。现在,您可以安装smartsheet gem并通过Ruby方法与smartsheet API交互,而不是直接使用API。

为了帮助您开始使用SDK,我们在内容API文档它提供了向每个API端点发出请求的示例代码,以及来自这些请求的预期响应。

Smartsheet文档新增Ruby选项卡

从上面的例子可以看出,通过Ruby SDK获得工作表列表需要简单地调用smartsheet.sheets.list。然后,您可以根据需要解析响应。默认情况下,SDK返回API响应作为哈希.但是,您也可以通过在初始化客户机时设置json_output:true来返回原始JSON。

要开始使用SDK,您至少需要运行版本2.2Ruby.安装Smartsheet gem:

gem安装内容

然后,要使用gem,需要将它放在Ruby脚本的顶部:

需要的内容

接下来,初始化smartsheet_client对象,使用访问令牌将应用程序连接到Smartsheet数据。

通过转到Account菜单并选择Personal Settings…,然后选择API access,可以在Smartsheet UI中生成访问令牌。在那里您将找到Generate new访问令牌按钮。

创建令牌之后,在下面的语句中使用它来创建smartsheet_client。

内容\ _client =内容:客户端。新(令牌:“你\ _token \ _here”)

在这个语句中,您还可以告诉SDK您更喜欢JSON输出。要做到这一点,添加json \ _output:没错发送到用于创建客户机的参数。

在smartsheet_client初始化之后,现在可以调用Smartsheet API。如前所述,要获取一个表的列表,调用:

表=内容\ _client.sheets.list

然后,获取列表中的第一个表并打印它的名称,我们的代码看起来像这样:

sheet\_name = sheets\[:data\]\[0\]\[:name\]写入“表从列表#{sheet\_name}”

要了解更多关于Ruby SDK的信息,请访问项目在GitHub上,Ruby-Read-Write-Sheet样本,或选择Ruby选项卡内容API文档

评论

评论