Cria um documento em branco usando o título fornecido na solicitação. Outros campos na solicitação, incluindo qualquer conteúdo fornecido, são ignorados.
Retorna o documento criado.
Solicitação HTTP
POST https://docs.googleapis.com/v1/documents
O URL usa a sintaxe de transcodificação gRPC.
Corpo da solicitação
O corpo da solicitação contém dados com a seguinte estrutura:
Representação JSON |
---|
{ "documentId": string, "title": string, "body": { object ( |
Campos | |
---|---|
documentId |
Apenas saída. O ID do documento. |
title |
O título do documento. |
body |
Apenas saída. O corpo principal do documento. |
headers |
Apenas saída. Os cabeçalhos no documento, codificados pelo ID do cabeçalho. |
footers |
Apenas saída. Os rodapés no documento, codificados pelo ID do rodapé. |
footnotes |
Apenas saída. As notas de rodapé no documento, codificadas pelo código da nota de rodapé. |
documentStyle |
Apenas saída. O estilo do documento. |
suggestedDocumentStyleChanges |
Apenas saída. As alterações sugeridas para o estilo do documento, codificadas pelo código da sugestão. |
namedStyles |
Apenas saída. Os estilos nomeados do documento. |
suggestedNamedStylesChanges |
Apenas saída. As alterações sugeridas para os estilos nomeados do documento, codificadas pelo ID da sugestão. |
lists |
Apenas saída. As listas no documento, codificadas pelo código da lista. |
namedRanges |
Apenas saída. Os intervalos nomeados no documento, codificados por nome. |
revisionId |
Apenas saída. O ID de revisão do documento. Pode ser usado em solicitações de atualização para especificar a qual revisão de um documento as atualizações serão aplicadas e como a solicitação deve se comportar se o documento tiver sido editado desde a revisão. Preenchido apenas se o usuário tiver acesso de edição ao documento. O código de revisão não é um número sequencial, mas uma string opaca. O formato do ID de revisão pode mudar ao longo do tempo. Um código de revisão retornado só é válido por 24 horas depois de ser retornado e não pode ser compartilhado entre usuários. Se o ID de revisão não for alterado entre as chamadas, o documento não foi alterado. Por outro lado, um ID alterado (para o mesmo documento e usuário) normalmente significa que o documento foi atualizado. No entanto, um ID alterado também pode ser causado por fatores internos, como alterações no formato do ID. |
suggestionsViewMode |
Apenas saída. O modo de visualização de sugestões aplicado ao documento. Observação: ao editar um documento, as alterações precisam ser baseadas em um documento com |
inlineObjects |
Apenas saída. Os objetos in-line no documento, codificados pelo ID do objeto. |
positionedObjects |
Apenas saída. Os objetos posicionados no documento, codificados pelo ID do objeto. |
Corpo da resposta
Se a solicitação for bem-sucedida, o corpo da resposta incluirá uma instância de Document
.
Escopos de autorização
Requer um dos seguintes escopos de OAuth:
https://www.googleapis.com/auth/documents
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
Para mais informações, consulte o Guia de autorização.