Обновление диапазона

Пространство имен: microsoft.graph

Обновление свойств объекта диапазона.

Разрешения

Для вызова этого API требуется одно из следующих разрешений. Дополнительные сведения, включая сведения о том, как выбрать разрешения, см. в статье Разрешения.

Тип разрешения	Разрешения (в порядке повышения привилегий)
Делегированные (рабочая или учебная учетная запись)	Files.ReadWrite
Делегированные (личная учетная запись Майкрософт)	Не поддерживается.
Для приложений	Не поддерживается.

HTTP-запрос

PATCH /me/drive/items/{id}/workbook/names/{name}/range
PATCH /me/drive/root:/{item-path}:/workbook/names/{name}/range
PATCH /me/drive/items/{id}/workbook/worksheets/{id|name}/range(address='<address>')
PATCH /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/range(address='<address>')
PATCH /me/drive/items/{id}/workbook/tables/{id|name}/columns/{id|name}/range
PATCH /me/drive/root:/{item-path}:/workbook/tables/{id|name}/columns/{id|name}/range

Необязательные заголовки запросов

Имя	Описание
Авторизация	Носитель {token}. Обязательно.
Workbook-Session-Id	Идентификатор сеанса работы с книгой, определяющий, сохраняются ли изменения. Необязательный параметр.

Текст запроса

В тексте запроса укажите значения для соответствующих полей, которые необходимо обновить. Предыдущие значения существующих свойств, не включенных в текст запроса, останутся прежними или будут повторно вычислены с учетом измененных значений других свойств. Для достижения оптимальной производительности не следует включать существующие значения, которые не изменились.

Свойство	Тип	Описание
columnHidden	boolean	Указывает, скрыты ли все столбцы текущего диапазона.
formulas	Json	Представляет формулу в формате A1.
formulasLocal	Json	Представляет формулу в формате A1 на языке пользователя и в соответствии с его языковым стандартом. Например, английская формула =SUM(A1, 1.5) превратится в "=СУММ(A1; 1,5)" на русском языке.
formulasR1C1	Json	Представляет формулу в формате R1C1.
numberFormat	Json	Представляет код в числовом формате Excel для данной ячейки.
rowHidden	boolean	Указывает, скрыты ли все строки текущего диапазона.
values	Json	Представляет необработанные значения указанного диапазона. Могут возвращаться строковые и числовые данные, а также логические значения. Ячейка, которая содержит ошибку, вернет строку ошибки.

Отклик

В случае успеха этот метод возвращает код отклика 200 OK и обновленный объект Range в тексте отклика.

Пример

Запрос

Ниже приведен пример запроса. Он обновляет диапазон — значения числовой формат и формулу. Значение null сообщает API, что в данном случае нужно пропустить ячейку. Значения, числовые форматы и формулы можно обновлять по отдельности или в одном вызове API.

HTTP

PATCH https://graph.microsoft.com/v1.0/me/drive/items/{id}/workbook/worksheets/{sheet-id}/range(address='A1:B2')
Content-type: application/json

{
"values" : [["Hello", "100"],["1/1/2016", null]],
"formulas" : [[null, null], [null, "=B1*2"]],
"numberFormat" : [[null,null], ["m-ddd", null]]
}

Go

import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  graphmodels "github.com/microsoftgraph/msgraph-sdk-go/Drives/Item/Items/Item/Workbook/Worksheets/Item/RangeWithAddress"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)


requestBody := graphmodels.NewRange(address='{address}')PatchRequestBody()
additionalData := map[string]interface{}{
	values := []graphmodels.Arrayable {
		 := []string {
			"Hello",
			"100",

		}
		 := []string {
			"1/1/2016",
			 := null
requestBody.Set(&) 

		}

	}
	formulas := []graphmodels.Arrayable {
		 := []graphmodels.Nullable {
			 := null
requestBody.Set(&) 
			 := null
requestBody.Set(&) 

		}
		 := []graphmodels.Nullable {
			 := null
requestBody.Set(&) 
			"=B1*2",

		}

	}
	numberFormat := []graphmodels.Arrayable {
		 := []graphmodels.Nullable {
			 := null
requestBody.Set(&) 
			 := null
requestBody.Set(&) 

		}
		 := []string {
			"m-ddd",
			 := null
requestBody.Set(&) 

		}

	}
}
requestBody.SetAdditionalData(additionalData)

graphClient.Drives().ByDriveId("drive-id").Items().ByItemId("driveItem-id").Workbook().Worksheets().ByWorksheetId("workbookWorksheet-id").Range(address='{address}')().Patch(context.Background(), requestBody, nil)

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const workbookRange = {
values: [['Hello', '100'],['1/1/2016', null]],
formulas: [[null, null], [null, '=B1*2']],
numberFormat: [[null,null], ['m-ddd', null]]
};

await client.api('/me/drive/items/{id}/workbook/worksheets/{sheet-id}/range(address='A1:B2')')
	.update(workbookRange);

Дополнительные сведения о добавлении пакета SDK в проект и создании экземпляра authProvider см. в документации по пакету SDK.

Отклик

Ниже приведен пример отклика. Примечание. Объект отклика, показанный здесь, может быть сокращен для удобочитаемости.

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

{
  "address": "address-value",
  "addressLocal": "addressLocal-value",
  "cellCount": 99,
  "columnCount": 99,
  "columnIndex": 99,
  "valueTypes": "valueTypes-value"
}