Memperbarui rentang sel

Panggil API ini untuk memperbarui informasi sel, termasuk nilai sel, warna latar, hyperlink, ukuran font, perataan horizontal, perataan vertikal, dan lainnya.

Permintaan

Informasi dasar

Bidang	Nilai
URL HTTP	`https://api.dingtalk.io/v1.0/doc/workbooks/{workbookId}/sheets/{sheetId}/ranges/{rangeAddress}`
Metode HTTP	PUT
Tipe aplikasi yang didukung	appType-Internal app　appType-Third-party enterprise app
Izin yang diperlukan	permission-Document.Workbook.Write-DingTalk Spreadsheet write permission

Header permintaan

Nama	Tipe	Wajib	Deskripsi
x-acs-dingtalk-access-token	String	Ya	Kredensial akses untuk memanggil API ini. Peroleh sebagai berikut: - Untuk aplikasi internal, panggil API Memperoleh access token aplikasi internal. - Untuk aplikasi perusahaan pihak ketiga, panggil API Memperoleh access token organisasi terotorisasi untuk aplikasi pihak ketiga.

Parameter path

Nama	Tipe	Wajib	Deskripsi
workbookId	String	Ya	ID file spreadsheet. `nodeId(dentryUuid)` yang dikembalikan oleh Knowledge Base API adalah `workbookId` spreadsheet. Peroleh dengan memanggil API Get a node atau API Membuat dokumen Knowledge Base.
sheetId	String	Ya	ID atau nama lembar kerja. - Untuk aplikasi internal, panggil API Memperoleh semua lembar kerja untuk memperoleh nilai `id` atau `name`. - Untuk aplikasi perusahaan pihak ketiga, panggil API Membuat lembar kerja untuk memperoleh `id` dan `name`.
rangeAddress	String	Ya	Alamat rentang.

Parameter query

Nama	Tipe	Wajib	Deskripsi
operatorId	String	Ya	unionId operator. Panggil API Kueri detail pengguna untuk memperolehnya. Jika operator tidak memiliki izin, API mengembalikan error `The operator has no permission`.

Isi permintaan

Nama	Tipe	Wajib	Deskripsi
horizontalAlignments	Array of Array	Tidak	Perataan horizontal. Nilai yang valid: `left` (rata kiri), `center` (rata tengah), `right` (rata kanan), `general` (perataan default). Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang. Lihat contoh berikut: Array dua dimensi berisi satu elemen per baris dalam rentang, dan setiap elemen berisi satu nilai per kolom dalam rentang. Contoh 1: Ketika alamat rentang adalah A1:B3 (tabel tiga baris, dua kolom), format nilainya adalah: `{ "horizontalAlignments": [ ["left", "general"], ["center", "general"], ["right", "general"] ] }` Contoh 2: Ketika alamat rentang adalah A1:C3 (tabel tiga baris, tiga kolom), format nilainya adalah: `{ "horizontalAlignments": [ ["left", "left", "general"], ["center", "center", "general"], ["right", "right", "general"] ] }`
numberFormat	String	Tidak	Format angka.	---	---	---	Nama	Format angka	Contoh	Umum	”General”	Teks	”@“	Angka	”#,##0”	1,234	Angka (dengan desimal)	”#,##0.00”	1,234.56	Persentase	”0%“	12%	Persentase (dengan desimal)	“0.00%“	12.34%	Notasi ilmiah	”0.00E+00”	1.01E+03	RMB	”¥#,##0”	¥1,234	RMB (dengan desimal)	¥#,##0.00”	¥1,234.56	USD	”$#,##0”	$1,234	USD (dengan desimal)	”$#,##0.00”	$1,234.56	Tanggal	”yyyy/m/d”	2022/1/1	Tanggal (Tionghoa)	“yyyy年m月d日”	2022年1月1日	Tanggal (Tionghoa, tahun dan bulan)	“yyyy年m月”	2022年1月	Waktu	”hh:mm:ss”	00:00:00	Tanggal dan waktu	”yyyy/m/d hh:mm:ss”	2022/1/1 00:00:00
wordWrap	String	Tidak	Mode bungkus teks. Nilai yang valid: - overflow: overflow - clip: pangkas - autoWrap: bungkus teks
values	Array of Array	Tidak	Nilai sel. Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang. Lihat contoh berikut: Array dua dimensi berisi satu elemen per baris dalam rentang, dan setiap elemen berisi satu nilai per kolom dalam rentang. Contoh 1: Ketika alamat rentang adalah A1:B3 (tabel tiga baris, dua kolom), format nilainya adalah: `{ "values": [ ["1", "2"], ["3", "4"], ["5", "6"] ] }` Contoh 2: Ketika alamat rentang adalah A1:C3 (tabel tiga baris, tiga kolom), format nilainya adalah: `{ "values": [ ["1","2","3"], ["4","5","6"], ["7","8","9"] ] }`
complexValues	Array of Array	Tidak	Nilai sel. Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang. Gunakan bidang ini untuk mengisi sel yang sesuai dengan konten teks kaya. Lihat lampiran berikut untuk detailnya.
backgroundColors	Array of Array	Tidak	Warna latar, ditentukan sebagai nilai heksadesimal. Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang. Lihat contoh berikut: Array dua dimensi berisi satu elemen per baris dalam rentang, dan setiap elemen berisi satu nilai per kolom dalam rentang. Contoh 1: Ketika alamat rentang adalah A1:B3 (tabel tiga baris, dua kolom), format nilainya adalah: `{ "backgroundColors": [ ["#ff0000", "#00ff00"], ["#f0f0f0", "#0000ff"], ["#f0f0f0", "#0000ff"] ] }` Contoh 2: Ketika alamat rentang adalah A1:C3 (tabel tiga baris, tiga kolom), format nilainya adalah: `{ "backgroundColors": [ ["#ff0000","#ff0000","#ff0000"], ["#ff0000","#ff0000","#ff0000"], ["#ff0000","#ff0000","#ff0000"] ] }`
fontColors	Array of Array	Tidak	Warna font, ditentukan sebagai nilai heksadesimal. Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang.
fontSizes	Array of Array	Tidak	Ukuran font. Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang. Lihat contoh berikut: Array dua dimensi berisi satu elemen per baris dalam rentang, dan setiap elemen berisi satu nilai per kolom dalam rentang. Contoh 1: Ketika alamat rentang adalah A1:B3 (tabel tiga baris, dua kolom), format nilainya adalah: `{ "fontSizes": [ [14, 14], [15, 15], [10, 10] ] }` Contoh 2: Ketika alamat rentang adalah A1:C3 (tabel tiga baris, tiga kolom), format nilainya adalah: `{ "fontSizes": [ [14, 14, 14], [15, 15, 15], [10, 10, 10] ] }`
fontWeights	Array of Array	Tidak	Ketebalan font. Nilai yang valid: - bold: tebal - normal: normal
hyperlinks	Array of Array	Tidak	Hyperlink. Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang. Lihat contoh berikut: Array dua dimensi berisi satu elemen per baris dalam rentang, dan setiap elemen berisi satu nilai per kolom dalam rentang. Contoh 1: Ketika alamat rentang adalah A1:B3 (tabel tiga baris, dua kolom), format nilainya adalah: { "hyperlinks": [ [ { "type": "path", "link": "https://www.dingtalk.io", "text": "test" }, { "type": "sheet", "link": "Sheet2", "text": "test" } ], [ { "type": "range", "link": "Sheet2!A4", "text": "test" }, { "type": "path", "link": "https://www.dingtalk.io", "text": "test" } ], [ { "type": "range", "link": "Sheet2!A4", "text": "2" }, { "type": "sheet", "link": "Sheet2", "text": "test" } ] ] } Contoh 2: Ketika alamat rentang adalah A1:C3 (tabel tiga baris, tiga kolom), format nilainya adalah: { "hyperlinks": [ [ { "type": "path", "link": "https://www.dingtalk.io", "text": "test" }, { "type": "sheet", "link": "Sheet2", "text": "test" },{ "type": "path", "link": "https://www.dingtalk.io", "text": "test" } ], [ { "type": "range", "link": "Sheet2!A4", "text": "test" }, { "type": "path", "link": "https://www.dingtalk.io", "text": "test" },{ "type": "path", "link": "https://www.dingtalk.io", "text": "test" } ], [ { "type": "range", "link": "Sheet2!A4", "text": "2" }, { "type": "sheet", "link": "Sheet2", "text": "test" },{ "type": "path", "link": "https://www.dingtalk.io", "text": "test" } ] ] }
verticalAlignments	Array of Array	Tidak	Perataan vertikal. Nilai yang valid: `top` (rata atas), `middle` (rata tengah vertikal), `bottom` (rata bawah). Kirim nilai sebagai array dua dimensi berdasarkan alamat rentang. Lihat contoh berikut: Array dua dimensi berisi satu elemen per baris dalam rentang, dan setiap elemen berisi satu nilai per kolom dalam rentang. Contoh 1: Ketika alamat rentang adalah A1:B3 (tabel tiga baris, dua kolom), format nilainya adalah: `{ "verticalAlignments": [ ["top", "top"], ["middle", "middle"], ["bottom", "bottom"] ] }` Contoh 2: Ketika alamat rentang adalah A1:C3 (tabel tiga baris, tiga kolom), format nilainya adalah: `{ "verticalAlignments": [ ["top", "top", "top"], ["middle", "middle", "middle"], ["bottom", "bottom", "bottom"] ] }`

Contoh permintaan

HTTP

PUT /v1.0/doc/workbooks/e54Lqxxxxx/sheets/Sheet1/ranges/A1:B1?operatorId=ppgAQuxxxxx HTTP/1.1
Host:api.dingtalk.io
x-acs-dingtalk-access-token:f86e0bxxx
Content-Type:application/json

{
  "horizontalAlignments" : [ [ "general" ] ],
  "numberFormat" : "@",
  "wordWrap" : "autoWrap",
  "values" : [ [ "text" ] ],
  "complexValues" : [ [ "text" ] ],
  "backgroundColors" : [ [ "#ff0000" ] ],
  "fontColors" : [ [ "#000000" ] ],
  "fontSizes" : [ [ 14 ] ],
  "fontWeights" : [ [ "bold" ] ],
  "hyperlinks" : [ [ {
    "type" : "path",
    "link" : "https://www.dingtalk.io",
    "text" : "DingTalk"
  } ] ],
  "verticalAlignments" : [ [ "middle" ] ]
}

Respons

Isi respons

Nama	Tipe	Deskripsi
a1Notation	String	Alamat rentang yang diperbarui.

Contoh isi respons

HTTP/1.1 200 OK
Content-Type:application/json

{
  "a1Notation" : "A1"
}

Kode error

Jika panggilan API gagal, cari pesan error di dokumen Kode error global untuk solusinya.

HttpCode	Kode error	Pesan error	Deskripsi
400	invalidRequest.inputArgs.invalid	%s	Parameter permintaan tidak valid. Periksa pesan error.
400	invalidRequest.inputArgs.workbookIdIllegal	The workbookId is illegal.	workbookId tidak valid.
400	invalidRequest.resource.notWorkbook	%s	Tipe dokumen tidak didukung. Periksa workbookId.
403	forbidden.accessDenied	The operator has no permission.	Pengguna saat ini tidak memiliki izin untuk melakukan tindakan ini.
403	forbidden.acrossOrg	%s	Permintaan tidak valid. Pastikan dokumen yang diakses milik organisasi yang ditentukan oleh access token.
403	forbidden.operationIllegal	%s	Tindakan yang diminta tidak valid. Periksa pesan error.
403	forbidden.document.sizeOverLimit	The document size is over limit and the server is unable to complete your request. Retry is unlikely to work unless the document size is decreased.	Konten spreadsheet terlalu besar. Coba kurangi kontennya.
404	invalidRequest.resource.notFound	%s	Permintaan gagal. Sumber daya yang diminta tidak dapat ditemukan.
500	serviceBusy	The server is busy and unable to complete your request. Please try again later.	Layanan sedang sibuk. Coba lagi nanti.
500	internalError	The server encountered an internal error and was unable to complete your request. Please try again later.	Server mengalami error internal. Coba lagi nanti.

Panduan pemanggilan API

Autentikasi & otorisasi

Kontak

Kalender

Konferensi

AI Table

Dokumen & file

IM

Permintaan

Informasi dasar

Header permintaan

Parameter path

Parameter query

Isi permintaan

Contoh permintaan

Respons

Isi respons

Contoh isi respons

Kode error

​Permintaan

​Informasi dasar

​Header permintaan

​Parameter path

​Parameter query

​Isi permintaan

​Contoh permintaan

​Respons

​Isi respons

​Contoh isi respons

​Kode error

Permintaan

Informasi dasar

Header permintaan

Parameter path

Parameter query

Isi permintaan

Contoh permintaan

Respons

Isi respons

Contoh isi respons

Kode error