文档
可以在此处找到更新行的 API 文档。它使用命令行中的 curl 给出了以下示例:
curl https://api.smartsheet.com/1.1/row/{rowId}/cells \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-X PUT \
-d '[ {"columnId": 3738748463671172, "value": "Revision 2"}, {"columnId": 5427598323935108, "value": "On Time", "strict": false} ]'
PHP 示例中要更改的内容
我们将需要更改您的 PHP 示例以按照上述文档发送数据。因此,需要更改 php 示例中的以下项目:
- url 需要采用 https://api.smartsheet.com/1.1/row/{rowId}/cells 的格式,其中 {rowId} 替换为实际的行 ID。
- 我们需要发送一组单元格。例如,以下是两个单元格的数组:
[{"columnId": 13214124123213, "value": "my new text1"}, {"columnId": 1231231241238, "value": "my new text2"}]
- 我们需要将数据作为 PUT 请求发送。
解决方案
考虑到这一点,我们可以将代码更改为以下内容:
<?php
$ch = curl_init("https://api.smartsheet.com/1.1/row/4407426335172484/cells");
$header = array("Authorization: Bearer 1238123lkjafasdilfasflkj",
"Content-Type: application/json",
"Assume-User: some%40email.com");
$name = 'MyName';
$fields = '[{"columnId": 4431344890603396, "value": "'.$name.'", "displayValue": "'.$name.'"}]';
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
curl_setopt($ch, CURLOPT_POSTFIELDS, $fields);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");
$result = curl_exec($ch);
print_r($result);
?>
额外的信息
您可能想知道 rowId 和 columnId 是从哪里来的。这两个 ID 需要通过获取工作表从 API 中检索。这可以使用 Curl、Chrome 的 Advanced Rest Client或通过 PHP 来完成。PHP 示例如下:
<?php
$ch = curl_init("https://api.smartsheet.com/1.1/sheet/1837937135511428");
$header = array("Authorization: Bearer 123l1k2j321lkjasdfa",
"Content-Type: application/json",
"Assume-User: some%40email.com");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $header);
$result = curl_exec($ch);
print_r($result);
?>
此请求将输出如下内容并列出列 id 和行 id。
{
"id":1837937135511428,
"name":"test",
"version":3,
"columns":[
{
"id":4431344890603396,
"index":0,
"title":"Primary Column",
"type":"TEXT_NUMBER",
"primary":true,
"width":150
},
{
"id":8934944517973892,
"index":1,
"title":"Column2",
"type":"TEXT_NUMBER",
"width":150
},
{
"id":138851495765892,
"index":2,
"title":"Column3",
"type":"TEXT_NUMBER",
"width":150
},
{
"id":4642451123136388,
"index":3,
"title":"Column4",
"type":"TEXT_NUMBER",
"width":150
},
{
"id":2390651309451140,
"index":4,
"title":"Column5",
"type":"TEXT_NUMBER",
"width":150
},
{
"id":6894250936821636,
"index":5,
"title":"Column6",
"type":"TEXT_NUMBER",
"width":150
}
],
"rows":[
{
"id":4407426335172484,
"rowNumber":1,
"cells":[
{
"columnId":4431344890603396,
"type":"TEXT_NUMBER",
"value":"My Name",
"displayValue":"My Name"
},
{
"columnId":8934944517973892,
"type":"TEXT_NUMBER",
"value":"test",
"displayValue":"test"
}
],
"expanded":true,
"createdAt":"2014-06-23T09:32:02-07:00",
"modifiedAt":"2014-06-23T09:48:55-07:00"
}
],
"accessLevel":"OWNER",
"ganttEnabled":false,
"dependenciesEnabled":false,
"permalink":"https://app.smartsheet.com/b/home?lx=v75AYzRUICSXF_2oV6V_LA",
"workspace":{
"id":6724185599829892,
"name":"Test"
},
"createdAt":"2014-06-23T09:28:58-07:00",
"modifiedAt":"2014-06-23T09:48:55-07:00"
}