Tworzy pusty dokument z tytułem podanym w żądaniu. Pozostałe pola w żądaniu, w tym wszelkie podane 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 ( |
Pola | |
---|---|
documentId |
Tylko dane wyjściowe. Identyfikator dokumentu. |
title |
Tytuł dokumentu. |
tabs[] |
Karty będące częścią dokumentu. Karty mogą zawierać karty podrzędne, czyli karty umieszczone w innej karcie. Karty podrzędne są reprezentowane przez pole |
revisionId |
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 zmieniać. Zwrócony identyfikator wersji jest gwarantowany tylko przez 24 godziny od momentu jego zwrotu i nie może być udostępniany innym użytkownikom. Jeśli identyfikator wersji nie zmienia się między wywołaniami, dokument nie został zmieniony. Natomiast zmiana identyfikatora (tego samego dokumentu i użytkownika) oznacza zazwyczaj, że dokument został zaktualizowany. Zmiana identyfikatora może być też spowodowana czynnikami wewnętrznymi, np. zmianami formatu identyfikatora. |
suggestionsViewMode |
Tylko dane wyjściowe. Tryb widoku sugestii zastosowany do dokumentu. Uwaga: podczas edytowania dokumentu zmiany muszą być wprowadzone w dokumencie z atrybutem |
body |
Tylko dane wyjściowe. Główna treść dokumentu. Pole starsze: zamiast tego użyj pola |
headers |
Tylko dane wyjściowe. Nagłówki w dokumencie, posortowane według identyfikatora nagłówka. Pole starsze: zamiast tego użyj pola |
footers |
Tylko dane wyjściowe. Stopki w dokumencie, pogrupowane według identyfikatora stopki. Starsza wersja pola: zamiast tego użyj pola |
footnotes |
Tylko dane wyjściowe. przypisy w dokumencie, posortowane według identyfikatora przypisu; Starsza wersja pola: zamiast tego użyj pola |
documentStyle |
Tylko dane wyjściowe. Styl dokumentu. Starsza wersja pola: zamiast tego użyj pola |
suggestedDocumentStyleChanges |
Tylko dane wyjściowe. Sugerowane zmiany stylu dokumentu oparte na identyfikatorze sugestii. Starsza wersja pola: zamiast tego użyj pola |
namedStyles |
Tylko dane wyjściowe. Nazwane style dokumentu. Starsza wersja pola: zamiast tego użyj pola |
suggestedNamedStylesChanges |
Tylko dane wyjściowe. Sugerowane zmiany w nazwanych stylach dokumentu bazujących na identyfikatorze sugestii. Starsza wersja pola: zamiast tego użyj pola |
lists |
Tylko dane wyjściowe. Listy w dokumencie pogrupowane według identyfikatora listy. Starsza wersja pola: zamiast tego użyj pola |
namedRanges |
Tylko dane wyjściowe. Nazwane zakresy w dokumencie, posortowane według nazwy. Starsza wersja pola: zamiast tego użyj pola |
inlineObjects |
Tylko dane wyjściowe. Obiekty w dokumencie, których kluczem jest identyfikator obiektu. Starsza wersja pola: zamiast tego użyj pola |
positionedObjects |
Tylko dane wyjściowe. Pozycjonowane obiekty w dokumencie z kluczem według identyfikatora obiektu. Starsza wersja pola: zamiast tego użyj pola |
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 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 dotyczącym autoryzacji.