Method: documents.create

Cria um documento em branco usando o título fornecido na solicitação. Os outros campos da solicitação, incluindo o conteúdo fornecido, serã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,
  "tabs": [
    {
      object (Tab)
    }
  ],
  "revisionId": string,
  "suggestionsViewMode": enum (SuggestionsViewMode),
  "body": {
    object (Body)
  },
  "headers": {
    string: {
      object (Header)
    },
    ...
  },
  "footers": {
    string: {
      object (Footer)
    },
    ...
  },
  "footnotes": {
    string: {
      object (Footnote)
    },
    ...
  },
  "documentStyle": {
    object (DocumentStyle)
  },
  "suggestedDocumentStyleChanges": {
    string: {
      object (SuggestedDocumentStyle)
    },
    ...
  },
  "namedStyles": {
    object (NamedStyles)
  },
  "suggestedNamedStylesChanges": {
    string: {
      object (SuggestedNamedStyles)
    },
    ...
  },
  "lists": {
    string: {
      object (List)
    },
    ...
  },
  "namedRanges": {
    string: {
      object (NamedRanges)
    },
    ...
  },
  "inlineObjects": {
    string: {
      object (InlineObject)
    },
    ...
  },
  "positionedObjects": {
    string: {
      object (PositionedObject)
    },
    ...
  }
}
Campos
documentId

string

Apenas saída. O ID do documento.

title

string

O título do documento.

tabs[]

object (Tab)

Guias que fazem parte de um documento.

As guias podem conter guias secundárias, que são aninhadas dentro de outra. As guias filhas são representadas pelo campo Tab.childTabs.

revisionId

string

Apenas saída. O ID da revisão do documento. Pode ser usado em solicitações de atualização para especificar a qual revisão de um documento aplicar atualizações e como a solicitação deverá se comportar se o documento tiver sido editado desde essa revisão. Preenchido apenas se o usuário tiver acesso para editar o documento.

O ID de revisão não é um número sequencial, mas uma string opaca. O formato do ID de revisão pode mudar com o tempo. O ID de revisão retornado só é válido por 24 horas após o retorno e não pode ser compartilhado entre usuários. Se o ID da revisão não for alterado entre as chamadas, o documento não terá sido alterado. Por outro lado, um código alterado (para o mesmo documento e usuário) geralmente significa que o documento foi atualizado. No entanto, um ID alterado também pode ser devido a fatores internos, como mudanças no formato do ID.

suggestionsViewMode

enum (SuggestionsViewMode)

Apenas saída. O modo de visualização de sugestões aplicado ao documento.

Observação: quando você edita um documento, as alterações precisam ser feitas com base em um documento com SUGGESTIONS_INLINE.

body

object (Body)

Apenas saída. O corpo principal do documento.

Campo legado: em vez disso, use Document.tabs.documentTab.body, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent está definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

headers

map (key: string, value: object (Header))

Apenas saída. Os cabeçalhos no documento, codificados por ID do cabeçalho.

Campo legado: em vez disso, use Document.tabs.documentTab.headers, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent está definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

footers

map (key: string, value: object (Footer))

Apenas saída. Os rodapés no documento, codificados pelo ID do rodapé.

Campo legado: em vez disso, use Document.tabs.documentTab.footers, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent é definido como true. Se false ou não definido, esse campo contém informações sobre a primeira guia no documento.

footnotes

map (key: string, value: object (Footnote))

Apenas saída. As notas de rodapé no documento, codificadas por ID da nota de rodapé.

Campo legado: em vez disso, use Document.tabs.documentTab.footnotes, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent é definido como true. Se false ou não definido, esse campo contém informações sobre a primeira guia no documento.

documentStyle

object (DocumentStyle)

Apenas saída. O estilo do documento.

Campo legado: em vez disso, use Document.tabs.documentTab.documentStyle, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent está definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

suggestedDocumentStyleChanges

map (key: string, value: object (SuggestedDocumentStyle))

Apenas saída. As alterações sugeridas para o estilo do documento, codificadas por ID de sugestão.

Campo legado: em vez disso, use Document.tabs.documentTab.suggestedDocumentStyleChanges, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent é definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

namedStyles

object (NamedStyles)

Apenas saída. Os estilos nomeados do documento.

Campo legado: em vez disso, use Document.tabs.documentTab.namedStyles, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent é definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

suggestedNamedStylesChanges

map (key: string, value: object (SuggestedNamedStyles))

Apenas saída. As alterações sugeridas para os estilos nomeados do documento, codificadas por ID de sugestão.

Campo legado: em vez disso, use Document.tabs.documentTab.suggestedNamedStylesChanges, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent é definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

lists

map (key: string, value: object (List))

Apenas saída. As listas no documento, codificadas por ID da lista.

Campo legado: em vez disso, use Document.tabs.documentTab.lists, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent é definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

namedRanges

map (key: string, value: object (NamedRanges))

Apenas saída. Os intervalos nomeados no documento, com chave de nome.

Campo legado: em vez disso, use Document.tabs.documentTab.namedRanges, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent está definido como true. Se false ou não definido, esse campo contém informações sobre a primeira guia no documento.

inlineObjects

map (key: string, value: object (InlineObject))

Apenas saída. Os objetos inline no documento, com chave de ID do objeto.

Campo legado: em vez disso, use Document.tabs.documentTab.inlineObjects, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent está definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

positionedObjects

map (key: string, value: object (PositionedObject))

Apenas saída. Os objetos posicionados no documento, codificados pelo ID do objeto.

Campo legado: em vez disso, use Document.tabs.documentTab.positionedObjects, que expõe o conteúdo real do documento de todas as guias quando o parâmetro includeTabsContent é definido como true. Se false ou não for definido, este campo conterá informações sobre a primeira guia no documento.

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 do 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.