pasta de trabalho: tableRowOperationResult
Namespace: microsoft.graph
Essa função é a última de uma série de etapas para criar uma pasta de trabalhoTableRow de forma assíncrona.
Uma prática recomendada para criar várias linhas de tabela é loteá-las em uma operação create tableRow e executar a operação de forma assíncrona.
Uma solicitação assíncrona para criar linhas de tabela envolve as seguintes etapas:
- Emita uma solicitação criar tableRow assíncrona e obtenha a URL de consulta retornada no cabeçalho de
Location
resposta. - Use a URL de consulta retornada da etapa 1 para emitir a solicitação Obter workbookOperation e obter a ID da operação para a etapa 3.
Como alternativa, para conveniência, depois de obter um
succeeded
resultado operationStatus, você pode obter a URL de consulta da propriedade resourceLocation da pasta de trabalhoOperation retornada na resposta e aplicar a URL de consulta à etapa 3. - Use a URL de consulta retornada da etapa 2 como a URL de solicitação GET para essa tabela de funçõesRowOperationResult. Uma chamada de função bem-sucedida retorna as novas linhas de tabela em um recurso workbookTableRow .
Essa função não faz nada se for chamada de forma independente.
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
GET /me/drive/items/{id}/workbook/tableRowOperationResult(key={operation-id})
GET /me/drive/root:/{item-path}:/workbook/tableRowOperationResult(key={operation-id})
Parâmetros de função
A URL de solicitação requer o seguinte parâmetro de consulta.
Parâmetro | Tipo | Descrição |
---|---|---|
chave | Cadeia de caracteres | A operationId fornecida na resposta workbookOperation retornada na solicitação Get workbookOperation anterior. |
Cabeçalhos de solicitação
Nome | Descrição |
---|---|
Autorização | {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização. |
Workbook-Session-Id | ID da sessão da pasta de trabalho que determina se as alterações são persistentes. Opcional. |
Corpo da solicitação
Não forneça um corpo de solicitação para esse método.
Resposta
Se for bem-sucedida, essa função retornará um 200 OK
código de resposta e um objeto workbookTableRow no corpo da resposta.
Exemplos
Solicitação
O exemplo a seguir mostra uma solicitação.
GET https://graph.microsoft.com/beta/me/drive/items/01CCETFLK7GVZTZHSQNRD2AEI5XWTCU6FJ/workbook/tableRowOperationResult(key='0195cfac-bd22-4f91-b276-dece0aa2378b')
Resposta
O exemplo a seguir mostra a resposta.
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-Type: application/json
{
"index": 99,
"values": "[[1, 2, 3]]"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de