Actualizar rango

Espacio de nombres: microsoft.graph

Actualizar las propiedades del objeto de rango.

Permisos

Se requiere uno de los permisos siguientes para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso	Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa)	Files.ReadWrite
Delegado (cuenta personal de Microsoft)	No admitida.
Aplicación	No admitida.

Solicitud 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

Encabezados de solicitud opcionales

Nombre	Descripción
Authorization	Portador {token}. Obligatorio.
Workbook-Session-Id	Identificador de sesión de libro que determina si los cambios se conservan o no. Opcional.

Cuerpo de solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no se incluyan en el cuerpo de la solicitud mantendrán los valores anteriores o se recalcularán según los cambios efectuados en otros valores de propiedad. Para obtener el mejor rendimiento no debe incluir valores existentes que no hayan cambiado.

Propiedad	Tipo	Descripción
columnHidden	boolean	Representa si todas las columnas del rango actual están ocultas.
formulas	Json	Representa la fórmula en notación de estilo A1.
formulasLocal	Json	Representa la fórmula en notación de estilo A1, en el idioma del usuario y en la configuración regional del formato numérico. Por ejemplo, la fórmula "=SUM(A1, 1.5)" en inglés se convertiría en "=SUMME(A1; 1,5)" en alemán.
formulasR1C1	Json	Representa la fórmula en notación de estilo R1C1.
numberFormat	Json	Representa el código de formato numérico de Excel para la celda especificada.
rowHidden	boolean	Representa si todas las filas del rango actual están ocultas.
values	Json	Representa los valores sin formato del rango especificado. Los datos devueltos pueden ser de tipo string, number o boolean. La celda que contenga un error devolverá la cadena de error.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 OK y el objeto Range actualizado en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud. Actualiza un rango: valores, formato de número y fórmula. La entrada null indica a la API que omita la celda para esa entrada en particular. Los valores, el formato de número y las fórmulas se pueden actualizar por separado o conjuntamente en la misma llamada de 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]]
}

Ir

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)

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del 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);

Para obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider , consulte la documentación del SDK.

Respuesta

Aquí tiene un ejemplo de la respuesta. Nota: el objeto de respuesta que se muestra aquí puede haberse acortado para mejorar la legibilidad.

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

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