Tworzy pustą prezentację, korzystając z tytułu podanego w żądaniu. Jeśli został podany parametr presentationId
, zostanie on użyty jako identyfikator nowej prezentacji. W przeciwnym razie zostanie wygenerowany nowy identyfikator. Inne pola żądania, w tym wszelkie podane treści, są ignorowane. Zwraca utworzoną prezentację.
Żądanie HTTP
POST https://slides.googleapis.com/v1/presentations
Adres URL używa składni transkodowania gRPC.
Treść żądania
Treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
---|
{ "presentationId": string, "pageSize": { object ( |
Pola | |
---|---|
presentationId |
Identyfikator prezentacji. |
pageSize |
Rozmiar stron w prezentacji. |
slides[] |
Slajdy w prezentacji. Slajd dziedziczy właściwości z układu slajdu. |
title |
Tytuł prezentacji. |
masters[] |
wzorce slajdów w prezentacji, Wzorzec slajdu zawiera wszystkie wspólne elementy strony i wspólne właściwości zestawu układów. Służą one trzem celom:
|
layouts[] |
Układy w prezentacji. Układ to szablon określający sposób rozmieszczenia i stylu treści na slajdach dziedziczących układ. |
locale |
Język prezentacji jako tag języka IETF BCP 47. |
revisionId |
Tylko dane wyjściowe. Identyfikator wersji prezentacji. Może być używany w żądaniach aktualizacji do potwierdzenia, że wersja prezentacji nie zmieniła się od ostatniej operacji odczytu. Pole wypełnione tylko wtedy, gdy użytkownik ma uprawnienia do edycji prezentacji. Identyfikator wersji nie jest liczbą sekwencyjną, ale niejednoznacznym ciągiem. Format identyfikatora wersji może się z czasem zmieniać, dlatego należy traktować go jako nieprzejrzysty. Zwrócony identyfikator wersji jest ważny tylko przez 24 godziny od zwrócenia i nie można go udostępniać innym użytkownikom. Jeśli identyfikator wersji nie uległ zmianie między wywołaniami, prezentacja się nie zmieniła. Natomiast zmiana identyfikatora (dla tej samej prezentacji i użytkownika) zwykle oznacza, że prezentacja została zaktualizowana. Zmiana identyfikatora może jednak być spowodowana czynnikami wewnętrznymi, takimi jak zmiana formatu identyfikatora. |
notesMaster |
Mistrz notatek w prezentacji. Służy to 3 celom:
Wzorzec notatek jest tylko do odczytu. |
Treść odpowiedzi
Jeśli operacja się uda, treść odpowiedzi będzie zawierała nowo utworzoną instancję Presentation
.
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
https://www.googleapis.com/auth/drive
https://www.googleapis.com/auth/drive.file
https://www.googleapis.com/auth/presentations
Więcej informacji znajdziesz w przewodniku po autoryzacji.