Method: documents.create

Tworzy pusty dokument z tytułem podanym w żądaniu. Pozostałe pola w żądaniu, łącznie z podaną treścią, są ignorowane.

Zwraca utworzony dokument.

Żądanie HTTP

POST https://docs.googleapis.com/v1/documents

Adres URL używa składni transkodowania gRPC.

Treść żądania

Treść żądania zawiera dane o następującej strukturze:

Zapis 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)
    },
    ...
  }
}
Pola
documentId

string

Tylko dane wyjściowe. Identyfikator dokumentu.

title

string

Tytuł dokumentu.

tabs[]

object (Tab)

Karty będące częścią dokumentu.

Karty mogą zawierać karty podrzędne, czyli karty zagnieżdżone w innych kartach. Karty podrzędne są reprezentowane przez pole Tab.childTabs.

revisionId

string

Tylko dane wyjściowe. Identyfikator wersji dokumentu. Można go używać w żądaniach aktualizacji, aby określić, do której wersji dokumentu mają zostać zastosowane aktualizacje i jak powinno działać żądanie, jeśli dokument był edytowany od czasu wprowadzenia tej wersji. To pole jest wypełniane tylko wtedy, gdy użytkownik ma uprawnienia do edycji dokumentu.

Identyfikator wersji nie jest liczbą sekwencyjną, ale nieprzezroczystym ciągiem. Format identyfikatora wersji może się z czasem zmienić. Gwarantujemy, że zwrócony identyfikator wersji będzie ważny tylko przez 24 godziny po zwróceniu i nie będzie można go udostępniać użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, dokument nie został zmieniony. Jeśli natomiast zmienisz identyfikator (tego samego dokumentu i tego samego użytkownika), zwykle oznacza to, że dokument został zaktualizowany. Jednak zmiana identyfikatora może wynikać z czynników wewnętrznych, takich jak zmiana formatu identyfikatora.

suggestionsViewMode

enum (SuggestionsViewMode)

Tylko dane wyjściowe. Tryb widoku sugestii zastosowany do dokumentu.

Uwaga: podczas edytowania dokumentu zmiany muszą być wprowadzone w dokumencie z atrybutem SUGGESTIONS_INLINE.

body

object (Body)

Tylko dane wyjściowe. Główna treść dokumentu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.body, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

headers

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

Tylko dane wyjściowe. Nagłówki w dokumencie kluczem według identyfikatora nagłówka.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.headers, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

footers

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

Tylko dane wyjściowe. Stopki w dokumencie, pogrupowane według identyfikatora stopki.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.footers, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

footnotes

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

Tylko dane wyjściowe. Przypisy w dokumencie przypisane do klucza identyfikatora przypisu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.footnotes, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

documentStyle

object (DocumentStyle)

Tylko dane wyjściowe. Styl dokumentu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.documentStyle, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

suggestedDocumentStyleChanges

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

Tylko dane wyjściowe. Sugerowane zmiany stylu dokumentu oparte na identyfikatorze sugestii.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.suggestedDocumentStyleChanges, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

namedStyles

object (NamedStyles)

Tylko dane wyjściowe. Nazwane style dokumentu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.namedStyles, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

suggestedNamedStylesChanges

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

Tylko dane wyjściowe. Sugerowane zmiany w nazwanych stylach dokumentu bazujących na identyfikatorze sugestii.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.suggestedNamedStylesChanges, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

lists

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

Tylko dane wyjściowe. Listy w dokumencie z zastosowaniem identyfikatora listy.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.lists, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

namedRanges

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

Tylko dane wyjściowe. Zakresy nazwane w dokumencie z kluczem według nazwy.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.namedRanges, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

inlineObjects

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

Tylko dane wyjściowe. Obiekty wbudowane w dokumencie, których kluczem jest kluczowy identyfikator obiektu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.inlineObjects, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

positionedObjects

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

Tylko dane wyjściowe. Pozycjonowane obiekty w dokumencie z kluczem według identyfikatora obiektu.

Starsza wersja pola: zamiast tego użyj pola Document.tabs.documentTab.positionedObjects, które udostępnia rzeczywistą zawartość dokumentu ze wszystkich kart, gdy parametr includeTabsContent ma wartość true. Jeśli zasada ma wartość false lub jest nieskonfigurowana, to pole zawiera informacje o pierwszej karcie w dokumencie.

Treść odpowiedzi

Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Document.

Zakresy autoryzacji

Wymaga jednego z tych zakresów protokołu OAuth:

  • https://www.googleapis.com/auth/documents
  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file

Więcej informacji znajdziesz w przewodniku na temat autoryzacji.