Compartilhar via


Criar TableRow

Namespace: microsoft.graph

Adiciona linhas ao final de uma tabela.

Observe que essa API pode aceitar várias linhas de dados. Adicionar uma linha por vez pode afetar o desempenho. A abordagem recomendada é agrupar as linhas em uma única chamada, em vez de inserir linhas individuais. Para obter melhores resultados, colete as linhas a serem inseridas no lado do aplicativo e execute uma única operação de adição de linha. Experimente o número de linhas para determinar o número ideal de linhas a serem usadas em uma única chamada de API.

Essa solicitação pode ocasionalmente resultar em um 504 HTTP erro. A resposta apropriada para esta mensagem de erro é repetir a solicitação.

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) Files.ReadWrite Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

POST /me/drive/items/{id}/workbook/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/tables/{id|name}/rows
POST /me/drive/items/{id}/workbook/worksheets/{id|name}/tables/{id|name}/rows
POST /me/drive/root:/{item-path}:/workbook/worksheets/{id|name}/tables/{id|name}/rows

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type application/json. Obrigatório.
Preferir respond-assíncrona. Indica que a solicitação é uma solicitação assíncrona. Opcional.
Workbook-Session-Id {Workbook-Session-Id}. Criado a partir da solicitação createSession . Opcional.

Corpo da solicitação

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
índice Int32 Opcional. Especifica a posição relativa da nova linha. Se for nulo, a adição ocorre no final. Todas as linhas abaixo da linha inserida serão deslocadas para baixo. Indexado com zero.
values Json Uma matriz bidimensional de valores não formatados das linhas de tabela.

Resposta

Se for bem-sucedido, esse método retornará um 201 Created código de resposta e um objeto workbookTableRow no corpo da resposta.

Exemplos

Exemplo 1: Adicionar duas linhas a uma tabela

Neste exemplo, duas linhas de dados são inseridas no final da tabela.

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/v1.0/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json

{
  "values": [
    [1, 2, 3],
    [4, 5, 6]
  ]
}

Resposta

O exemplo a seguir mostra a resposta.

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

HTTP/1.1 201 Created
Content-type: application/json

{
  "index": 99,
  "values": [[1, 2, 3]]
}

Exemplo 2: Adicionar duas linhas a uma tabela de forma assíncrona

As solicitações assíncronas serão úteis se a solicitação levar mais tempo do que o esperado. Observe que o Workbook-Session-Id cabeçalho é necessário ao emitir solicitações assíncronas. O usuário precisa criar sessão antes de usar recursos de API avançados assíncronos. O cabeçalho Prefer:respond-async também é necessário nas solicitações assíncronas.

Para recursos assíncronos, o usuário geralmente precisa emitir duas ou três solicitações: esta solicitação, Obter workbookOperation e, opcionalmente, Obter tableRowOperationResult.

Solicitação

Aqui está um exemplo da solicitação assíncrona. Observe que 202 Accepted isso só acontecerá quando a solicitação demorar muito tempo para responder. Se a solicitação for concluída rapidamente, ela funcionará como uma solicitação de sincronização regular, voltando ao Exemplo 1.

POST https://graph.microsoft.com/v1.0/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tables/Table1/rows
Content-type: application/json
Prefer: respond-async
Workbook-Session-Id: {Workbook-Session-Id}

{
  "values": [
    [1, 2, 3],
    [4, 5, 6]
  ]
}

Resposta

Aqui está outro exemplo da resposta que levará a uma operação assíncrona. Para obter detalhes, consulte Obter workbookOperation e Obter tableRowOperationResult.

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/operations/0195cfac-bd22-4f91-b276-dece0aa2378b?sessionId=Y2x1c3Rlcj1QU0c0JnNlc3Npb249MTUuU0cyUEVQRjAwMDI4RjI1MS5BMTE2LjEuVTM2LmM4MGRiNjkwLTQwMTktNGNkNS1hYWJiLTJmYzczM2YxZTQ5ZjE0LjUuZW4tVVM1LmVuLVVTMjQuMTAwM2JmZmRhYzUyMzkzOS1Qcml2YXRlMS5TMjQuJTJmUEI0JTJmWjJqZmt1aXhJZHBjeE8xYmclM2QlM2QxNi4xNi4wLjE0NDEwLjM1MDUwMTQuNS5lbi1VUzUuZW4tVVMxLk0xLk4wLjEuUyZ1c2lkPWExOTMyNTU0LTlhNDAtNzYzNi1mNDU3LWEyNjExMmFkNDg2YQ==
Content-type: application/json

{
}