Requests

Żądanie

Pojedynczy rodzaj aktualizacji, który ma zostać zastosowany w prezentacji.

Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "createSlide": {
    object (CreateSlideRequest)
  },
  "createShape": {
    object (CreateShapeRequest)
  },
  "createTable": {
    object (CreateTableRequest)
  },
  "insertText": {
    object (InsertTextRequest)
  },
  "insertTableRows": {
    object (InsertTableRowsRequest)
  },
  "insertTableColumns": {
    object (InsertTableColumnsRequest)
  },
  "deleteTableRow": {
    object (DeleteTableRowRequest)
  },
  "deleteTableColumn": {
    object (DeleteTableColumnRequest)
  },
  "replaceAllText": {
    object (ReplaceAllTextRequest)
  },
  "deleteObject": {
    object (DeleteObjectRequest)
  },
  "updatePageElementTransform": {
    object (UpdatePageElementTransformRequest)
  },
  "updateSlidesPosition": {
    object (UpdateSlidesPositionRequest)
  },
  "deleteText": {
    object (DeleteTextRequest)
  },
  "createImage": {
    object (CreateImageRequest)
  },
  "createVideo": {
    object (CreateVideoRequest)
  },
  "createSheetsChart": {
    object (CreateSheetsChartRequest)
  },
  "createLine": {
    object (CreateLineRequest)
  },
  "refreshSheetsChart": {
    object (RefreshSheetsChartRequest)
  },
  "updateShapeProperties": {
    object (UpdateShapePropertiesRequest)
  },
  "updateImageProperties": {
    object (UpdateImagePropertiesRequest)
  },
  "updateVideoProperties": {
    object (UpdateVideoPropertiesRequest)
  },
  "updatePageProperties": {
    object (UpdatePagePropertiesRequest)
  },
  "updateTableCellProperties": {
    object (UpdateTableCellPropertiesRequest)
  },
  "updateLineProperties": {
    object (UpdateLinePropertiesRequest)
  },
  "createParagraphBullets": {
    object (CreateParagraphBulletsRequest)
  },
  "replaceAllShapesWithImage": {
    object (ReplaceAllShapesWithImageRequest)
  },
  "duplicateObject": {
    object (DuplicateObjectRequest)
  },
  "updateTextStyle": {
    object (UpdateTextStyleRequest)
  },
  "replaceAllShapesWithSheetsChart": {
    object (ReplaceAllShapesWithSheetsChartRequest)
  },
  "deleteParagraphBullets": {
    object (DeleteParagraphBulletsRequest)
  },
  "updateParagraphStyle": {
    object (UpdateParagraphStyleRequest)
  },
  "updateTableBorderProperties": {
    object (UpdateTableBorderPropertiesRequest)
  },
  "updateTableColumnProperties": {
    object (UpdateTableColumnPropertiesRequest)
  },
  "updateTableRowProperties": {
    object (UpdateTableRowPropertiesRequest)
  },
  "mergeTableCells": {
    object (MergeTableCellsRequest)
  },
  "unmergeTableCells": {
    object (UnmergeTableCellsRequest)
  },
  "groupObjects": {
    object (GroupObjectsRequest)
  },
  "ungroupObjects": {
    object (UngroupObjectsRequest)
  },
  "updatePageElementAltText": {
    object (UpdatePageElementAltTextRequest)
  },
  "replaceImage": {
    object (ReplaceImageRequest)
  },
  "updateSlideProperties": {
    object (UpdateSlidePropertiesRequest)
  },
  "updatePageElementsZOrder": {
    object (UpdatePageElementsZOrderRequest)
  },
  "updateLineCategory": {
    object (UpdateLineCategoryRequest)
  },
  "rerouteLine": {
    object (RerouteLineRequest)
  },
  "insertComment": {
    object (InsertCommentRequest)
  },
  "addCommentReply": {
    object (AddCommentReplyRequest)
  },
  "updateCommentPost": {
    object (UpdateCommentPostRequest)
  },
  "deleteComment": {
    object (DeleteCommentRequest)
  },
  "deleteCommentReply": {
    object (DeleteCommentReplyRequest)
  }
  // End of mutually exclusive fields.
}
Pola
Rodzaj aktualizacji. Wymagane jest dokładnie jedno pole. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
createSlide

object (CreateSlideRequest)

Tworzy nowy slajd.

createShape

object (CreateShapeRequest)

Tworzy nowy kształt.

createTable

object (CreateTableRequest)

Tworzy nową tabelę.

insertText

object (InsertTextRequest)

Wstawia tekst do kształtu lub komórki tabeli.

insertTableRows

object (InsertTableRowsRequest)

Wstawia wiersze do tabeli.

insertTableColumns

object (InsertTableColumnsRequest)

Wstawia kolumny do tabeli.

deleteTableRow

object (DeleteTableRowRequest)

Usuwa wiersz z tabeli.

deleteTableColumn

object (DeleteTableColumnRequest)

Usuwa kolumnę z tabeli.

replaceAllText

object (ReplaceAllTextRequest)

Zastępuje wszystkie wystąpienia określonego tekstu.

deleteObject

object (DeleteObjectRequest)

Usuwa stronę lub element strony z prezentacji.

updatePageElementTransform

object (UpdatePageElementTransformRequest)

Aktualizuje przekształcenie elementu strony.

updateSlidesPosition

object (UpdateSlidesPositionRequest)

Aktualizuje pozycję zestawu slajdów w prezentacji.

deleteText

object (DeleteTextRequest)

Usuwa tekst z kształtu lub komórki tabeli.

createImage

object (CreateImageRequest)

Tworzy obraz.

createVideo

object (CreateVideoRequest)

Tworzy film.

createSheetsChart

object (CreateSheetsChartRequest)

Tworzy osadzony wykres Arkuszy Google.

createLine

object (CreateLineRequest)

Tworzy linię.

refreshSheetsChart

object (RefreshSheetsChartRequest)

Odświeża wykres w Arkuszach Google.

updateShapeProperties

object (UpdateShapePropertiesRequest)

Aktualizuje właściwości Shape.

updateImageProperties

object (UpdateImagePropertiesRequest)

Aktualizuje właściwości Image.

updateVideoProperties

object (UpdateVideoPropertiesRequest)

Aktualizuje właściwości Video.

updatePageProperties

object (UpdatePagePropertiesRequest)

Aktualizuje właściwości Page.

updateTableCellProperties

object (UpdateTableCellPropertiesRequest)

Aktualizuje właściwości TableCell.

updateLineProperties

object (UpdateLinePropertiesRequest)

Aktualizuje właściwości Line.

createParagraphBullets

object (CreateParagraphBulletsRequest)

Tworzy wypunktowania akapitów.

replaceAllShapesWithImage

object (ReplaceAllShapesWithImageRequest)

Zastępuje wszystkie kształty spełniające określone kryteria obrazem.

duplicateObject

object (DuplicateObjectRequest)

Duplikuje slajd lub element strony.

updateTextStyle

object (UpdateTextStyleRequest)

Aktualizuje styl tekstu w elemencie Shape lub Table.

replaceAllShapesWithSheetsChart

object (ReplaceAllShapesWithSheetsChartRequest)

Zastępuje wszystkie kształty spełniające określone kryteria wykresem z Arkuszy Google.

deleteParagraphBullets

object (DeleteParagraphBulletsRequest)

Usuwa wypunktowania z akapitów.

updateParagraphStyle

object (UpdateParagraphStyleRequest)

Aktualizuje styl akapitów w Shape lub Table.

updateTableBorderProperties

object (UpdateTableBorderPropertiesRequest)

Aktualizuje właściwości obramowań tabeli w obiekcie Table.

updateTableColumnProperties

object (UpdateTableColumnPropertiesRequest)

Aktualizuje właściwości kolumny Table.

updateTableRowProperties

object (UpdateTableRowPropertiesRequest)

Aktualizuje właściwości wiersza Table.

mergeTableCells

object (MergeTableCellsRequest)

Scala komórki w zakresie Table.

unmergeTableCells

object (UnmergeTableCellsRequest)

Rozdziela komórki w Table.

groupObjects

object (GroupObjectsRequest)

Grupowanie obiektów, np. elementów strony.

ungroupObjects

object (UngroupObjectsRequest)

Rozgrupowuje obiekty, takie jak groups.

updatePageElementAltText

object (UpdatePageElementAltTextRequest)

Aktualizuje tytuł i/lub opis tekstu alternatywnego elementu page element.

replaceImage

object (ReplaceImageRequest)

Zastępuje istniejący obraz nowym.

updateSlideProperties

object (UpdateSlidePropertiesRequest)

Aktualizuje właściwości slajdu.

updatePageElementsZOrder

object (UpdatePageElementsZOrderRequest)

Aktualizuje kolejność nakładania elementu page elements.

updateLineCategory

object (UpdateLineCategoryRequest)

Aktualizuje kategorię line.

rerouteLine

object (RerouteLineRequest)

Przekierowuje line, tak aby łączyło się z 2 najbliższymi punktami połączenia na połączonych elementach strony.

insertComment

object (InsertCommentRequest)

Wstawia do prezentacji element CommentThread.

addCommentReply

object (AddCommentReplyRequest)

Dodaje odpowiedź do CommentThread.

updateCommentPost

object (UpdateCommentPostRequest)

Aktualizuje istniejącego posta (posta głównego lub odpowiedź) w CommentThread.

deleteComment

object (DeleteCommentRequest)

Usuwa CommentThread.

deleteCommentReply

object (DeleteCommentReplyRequest)

Usuwa odpowiedź Post z CommentThread.

Koniec pól wykluczających się nawzajem.

CreateSlideRequest

Tworzy slajd.

Zapis JSON 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
Pola
objectId

string

Identyfikator obiektu podany przez użytkownika.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą być takie same, a także mogą to być łączniki lub dwukropki (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora musi wynosić od 5 do 50 znaków włącznie.

Jeśli nie podasz identyfikatora, zostanie wygenerowany unikalny identyfikator.

insertionIndex

integer

Opcjonalny indeks rozpoczynający się od 0, który wskazuje, gdzie wstawić slajdy.

Jeśli nie określisz indeksu, slajd zostanie utworzony na końcu.

slideLayoutReference

object (LayoutReference)

Układ slajdu do wstawienia na podstawie bieżącego wzorca, który może być jednym z tych elementów:

  • Wzorzec indeksu poprzedniego slajdu.
  • Wzorzec pierwszego slajdu, jeśli argument insertionIndex ma wartość zero.
  • Pierwszy wzorzec w prezentacji, jeśli nie ma slajdów.

Jeśli element LayoutReference nie zostanie znaleziony w bieżącym wzorcu, zwracany jest błąd 400 (Nieprawidłowe żądanie).

Jeśli nie określisz odwołania do układu, slajd będzie używać predefiniowanego układu BLANK.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

Opcjonalna lista mapowań identyfikatorów obiektów z elementu placeholder(s) w układzie do symboli zastępczych utworzonych na slajdzie na podstawie określonego układu. Można jej używać tylko wtedy, gdy określono ustawienie opcji slideLayoutReference.

LayoutReference

Dokumentacja układu slajdu. Może to odnosić się do:

  • wstępnie zdefiniowany układ,
  • Jeden z układów w prezentacji.
Zapis JSON 
{

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of mutually exclusive fields.
}
Pola
Rodzaj LayoutReference. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
predefinedLayout

enum (PredefinedLayout)

wstępnie zdefiniowany układ,

layoutId

string

Identyfikator układu: identyfikator obiektu jednego z układów w prezentacji.

Koniec pól wykluczających się nawzajem.

PredefinedLayout

wstępnie zdefiniowane typy układów. Są to popularne układy w prezentacjach. Nie ma jednak gwarancji, że te układy znajdują się w bieżącym wzorcu, ponieważ mogły zostać usunięte lub nie są częścią użytego motywu. Mogły też zostać zmienione elementy zastępcze w poszczególnych układach.

Wartości w polu enum
PREDEFINED_LAYOUT_UNSPECIFIED Nieokreślony układ.
BLANK Pusty układ bez obiektów zastępczych.
CAPTION_ONLY Układ z podpisem u dołu.
TITLE Układ z tytułem i podtytułem.
TITLE_AND_BODY Układ z tytułem i treścią.
TITLE_AND_TWO_COLUMNS Układ z tytułem i dwiema kolumnami.
TITLE_ONLY Układ zawierający tylko tytuł.
SECTION_HEADER Układ z tytułem sekcji.
SECTION_TITLE_AND_DESCRIPTION Układ z tytułem i podtytułem po jednej stronie oraz opisem po drugiej.
ONE_COLUMN_TEXT Układ z 1 tytułem i 1 treścią, rozmieszczonymi w 1 kolumnie.
MAIN_POINT Układ z głównym punktem.
BIG_NUMBER Układ z nagłówkiem z dużą liczbą.

LayoutPlaceholderIdMapping

Mapowanie identyfikatorów określone przez użytkownika dla elementu zastępczego, który zostanie utworzony na slajdzie z określonego układu.

Zapis JSON 
{
  "objectId": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of mutually exclusive fields.
}
Pola
objectId

string

Identyfikator obiektu dostarczony przez użytkownika dla powyższego symbolu zastępczego, który ma zostać utworzony na slajdzie.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora nie może być mniejsza niż 5 znaków ani większa niż 50 znaków.

Jeśli nie podasz identyfikatora, zostanie wygenerowany unikalny identyfikator.

Rodzaj identyfikujący element zastępczy w układzie. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
layoutPlaceholder

object (Placeholder)

Obiekt zastępczy w układzie, który zostanie zastosowany do slajdu. Wymagane są tylko parametry type i index. Na przykład predefiniowany układ TITLE_AND_BODY może zwykle zawierać element zastępczy TITLE o indeksie 0 i element zastępczy BODY o indeksie 0.

layoutPlaceholderObjectId

string

Identyfikator obiektu symbolu zastępczego w układzie, który zostanie zastosowany do slajdu.

Koniec pól wykluczających się nawzajem.

CreateShapeRequest

Tworzy nowy kształt.

Zapis JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
Pola
objectId

string

Identyfikator obiektu podany przez użytkownika.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora nie może być mniejsza niż 5 znaków ani większa niż 50 znaków. Jeśli pole jest puste, zostanie wygenerowany unikalny identyfikator.

elementProperties

object (PageElementProperties)

Właściwości elementu kształtu.

shapeType

enum (Type)

Typ kształtu.

PageElementProperties

Właściwości wspólne elementu strony.

Uwaga: gdy po raz pierwszy utworzysz PageElement, interfejs API może zmodyfikować wartości zarówno size, jak i transform, ale rozmiar wizualny pozostanie bez zmian.

Zapis JSON 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
Pola
pageObjectId

string

Identyfikator obiektu strony, na której znajduje się element.

size

object (Size)

Rozmiar elementu.

transform

object (AffineTransform)

Przekształcenie elementu.

CreateTableRequest

Tworzy nową tabelę.

Zapis JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
Pola
objectId

string

Identyfikator obiektu podany przez użytkownika.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora nie może być mniejsza niż 5 znaków ani większa niż 50 znaków.

Jeśli nie podasz identyfikatora, zostanie wygenerowany unikalny identyfikator.

elementProperties

object (PageElementProperties)

Właściwości elementu tabeli.

Tabela zostanie utworzona w podanym rozmiarze, z zastrzeżeniem minimalnego rozmiaru. Jeśli nie podasz rozmiaru, tabela zostanie automatycznie dopasowana.

Przekształcenia tabeli muszą mieć skalę 1 i nie mogą zawierać komponentów ścinania. Jeśli nie podasz przekształcenia, tabela zostanie wyśrodkowana na stronie.

rows

integer

Liczba wierszy w tabeli.

columns

integer

Liczba kolumn w tabeli.

InsertTextRequest

Wstawia tekst do kształtu lub komórki tabeli.

Zapis JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
Pola
objectId

string

Identyfikator obiektu kształtu lub tabeli, w którym ma zostać wstawiony tekst.

cellLocation

object (TableCellLocation)

Opcjonalna lokalizacja komórki tabeli, jeśli tekst ma zostać wstawiony do komórki tabeli. Jeśli jest obecny, element objectId musi odwoływać się do tabeli.

text

string

Tekst do wstawienia.

Wstawienie znaku nowego wiersza spowoduje niejawne utworzenie nowego elementu ParagraphMarker w tym indeksie. Styl akapitu nowego akapitu zostanie skopiowany z akapitu w bieżącym indeksie wstawiania, w tym listy i punktorów.

Style tekstu wstawionego tekstu zostaną określone automatycznie, zwykle z zachowaniem stylu sąsiedniego tekstu. W większości przypadków tekst zostanie dodany do elementu TextRun znajdującego się w indeksie wstawiania.

Niektóre znaki sterujące (U+0000–U+0008, U+000C–U+001F) i znaki z obszaru prywatnego użytku w Unicode Basic Multilingual Plane (U+E000–U+F8FF) zostaną usunięte z wstawionego tekstu.

insertionIndex

integer

Indeks, w którym zostanie wstawiony tekst, w jednostkach kodu Unicode, na podstawie indeksów TextElement.

Indeks jest liczony od zera i od początku ciągu. Indeks można dostosować, aby zapobiec wstawianiu w klastrach grafemów Unicode. W takich przypadkach tekst zostanie wstawiony bezpośrednio po klastrze grafemów.

InsertTableRowsRequest

Wstawia wiersze do tabeli.

Zapis JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
Pola
tableObjectId

string

Tabela, do której mają zostać wstawione wiersze.

cellLocation

object (TableCellLocation)

Lokalizacja komórki tabeli odniesienia, z której zostaną wstawione wiersze.

Nowy wiersz zostanie wstawiony powyżej (lub poniżej) wiersza, w którym znajduje się komórka odniesienia. Jeśli komórka odniesienia jest scaloną komórką, nowy wiersz zostanie wstawiony powyżej (lub poniżej) scalonej komórki.

insertBelow

boolean

Określa, czy nowe wiersze mają być wstawiane poniżej komórki odniesienia.

  • True : wstaw poniżej komórki.
  • False : wstawia powyżej komórki.
number

integer

Liczba wierszy do wstawienia. Maksymalnie 20 na żądanie.

InsertTableColumnsRequest

Wstawia kolumny do tabeli.

Rozmiar innych kolumn w tabeli zostanie zmieniony, aby dopasować się do nowej kolumny.

Zapis JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
Pola
tableObjectId

string

Tabela, do której mają zostać wstawione kolumny.

cellLocation

object (TableCellLocation)

Lokalizacja komórki tabeli odniesienia, z której zostaną wstawione kolumny.

Nowa kolumna zostanie wstawiona po lewej (lub prawej) stronie kolumny, w której znajduje się komórka odniesienia. Jeśli komórka odniesienia jest komórką scaloną, nowa kolumna zostanie wstawiona po lewej (lub prawej) stronie komórki scalonej.

insertRight

boolean

Określa, czy nowe kolumny mają być wstawiane po prawej stronie komórki odniesienia.

  • True: wstawianie po prawej stronie.
  • False: wstaw po lewej stronie.
number

integer

Liczba kolumn do wstawienia. Maksymalnie 20 na żądanie.

DeleteTableRowRequest

Usuwa wiersz z tabeli.

Zapis JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Pola
tableObjectId

string

Tabela, z której chcesz usunąć wiersze.

cellLocation

object (TableCellLocation)

Lokalizacja komórki tabeli referencyjnej, z której zostanie usunięty wiersz.

Wiersz, w którym znajduje się ta komórka, zostanie usunięty. Jeśli jest to scalona komórka, zostanie usuniętych kilka wierszy. Jeśli po usunięciu w tabeli nie pozostaną żadne wiersze, cała tabela zostanie usunięta.

DeleteTableColumnRequest

Usuwa kolumnę z tabeli.

Zapis JSON 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Pola
tableObjectId

string

Tabela, z której chcesz usunąć kolumny.

cellLocation

object (TableCellLocation)

Lokalizacja komórki tabeli referencyjnej, z której zostanie usunięta kolumna.

Kolumna, w której znajduje się ta komórka, zostanie usunięta. Jeśli jest to scalona komórka, zostanie usuniętych kilka kolumn. Jeśli po usunięciu kolumn w tabeli nie pozostaną żadne kolumny, cała tabela zostanie usunięta.

ReplaceAllTextRequest

Zastępuje wszystkie wystąpienia tekstu spełniającego kryteria znakiem replace text.

Zapis JSON 
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of mutually exclusive fields.
}
Pola
replaceText

string

Tekst, który zastąpi dopasowany tekst.

pageObjectIds[]

string

Jeśli nie jest pusta, ogranicza dopasowania do elementów strony tylko na podanych stronach.

Zwraca błąd 400 – nieprawidłowe żądanie, jeśli podano identyfikator obiektu strony notes master lub jeśli strona o tym identyfikatorze obiektu nie istnieje w prezentacji.

Kryteria używane do dopasowywania tekstu do zastąpienia. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
containsText

object (SubstringMatchCriteria)

Znajduje tekst w kształcie pasujący do tego podciągu.

Koniec pól wykluczających się nawzajem.

SubstringMatchCriteria

Kryterium, które pasuje do określonego ciągu tekstowego w kształcie lub tabeli.

Zapis JSON 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
Pola
text

string

Tekst, który ma być wyszukiwany w kształcie lub tabeli.

matchCase

boolean

Wskazuje, czy w wyszukiwaniu ma być uwzględniana wielkość liter:

  • True : w wyszukiwaniu jest rozróżniana wielkość liter.
  • False: w wyszukiwaniu nie jest rozróżniana wielkość liter.
searchByRegex

boolean

Opcjonalnie. Wartość Prawda, jeśli wartość do znalezienia ma być traktowana jako wyrażenie regularne. Wzorzec nie może zawierać ukośników odwrotnych.

  • True: tekst wyszukiwania jest traktowany jako wyrażenie regularne.
  • False : tekst wyszukiwania jest traktowany jako podciąg do dopasowania.

DeleteObjectRequest

Usuwa z prezentacji obiekt pages lub page elements.

Zapis JSON 
{
  "objectId": string
}
Pola
objectId

string

Identyfikator obiektu strony lub elementu strony do usunięcia.

Jeśli po operacji usuwania group zawiera tylko 1 element strony lub nie zawiera żadnego, grupa również zostanie usunięta.

Jeśli symbol zastępczy zostanie usunięty z układu, wszystkie puste symbole zastępcze dziedziczone również zostaną usunięte.

UpdatePageElementTransformRequest

Aktualizuje przekształcenie elementu strony.

Aktualizacja przekształcenia grupy spowoduje zmianę bezwzględnego przekształcenia elementów strony w tej grupie, co może wpłynąć na ich wygląd. Aby dowiedzieć się więcej, zapoznaj się z dokumentacją dotyczącą PageElement.transform.

Zapis JSON 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
Pola
objectId

string

Identyfikator obiektu elementu strony do zaktualizowania.

transform

object (AffineTransform)

Macierz transformacji danych wejściowych używana do aktualizowania elementu strony.

applyMode

enum (ApplyMode)

Tryb zastosowania aktualizacji transformacji.

ApplyMode

Tryby stosowania aktualizacji przekształcenia.

Wartości w polu enum
APPLY_MODE_UNSPECIFIED Tryb nieokreślony.
RELATIVE Stosuje nową macierz AffineTransform do istniejącej i zastępuje ją wynikową konkatenacją.
ABSOLUTE Zastępuje istniejącą macierz AffineTransform nową.

UpdateSlidesPositionRequest

Zmienia pozycję slajdów w prezentacji.

Zapis JSON 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Pola
slideObjectIds[]

string

Identyfikatory slajdów w prezentacji, które mają zostać przeniesione. Slajdy na tej liście muszą być ułożone w kolejności, w jakiej występują w prezentacji, i nie mogą się powtarzać.

insertionIndex

integer

Indeks, w którym należy wstawić slajdy, na podstawie układu slajdów przed przeniesieniem. Musi to być liczba z zakresu od zera do liczby slajdów w prezentacji (włącznie).

DeleteTextRequest

Usuwa tekst z kształtu lub komórki tabeli.

Zapis JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Pola
objectId

string

Identyfikator obiektu kształtu lub tabeli, z którego zostanie usunięty tekst.

cellLocation

object (TableCellLocation)

Opcjonalna lokalizacja komórki tabeli, jeśli tekst ma zostać usunięty z komórki tabeli. Jeśli jest obecny, element objectId musi odwoływać się do tabeli.

textRange

object (Range)

Zakres tekstu do usunięcia na podstawie indeksów TextElement.

Na końcu tekstu kształtu lub komórki tabeli zawsze znajduje się znak nowego wiersza, którego nie można usunąć. Range.Type.ALL użyje prawidłowych granic, ale podczas określania jawnych granic dla typów zakresów FROM_START_INDEX i FIXED_RANGE należy zachować ostrożność. Jeśli na przykład tekst to „ABC”, a po nim następuje niejawny znak nowego wiersza, maksymalna wartość wynosi 2 w przypadku parametru textRange.start_index i 3 w przypadku parametru textRange.end_index.

Usunięcie tekstu, który przekracza granicę akapitu, może spowodować zmiany w stylach akapitów i listach, ponieważ 2 akapity zostaną połączone.

Zakresy, które obejmują tylko 1 jednostkę kodu pary zastępczej, są rozszerzane tak, aby obejmowały obie jednostki kodu.

Zakres

Określa ciągły zakres indeksowanej kolekcji, np. znaków w tekście.

Zapis JSON 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
Pola
startIndex

integer

Opcjonalny indeks początkowy kolekcji (liczony od zera). Wymagane w przypadku zakresów FIXED_RANGE i FROM_START_INDEX.

endIndex

integer

Opcjonalny indeks od zera oznaczający koniec kolekcji. Wymagane w przypadku FIXED_RANGE zakresów.

type

enum (Type)

Typ zakresu.

Typ

Typy zakresów.

Wartości w polu enum
RANGE_TYPE_UNSPECIFIED Nieokreślony typ zakresu. Nie można używać tej wartości.
FIXED_RANGE Stały zakres. Musisz określić zarówno wartość startIndex, jak i endIndex.
FROM_START_INDEX Zaczyna się od startIndex i trwa do końca kolekcji. Nie można podać parametru endIndex.
ALL Ustawia zakres na całą długość kolekcji. Nie można określić jednocześnie wartości startIndex i endIndex.

CreateImageRequest

Tworzy obraz.

Zapis JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "url": string
  // End of mutually exclusive fields.
}
Pola
objectId

string

Identyfikator obiektu podany przez użytkownika.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora nie może być mniejsza niż 5 znaków ani większa niż 50 znaków.

Jeśli nie podasz identyfikatora, zostanie wygenerowany unikalny identyfikator.

elementProperties

object (PageElementProperties)

Właściwości elementu obrazu.

Jeśli format podanego rozmiaru nie jest zgodny z formatem obrazu, obraz jest skalowany i wyśrodkowywany względem rozmiaru, aby zachować format. Podana transformacja jest stosowana po tej operacji.

Właściwość PageElementProperties.size jest opcjonalna. Jeśli nie określisz rozmiaru, zostanie użyty domyślny rozmiar obrazu.

Właściwość PageElementProperties.transform jest opcjonalna. Jeśli nie określisz przekształcenia, obraz zostanie umieszczony w lewym górnym rogu strony.

Rodzaj źródła obrazu. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
url

string

Adres URL obrazu.

Obraz jest pobierany raz w momencie wstawienia, a jego kopia jest przechowywana do wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą przekraczać 25 megapikseli i muszą być w jednym z tych formatów: PNG, JPEG lub GIF.

Podany adres URL musi być publicznie dostępny i mieć długość do 2 KB. Adres URL jest zapisywany z obrazem i udostępniany w polu Image.source_url.

Koniec pól wykluczających się nawzajem.

CreateVideoRequest

Tworzy film.

UWAGA: aby utworzyć film z Dysku Google, aplikacja wysyłająca żądanie musi mieć co najmniej jeden z zakresów OAuth: drive, drive.readonly lub drive.file.

Zapis JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
Pola
objectId

string

Identyfikator obiektu podany przez użytkownika.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora nie może być mniejsza niż 5 znaków ani większa niż 50 znaków.

Jeśli nie podasz identyfikatora, zostanie wygenerowany unikalny identyfikator.

elementProperties

object (PageElementProperties)

Właściwości elementu wideo.

Właściwość PageElementProperties.size jest opcjonalna. Jeśli nie określisz rozmiaru, serwer wybierze domyślny rozmiar.

Właściwość PageElementProperties.transform jest opcjonalna. Przekształcenie nie może mieć komponentów ścinania. Jeśli nie określisz przekształcenia, film zostanie umieszczony w lewym górnym rogu strony.

source

enum (Source)

Źródło filmu.

id

string

Unikalny identyfikator tego filmu w źródle wideo.

np. w przypadku filmu na YouTube https://www.youtube.com/watch?v=7U3axjORYZ0 identyfikatorem jest 7U3axjORYZ0. W przypadku filmu na Dysku Google https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q identyfikator to 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Aby uzyskać dostęp do pliku wideo na Dysku Google, w przypadku podzbioru starszych plików może być konieczne dodanie klucza zasobu do nagłówka HTTP. Więcej informacji znajdziesz w artykule Uzyskiwanie dostępu do plików udostępnionych za pomocą linku przy użyciu kluczy zasobów.

CreateSheetsChartRequest

Tworzy osadzony wykres Arkuszy Google.

UWAGA: do utworzenia wykresu wymagany jest co najmniej jeden z zakresów OAuth: spreadsheets.readonly, spreadsheets, drive.readonly, drive.file lub drive.

Zapis JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
Pola
objectId

string

Identyfikator obiektu podany przez użytkownika.

Jeśli identyfikator jest określony, musi być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator powinien zaczynać się od znaku słowa [a–zA–Z0–9_], a następnie zawierać dowolną liczbę tych znaków: [a–zA–Z0–9_-:]. Długość identyfikatora nie powinna być mniejsza niż 5 znaków ani większa niż 50 znaków. Jeśli pole jest puste, zostanie wygenerowany unikalny identyfikator.

elementProperties

object (PageElementProperties)

Właściwości elementu wykresu.

Jeśli format podanego rozmiaru nie jest zgodny z formatem wykresu, wykres jest skalowany i wyśrodkowywany względem rozmiaru, aby zachować format. Podana transformacja jest stosowana po tej operacji.

spreadsheetId

string

Identyfikator arkusza kalkulacyjnego Google, który zawiera wykres.

W przypadku podzbioru starych plików może być konieczne dodanie klucza zasobu do nagłówka HTTP. Więcej informacji znajdziesz w artykule Uzyskiwanie dostępu do plików udostępnionych za pomocą linku przy użyciu kluczy zasobów.

chartId

integer

Identyfikator konkretnego wykresu w arkuszu kalkulacyjnym Arkuszy Google.

linkingMode

enum (LinkingMode)

Tryb, w którym wykres jest połączony z arkuszem kalkulacyjnym. Jeśli nie zostanie określony, wykres będzie obrazem bez linku.

LinkingMode

Tryb, w którym wykres jest połączony z arkuszem kalkulacyjnym.

Wartości w polu enum
NOT_LINKED_IMAGE Wykres nie jest powiązany z arkuszem źródłowym i nie można go zaktualizować. Wykres, który nie jest połączony, zostanie wstawiony jako obraz.
LINKED Połączenie wykresu umożliwia jego aktualizowanie, a inni współpracownicy zobaczą link do arkusza kalkulacyjnego.

CreateLineRequest

Tworzy linię.

Zapis JSON 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
Pola
objectId

string

Identyfikator obiektu podany przez użytkownika.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora nie może być mniejsza niż 5 znaków ani większa niż 50 znaków.

Jeśli nie podasz identyfikatora, zostanie wygenerowany unikalny identyfikator.

elementProperties

object (PageElementProperties)

Właściwości elementu w przypadku linii.

lineCategory
(deprecated)

enum (Category)

Kategoria linii do utworzenia.

Wycofane : użyj category zamiast niego.

Dokładny typ utworzonego elementu line type zależy od kategorii i sposobu jego kierowania w celu połączenia z innymi elementami strony.

Jeśli podasz zarówno parametr category, jak i lineCategory, pierwszeństwo ma parametr category.

category

enum (LineCategory)

Kategoria linii do utworzenia.

Dokładny typ utworzonego elementu line type zależy od kategorii i sposobu jego kierowania w celu połączenia z innymi elementami strony.

Jeśli podasz zarówno parametr category, jak i lineCategory, pierwszeństwo ma parametr category.

Jeśli nie podasz wartości dla atrybutu category, ale podasz wartość dla atrybutu lineCategory, zostanie użyta podana wartość atrybutu lineCategory.

Jeśli nie określisz żadnej z nich, używana będzie wartość STRAIGHT.

Kategoria

Kategorie wierszy.

Wartości w polu enum
STRAIGHT Złącza proste, w tym złącze proste 1. Jest to domyślna kategoria, gdy nie jest określona żadna inna.
BENT Wygięte złącza, w tym wygięte złącza od 2 do 5.
CURVED Łączniki zakrzywione, w tym łączniki zakrzywione 2–5.

RefreshSheetsChartRequest

Odświeża umieszczony wykres z Arkuszy Google, zastępując go najnowszą wersją wykresu z Arkuszy Google.

UWAGA: odświeżanie wykresów wymaga co najmniej jednego z zakresów OAuth: spreadsheets.readonly, spreadsheets, drive.readonly lub drive.

Zapis JSON 
{
  "objectId": string
}
Pola
objectId

string

Identyfikator obiektu wykresu do odświeżenia.

UpdateShapePropertiesRequest

Zaktualizuj właściwości Shape.

Zapis JSON 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu kształtu, do którego zastosowano aktualizacje.

shapeProperties

object (ShapeProperties)

Właściwości kształtu do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny shapeProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować kolor wypełnienia kształtu, ustaw fields na "shapeBackgroundFill.solidFill.color".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

UpdateImagePropertiesRequest

Zaktualizuj właściwości Image.

Zapis JSON 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu obrazu, do którego zastosowano aktualizacje.

imageProperties

object (ImageProperties)

Właściwości obrazu do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny imageProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować kolor konturu obrazu, ustaw fields na "outline.outlineFill.solidFill.color".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

UpdateVideoPropertiesRequest

Zaktualizuj właściwości Video.

Zapis JSON 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu filmu, do którego zastosowano aktualizacje.

videoProperties

object (VideoProperties)

Właściwości filmu do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny videoProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować kolor konturu filmu, ustaw wartość fields na "outline.outlineFill.solidFill.color".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

UpdatePagePropertiesRequest

Aktualizuje właściwości Page.

Zapis JSON 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu strony, do której zastosowano aktualizację.

pageProperties

object (PageProperties)

Właściwości strony do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny pageProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować kolor wypełnienia tła strony, ustaw fields na "pageBackgroundFill.solidFill.color".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

UpdateTableCellPropertiesRequest

Zaktualizuj właściwości TableCell.

Zapis JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu tabeli.

tableRange

object (TableRange)

Zakres tabeli reprezentujący podzbiór tabeli, do którego stosowane są aktualizacje. Jeśli nie określisz zakresu tabeli, aktualizacje zostaną zastosowane do całej tabeli.

tableCellProperties

object (TableCellProperties)

Właściwości komórki tabeli do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tableCellProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować kolor wypełnienia komórki tabeli, ustaw fields na "tableCellBackgroundFill.solidFill.color".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

TableRange

Zakres tabeli to odwołanie do podzbioru tabeli.

Pamiętaj, że komórki określone przez zakres tabeli nie muszą tworzyć prostokąta. Załóżmy na przykład, że mamy tabelę 3 x 3, w której wszystkie komórki ostatniego wiersza są scalone. Tabela wygląda tak: 

 [   ][   ][   ]
 [   ][   ][   ]
 [             ]

Zakres tabeli z lokalizacją = (0, 0), zakresem wierszy = 3 i zakresem kolumn = 2 określa te komórki: 

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
Zapis JSON 
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Pola
location

object (TableCellLocation)

Lokalizacja początkowa zakresu tabeli.

rowSpan

integer

Zakres wierszy zakresu tabeli.

columnSpan

integer

Zakres kolumn tabeli.

UpdateLinePropertiesRequest

Aktualizuje właściwości Line.

Zapis JSON 
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu wiersza, do którego zastosowano aktualizację.

lineProperties

object (LineProperties)

Właściwości linii do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny lineProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować kolor wypełnienia ciągłą linią, ustaw fields na "lineFill.solidFill.color".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

CreateParagraphBulletsRequest

Tworzy punktor dla wszystkich akapitów, które pokrywają się z podanym zakresem indeksu tekstu.

Poziom zagnieżdżenia każdego akapitu zostanie określony przez zliczenie tabulatorów na początku każdego akapitu. Aby uniknąć nadmiaru miejsca między punktorem a odpowiednim akapitem, te karty wiodące są usuwane na podstawie tej prośby. Może to zmienić indeksy części tekstu.

Jeśli akapit bezpośrednio poprzedzający aktualizowane akapity znajduje się na liście z pasującymi gotowymi ustawieniami, aktualizowane akapity są dodawane do tej listy.

Zapis JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Pola
objectId

string

Identyfikator obiektu kształtu lub tabeli zawierającej tekst, do którego mają zostać dodane punktor.

cellLocation

object (TableCellLocation)

Opcjonalna lokalizacja komórki tabeli, jeśli tekst do zmodyfikowania znajduje się w komórce tabeli. Jeśli jest obecny, element objectId musi odwoływać się do tabeli.

textRange

object (Range)

Zakres tekstu, do którego mają być zastosowane gotowe ustawienia punktorów, na podstawie indeksów.TextElement

bulletPreset

enum (BulletGlyphPreset)

Rodzaje symboli punktorów, które mają być używane. Domyślnie jest to ustawienie wstępne BULLET_DISC_CIRCLE_SQUARE.

BulletGlyphPreset

Gotowe wzory glifów punktorów do list w tekście.

W tych wzorach używane są te rodzaje punktorów:

  • ARROW: strzałka odpowiadająca punktowi kodowemu Unicode U+2794.
  • ARROW3D: strzałka z cieniowaniem 3D, odpowiadająca punktowi kodu Unicode U+27a2.
  • CHECKBOX: pusty kwadrat odpowiadający punktowi kodowemu Unicode U+274f
  • CIRCLE: pusty okrąg odpowiadający punktowi kodowemu Unicode U+25cb.
  • DIAMOND: pełny romb odpowiadający punktowi kodowemu Unicode U+25c6.
  • DIAMONDX : Diament z „x” w środku, odpowiadający punktowi kodowemu Unicode U+2756
  • HOLLOWDIAMOND : pusty romb odpowiadający punktowi kodowemu Unicode U+25c7
  • DISC: pełne kółko odpowiadające punktowi kodowemu Unicode U+25cf.
  • SQUARE : pełny kwadrat odpowiadający punktowi kodowemu Unicode U+25a0.
  • STAR : gwiazdka odpowiadająca punktowi kodowemu Unicode U+2605
  • ALPHA: mała litera, np. „a”, „b” lub „c”.
  • UPPERALPHA: wielka litera, np. „A”, „B” lub „C”.
  • DIGIT : liczba, np. „1”, „2” lub „3”.
  • ZERODIGIT: liczba, w przypadku której jednocyfrowe liczby są poprzedzone zerem, np. „01”, „02” lub „03”. Liczby wielocyfrowe nie mają zera na początku.
  • ROMAN : mała cyfra rzymska, np. „i”, „ii” lub „iii”.
  • UPPERROMAN: wielka cyfra rzymska, np. „I”, „II” lub „III”.
  • LEFTTRIANGLE: trójkąt skierowany w lewo, odpowiadający punktowi kodowemu Unicode U+25c4.
Wartości w polu enum
BULLET_DISC_CIRCLE_SQUARE Lista punktowana z symbolami punktów DISC, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_DIAMONDX_ARROW3D_SQUARE Lista punktowana z symbolami punktów DIAMONDX, ARROW3D i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_CHECKBOX Lista punktowana z CHECKBOX symbolami punktów na wszystkich poziomach zagnieżdżenia.
BULLET_ARROW_DIAMOND_DISC Lista punktowana z symbolami punktów ARROW, DIAMOND i DISC dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_STAR_CIRCLE_SQUARE Lista punktowana z symbolami punktów STAR, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_ARROW3D_CIRCLE_SQUARE Lista punktowana z symbolami punktów ARROW3D, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Lista punktowana z symbolami punktów LEFTTRIANGLE, DIAMOND i DISC dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Lista punktowana z symbolami punktów DIAMONDX, HOLLOWDIAMOND i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
BULLET_DIAMOND_CIRCLE_SQUARE Lista punktowana z symbolami punktów DIAMOND, CIRCLE i SQUARE dla pierwszych 3 poziomów zagnieżdżenia listy.
NUMBERED_DIGIT_ALPHA_ROMAN Lista numerowana z symbolami numerycznymi DIGIT, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Lista numerowana z glifami numerycznymi DIGIT, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują nawiasy.
NUMBERED_DIGIT_NESTED Lista numerowana z DIGIT glifami numerycznymi rozdzielonymi kropkami, w której każdy poziom zagnieżdżenia używa glifu z poprzedniego poziomu zagnieżdżenia jako prefiksu. Na przykład: „1.”, '1.1.', '2.', '2.2'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN Lista numerowana z symbolami numerycznymi UPPERALPHA, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Lista numerowana z symbolami numerycznymi UPPERROMAN, UPPERALPHA i DIGIT dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Lista numerowana z symbolami numerycznymi ZERODIGIT, ALPHA i ROMAN dla pierwszych 3 poziomów zagnieżdżenia listy, po których następują kropki.

ReplaceAllShapesWithImageRequest

Zastępuje wszystkie kształty spełniające podane kryteria podanym obrazem.

Obrazy zastępujące kształty są prostokątne po wstawieniu do prezentacji i nie przyjmują formy kształtów.

Zapis JSON 
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of mutually exclusive fields.

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "imageUrl": string
  // End of mutually exclusive fields.
}
Pola
replaceMethod
(deprecated)

enum (ReplaceMethod)

Metoda replace.

Wycofane : użyj imageReplaceMethod zamiast niego.

Jeśli określisz zarówno parametr replaceMethod, jak i parametr imageReplaceMethod, parametr imageReplaceMethod ma pierwszeństwo.

imageReplaceMethod

enum (ImageReplaceMethod)

Metoda zastępowania obrazu.

Jeśli określisz zarówno parametr replaceMethod, jak i parametr imageReplaceMethod, parametr imageReplaceMethod ma pierwszeństwo.

Jeśli nie podasz wartości dla atrybutu imageReplaceMethod, ale podasz wartość dla atrybutu replaceMethod, zostanie użyta podana wartość atrybutu replaceMethod.

Jeśli nie określisz żadnego z nich, użyta zostanie wartość CENTER_INSIDE.

pageObjectIds[]

string

Jeśli nie jest pusta, ogranicza dopasowania do elementów strony tylko na podanych stronach.

Zwraca błąd 400 – nieprawidłowe żądanie, jeśli podano identyfikator obiektu strony notes page lub notes master albo jeśli w prezentacji nie ma strony o tym identyfikatorze.

Kryteria, które muszą spełniać kształty, aby można było je zastąpić. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
containsText

object (SubstringMatchCriteria)

Jeśli ta opcja jest ustawiona, to żądanie zastąpi wszystkie kształty zawierające podany tekst.

Koniec pól wykluczających się nawzajem.
Rodzaj źródła obrazu. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
imageUrl

string

Adres URL obrazu.

Obraz jest pobierany raz w momencie wstawienia, a jego kopia jest przechowywana do wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą mieć więcej niż 25 megapikseli i muszą być w jednym z tych formatów: PNG, JPEG lub GIF.

Podany adres URL może mieć maksymalnie 2 KB. Sam adres URL jest zapisywany z obrazem i udostępniany w polu Image.source_url.

Koniec pól wykluczających się nawzajem.

ReplaceMethod

Metoda replace.

Wartości w polu enum
CENTER_INSIDE Skaluje i wyśrodkowuje obraz, aby dopasować go do granic oryginalnego kształtu, zachowując format obrazu. Wyrenderowany rozmiar obrazu może być mniejszy niż rozmiar kształtu. Jest to domyślna metoda, gdy nie określono innej.
CENTER_CROP Skaluje i wyśrodkowuje obraz, aby wypełnić granice oryginalnego kształtu. Obraz może zostać przycięty, aby wypełnić kształt. Renderowany rozmiar obrazu będzie taki sam jak rozmiar pierwotnego kształtu.

ImageReplaceMethod

Metoda zastępowania obrazu.

Wartości w polu enum
IMAGE_REPLACE_METHOD_UNSPECIFIED Nieokreślona metoda zastępowania obrazu. Nie można używać tej wartości.
CENTER_INSIDE Skaluje i wyśrodkowuje obraz, aby dopasować go do granic oryginalnego kształtu, zachowując format obrazu. Wyrenderowany rozmiar obrazu może być mniejszy niż rozmiar kształtu. Jest to domyślna metoda, gdy nie określono innej.
CENTER_CROP Skaluje i wyśrodkowuje obraz, aby wypełnić granice oryginalnego kształtu. Obraz może zostać przycięty, aby wypełnić kształt. Wyrenderowany rozmiar obrazu będzie taki sam jak pierwotny kształt.

DuplicateObjectRequest

Duplikuje slajd lub element strony.

Gdy duplikujesz slajd, zduplikowany slajd zostanie utworzony bezpośrednio po wybranym slajdzie. Gdy zduplikujesz element strony, zostanie on umieszczony na tej samej stronie w tym samym miejscu co oryginał.

Zapis JSON 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Pola
objectId

string

Identyfikator obiektu do zduplikowania.

objectIds

map (key: string, value: string)

Duplikowany obiekt może zawierać inne obiekty, na przykład podczas duplikowania slajdu lub elementu strony grupy. Ta mapa określa sposób generowania identyfikatorów zduplikowanych obiektów: klucze to identyfikatory oryginalnych obiektów, a wartości to identyfikatory, które zostaną przypisane do odpowiednich zduplikowanych obiektów. W tej mapie można też określić identyfikator duplikatu obiektu źródłowego, używając tej samej wartości pola objectId jako klucza i nowego identyfikatora jako wartości.

Wszystkie klucze muszą odpowiadać istniejącym identyfikatorom w prezentacji. Wszystkie wartości w prezentacji muszą być unikalne i zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]); pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość nowego identyfikatora nie może być mniejsza niż 5 ani większa niż 50.

Jeśli w mapie pominięto identyfikatory obiektów źródłowych, zostanie przypisany nowy losowy identyfikator. Jeśli mapa jest pusta lub nie jest ustawiona, wszystkie zduplikowane obiekty otrzymają nowy losowy identyfikator.

UpdateTextStyleRequest

Zaktualizuj styl tekstu w Shape lub Table.

Zapis JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu kształtu lub tabeli z tekstem, który ma zostać sformatowany.

cellLocation

object (TableCellLocation)

Lokalizacja komórki w tabeli zawierającej tekst, który ma zostać sformatowany. Jeśli objectId odnosi się do tabeli, cellLocation musi mieć wartość. W przeciwnym razie nie może tego robić.

style

object (TextStyle)

Style, które mają zostać zastosowane do tekstu.

Jeśli wartość danego stylu jest zgodna z wartością stylu nadrzędnego, styl ten zostanie ustawiony jako dziedziczony.

Niektóre zmiany stylu tekstu mogą powodować inne zmiany, które mają odzwierciedlać działanie edytora Prezentacji. Więcej informacji znajdziesz w dokumentacji TextStyle.

textRange

object (Range)

Zakres tekstu, do którego ma zostać zastosowany styl.

Zakres można rozszerzyć, aby uwzględnić sąsiednie znaki nowego wiersza.

Jeśli zakres w pełni zawiera akapit należący do listy, punktor akapitu jest również aktualizowany o pasujący styl tekstu.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny style jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zmienić styl tekstu na pogrubiony, ustaw fields na "bold".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

ReplaceAllShapesWithSheetsChartRequest

Zastępuje wszystkie kształty spełniające podane kryteria podanym wykresem z Arkuszy Google. Wykres zostanie przeskalowany i wyśrodkowany, aby zmieścił się w granicach oryginalnego kształtu.

UWAGA: zastąpienie kształtów wykresem wymaga co najmniej jednego z zakresów OAuth spreadsheets.readonly, spreadsheets, drive.readonly lub drive.

Zapis JSON 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Pola
containsText

object (SubstringMatchCriteria)

Kryteria, które muszą spełniać kształty, aby można było je zastąpić. Żądanie spowoduje zastąpienie wszystkich kształtów zawierających podany tekst.

spreadsheetId

string

Identyfikator arkusza kalkulacyjnego Google, który zawiera wykres.

chartId

integer

Identyfikator konkretnego wykresu w arkuszu kalkulacyjnym Arkuszy Google.

linkingMode

enum (LinkingMode)

Tryb, w którym wykres jest połączony z arkuszem kalkulacyjnym. Jeśli nie zostanie określony, wykres będzie obrazem bez linku.

pageObjectIds[]

string

Jeśli nie jest pusta, ogranicza dopasowania do elementów strony tylko na podanych stronach.

Zwraca błąd 400 – nieprawidłowe żądanie, jeśli podano identyfikator obiektu strony notes page lub notes master albo jeśli w prezentacji nie ma strony o tym identyfikatorze.

LinkingMode

Tryb, w którym wykres jest połączony z arkuszem kalkulacyjnym.

Wartości w polu enum
NOT_LINKED_IMAGE Wykres nie jest powiązany z arkuszem źródłowym i nie można go zaktualizować. Wykres, który nie jest połączony, zostanie wstawiony jako obraz.
LINKED Połączenie wykresu umożliwia jego aktualizowanie, a inni współpracownicy zobaczą link do arkusza kalkulacyjnego.

DeleteParagraphBulletsRequest

Usuwa wypunktowania ze wszystkich akapitów, które pokrywają się z danym indeksem tekstu range.

Poziom zagnieżdżenia każdego akapitu zostanie wizualnie zachowany przez dodanie wcięcia na początku odpowiedniego akapitu.

Zapis JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Pola
objectId

string

Identyfikator obiektu kształtu lub tabeli zawierającej tekst, z którego chcesz usunąć punktor.

cellLocation

object (TableCellLocation)

Opcjonalna lokalizacja komórki tabeli, jeśli tekst do zmodyfikowania znajduje się w komórce tabeli. Jeśli jest obecny, element objectId musi odwoływać się do tabeli.

textRange

object (Range)

Zakres tekstu, z którego mają zostać usunięte punktor, na podstawie indeksów.TextElement

UpdateParagraphStyleRequest

Aktualizuje styl wszystkich akapitów w Shape lub Table, które pokrywają się z podanym zakresem indeksu tekstu.

Zapis JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu kształtu lub tabeli z tekstem, który ma zostać sformatowany.

cellLocation

object (TableCellLocation)

Lokalizacja komórki w tabeli zawierającej akapity, które mają zostać sformatowane. Jeśli objectId odnosi się do tabeli, cellLocation musi mieć wartość. W przeciwnym razie nie może tego robić.

style

object (ParagraphStyle)

Styl akapitu.

textRange

object (Range)

Zakres tekstu zawierający akapity, które mają zostać sformatowane.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny style jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować wyrównanie akapitu, ustaw fields na "alignment".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

UpdateTableBorderPropertiesRequest

Aktualizuje właściwości obramowań tabeli w obiekcie Table.

Zapis JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu tabeli.

tableRange

object (TableRange)

Zakres tabeli reprezentujący podzbiór tabeli, do którego stosowane są aktualizacje. Jeśli nie określisz zakresu tabeli, aktualizacje zostaną zastosowane do całej tabeli.

borderPosition

enum (BorderPosition)

Pozycja obramowania w zakresie tabeli, do którego mają być stosowane aktualizacje. Jeśli nie określisz pozycji obramowania, aktualizacje zostaną zastosowane do wszystkich obramowań w zakresie tabeli.

tableBorderProperties

object (TableBorderProperties)

Właściwości obramowania tabeli do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tableBorderProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować kolor wypełnienia obramowania tabeli, ustaw wartość fields na "tableBorderFill.solidFill.color".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

BorderPosition

Pozycja obramowania tabeli.

Wartości w polu enum
ALL Wszystkie obramowania w zakresie.
BOTTOM Granice na dole zakresu.
INNER Obramowania wewnątrz zakresu.
INNER_HORIZONTAL Obramowania poziome wewnątrz zakresu.
INNER_VERTICAL Obramowania pionowe wewnątrz zakresu.
LEFT Obramowania po lewej stronie zakresu.
OUTER Obramowania wzdłuż zewnętrznych krawędzi zakresu.
RIGHT Granice po prawej stronie zakresu.
TOP Granice u góry zakresu.

UpdateTableColumnPropertiesRequest

Aktualizuje właściwości kolumny Table.

Zapis JSON 
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu tabeli.

columnIndices[]

integer

Lista indeksów od zera określających kolumny do zaktualizowania. Jeśli nie podasz indeksów, zaktualizowane zostaną wszystkie kolumny w tabeli.

tableColumnProperties

object (TableColumnProperties)

Właściwości kolumny tabeli do zaktualizowania.

Jeśli wartość tableColumnProperties#columnWidth w żądaniu jest mniejsza niż 406 400 EMU (32 punkty), zwracany jest błąd 400 (nieprawidłowe żądanie).

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tableColumnProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować szerokość kolumny, ustaw wartość fields na "columnWidth".

Jeśli w masce pola znajduje się „columnWidth”, ale właściwość nie jest ustawiona,szerokość kolumny będzie domyślnie wynosić 406 400 EMU (32 punkty).

UpdateTableRowPropertiesRequest

Aktualizuje właściwości wiersza Table.

Zapis JSON 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu tabeli.

rowIndices[]

integer

Lista indeksów od zera określających, które wiersze mają zostać zaktualizowane. Jeśli nie podasz indeksów, zaktualizowane zostaną wszystkie wiersze w tabeli.

tableRowProperties

object (TableRowProperties)

Właściwości wiersza tabeli do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Katalog główny tableRowProperties jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować minimalną wysokość wiersza, ustaw fields na "minRowHeight".

Jeśli w masce pola znajduje się „minRowHeight”, ale właściwość nie jest ustawiona, minimalna wysokość wiersza będzie domyślnie wynosić 0.

MergeTableCellsRequest

Scala komórki w zakresie Table.

Zapis JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Pola
objectId

string

Identyfikator obiektu tabeli.

tableRange

object (TableRange)

Zakres tabeli określający, które komórki tabeli mają zostać scalone.

Tekst w scalanych komórkach zostanie połączony i zapisany w lewej górnej komórce zakresu („głównej”). Jeśli zakres nie jest prostokątny (co może się zdarzyć w niektórych przypadkach, gdy zakres obejmuje komórki, które są już scalone), zwracany jest błąd 400 (nieprawidłowe żądanie).

UnmergeTableCellsRequest

Rozdziela komórki w Table.

Zapis JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Pola
objectId

string

Identyfikator obiektu tabeli.

tableRange

object (TableRange)

Zakres tabeli określający, które komórki tabeli mają zostać rozdzielone.

Wszystkie scalone komórki w tym zakresie zostaną rozdzielone, a komórki, które są już rozdzielone, pozostaną bez zmian. Jeśli zakres nie zawiera scalonych komórek, żądanie nie spowoduje żadnych zmian. Jeśli w którejkolwiek ze scalonych komórek znajduje się tekst, pozostanie on w lewej górnej („głównej”) komórce powstałego bloku niescalonych komórek.

GroupObjectsRequest

Grupuje obiekty, aby utworzyć grupę obiektów. Na przykład grupy PageElements aby utworzyć Group na tej samej stronie co wszystkie elementy podrzędne.

Zapis JSON 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Pola
groupObjectId

string

Identyfikator obiektu grupy, która ma zostać utworzona, podany przez użytkownika.

Jeśli określisz identyfikator, musi on być unikalny wśród wszystkich stron i elementów strony w prezentacji. Identyfikator musi zaczynać się od znaku alfanumerycznego lub podkreślenia (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_]). Pozostałe znaki mogą obejmować te znaki, a także łącznik lub dwukropek (zgodnie z wyrażeniem regularnym [a-zA-Z0-9_-:]). Długość identyfikatora nie może być mniejsza niż 5 znaków ani większa niż 50 znaków.

Jeśli nie podasz identyfikatora, zostanie wygenerowany unikalny identyfikator.

childrenObjectIds[]

string

Identyfikatory obiektów, które mają zostać zgrupowane.

Grupować można tylko elementy strony. Na tej samej stronie powinny znajdować się co najmniej 2 elementy strony, które nie należą jeszcze do innej grupy. Niektórych elementów strony, takich jak videos, tables i placeholders, nie można dodać do grupy.

UngroupObjectsRequest

Rozgrupowuje obiekty, takie jak groups.

Zapis JSON 
{
  "objectIds": [
    string
  ]
}
Pola
objectIds[]

string

Identyfikatory obiektów do rozgrupowania.

Rozgrupować można tylko groups, które nie znajdują się w innych groups. Wszystkie grupy powinny znajdować się na tej samej stronie. Sama grupa zostanie usunięta. Wizualne rozmiary i pozycje wszystkich elementów podrzędnych są zachowywane.

UpdatePageElementAltTextRequest

Aktualizuje tytuł i/lub opis tekstu alternatywnego elementu page element.

Zapis JSON 
{
  "objectId": string,
  "title": string,
  "description": string
}
Pola
objectId

string

Identyfikator obiektu elementu strony, do którego zastosowano aktualizacje.

title

string

Zaktualizowany tytuł tekstu alternatywnego elementu strony. Jeśli ta opcja nie jest ustawiona, zachowana zostanie dotychczasowa wartość. Tytuł jest widoczny dla czytników ekranu i innych interfejsów ułatwień dostępu. Używaj tylko wartości czytelnych dla człowieka, które są powiązane z zawartością elementu strony.

description

string

Zaktualizowany tekst alternatywny elementu strony. Jeśli ta opcja nie jest ustawiona, zachowana zostanie dotychczasowa wartość. Opis jest dostępny dla czytników ekranu i innych interfejsów ułatwień dostępu. Używaj tylko wartości czytelnych dla człowieka, które są powiązane z zawartością elementu strony.

ReplaceImageRequest

Zastępuje istniejący obraz nowym.

Zastąpienie obrazu powoduje usunięcie niektórych elementówimage effectsz dotychczasowego obrazu.

Zapis JSON 
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "url": string
  // End of mutually exclusive fields.
}
Pola
imageObjectId

string

Identyfikator istniejącego obrazu, który zostanie zastąpiony. Identyfikator można pobrać z odpowiedzi na żądanie GET.

imageReplaceMethod

enum (ImageReplaceMethod)

Metoda zastępowania.

Rodzaj źródła obrazu. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
url

string

Adres URL obrazu.

Obraz jest pobierany raz w momencie wstawienia, a jego kopia jest przechowywana do wyświetlania w prezentacji. Obrazy muszą mieć rozmiar mniejszy niż 50 MB, nie mogą mieć więcej niż 25 megapikseli i muszą być w formacie PNG, JPEG lub GIF.

Podany adres URL nie może być dłuższy niż 2 KB. Adres URL jest zapisywany z obrazem i udostępniany w polu Image.source_url.

Koniec pól wykluczających się nawzajem.

UpdateSlidePropertiesRequest

Aktualizuje właściwości slajdu.

Zapis JSON 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
Pola
objectId

string

Identyfikator obiektu slajdu, do którego zastosowano aktualizację.

slideProperties

object (SlideProperties)

Właściwości slajdu do zaktualizowania.

fields

string (FieldMask format)

Pola, które należy zaktualizować.

Musisz określić co najmniej 1 pole. Element główny „slideProperties” jest domyślny i nie należy go określać. Pojedynczy znak "*" może być używany jako skrót do wyświetlania wszystkich pól.

Aby na przykład zaktualizować informację o tym, czy slajd jest pomijany, ustaw wartość fields na "isSkipped".

Aby zresetować usługę do wartości domyślnej, uwzględnij nazwę pola w masce pola, ale pozostaw samo pole nieustawione.

UpdatePageElementsZOrderRequest

Aktualizuje kolejność nakładania elementów strony. Kolejność Z to kolejność elementów na stronie od tyłu do przodu. Element strony z przodu może zasłaniać elementy znajdujące się za nim.

Zapis JSON 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
Pola
pageElementObjectIds[]

string

Identyfikatory obiektów elementów strony do zaktualizowania.

Wszystkie elementy strony muszą znajdować się na tej samej stronie i nie mogą być zgrupowane.

operation

enum (ZOrderOperation)

Operacja kolejności Z do zastosowania na elementach strony.

Podczas stosowania operacji na wielu elementach strony zachowywane są względne kolejności Z tych elementów przed operacją.

ZOrderOperation

Operacja aktualizowania kolejności elementu strony.

Wartości w polu enum
Z_ORDER_OPERATION_UNSPECIFIED Nieokreślona operacja.
BRING_TO_FRONT Przesuwa elementy strony na wierzch.
BRING_FORWARD Przesuwa elementy strony o jeden element do przodu względem elementu znajdującego się najbardziej z przodu w określonych elementach strony.
SEND_BACKWARD Przesuwa elementy strony o jeden element do tyłu względem elementu znajdującego się najbardziej z tyłu w określonych elementach strony.
SEND_TO_BACK Przesuwa elementy strony na spód strony.

UpdateLineCategoryRequest

Aktualizuje kategorię line.

Zapis JSON 
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
Pola
objectId

string

Identyfikator obiektu wiersza, do którego zastosowano aktualizację.

Zaktualizować można tylko wiersz z symbolem category oznaczającym, że jest to „łącznik”.

Po zaktualizowaniu kategorii linia może zostać przekierowana.

lineCategory

enum (LineCategory)

Kategoria wiersza, na którą chcesz zmienić kategorię.

Dokładna line type zależy od kategorii, do której chcesz przejść, i od sposobu, w jaki jest ona kierowana, aby połączyć się z innymi elementami strony.

RerouteLineRequest

Przekierowuje line, tak aby łączyło się z 2 najbliższymi punktami połączenia na połączonych elementach strony.

Zapis JSON 
{
  "objectId": string
}
Pola
objectId

string

Identyfikator obiektu linii do zmiany trasy.

Przekierować można tylko linię z symbolem category, który oznacza, że jest to „łącznik”. Początek i koniec linii muszą znajdować się na różnych elementach strony.

InsertCommentRequest

Wstawia do prezentacji element CommentThread.

Zapis JSON 
{
  "content": string,
  "assigneeEmailAddress": string,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "objectId": string,
  "shapeTextAnchor": {
    object (ShapeTextAnchor)
  },
  "tableCellTextAnchor": {
    object (TableCellTextAnchor)
  },
  "tableAnchor": {
    object (TableAnchor)
  }
  // End of mutually exclusive fields.
}
Pola
content

string

Tekst komentarza w postaci zwykłego tekstu.

Tekst będzie traktowany podobnie jak komentarze utworzone w edytorze Prezentacji. Będzie działać podobnie w przypadku formatowania, powiadomień itp.

To pole nie może być puste i nie może przekraczać 2048 jednostek kodu UTF-8.

assigneeEmailAddress

string

Opcjonalnie. Adres e-mail osoby przypisanej do komentarza.

Aby komentarz nie był przypisany, pozostaw to pole puste.

Nie może przekraczać 2048 jednostek kodu UTF-8.

Miejsce w prezentacji, z którym jest powiązany komentarz. Poniżej znajduje się lista pól, które wykluczają się nawzajem. W odpowiedzi zostanie ustawione co najwyżej jedno z tych pól:
objectId

string

Identyfikator obiektu Page lub PageElement powiązanego z tym komentarzem. Jeśli określony identyfikator objectId jest Group, komentarz zostanie przypięty do maksymalnie 100 elementów podrzędnych grupy, które nie są grupami.

shapeTextAnchor

object (ShapeTextAnchor)

Przypina komentarz do określonego zakresu tekstu w elemencie Shape.

tableCellTextAnchor

object (TableCellTextAnchor)

Zakotwicza komentarz w określonym zakresie tekstu w jednej komórce w Table.

tableAnchor

object (TableAnchor)

Przypina komentarz do określonego zakresu komórek w Table.

Koniec pól wykluczających się nawzajem.

ShapeTextAnchor

Kotwica do określonego zakresu tekstu w Shape's text.

Aby wstawić komentarze do notatek prelegenta, użyj elementu ShapeTextAnchor z identyfikatorem obiektu speaker notes.

Zapis JSON 
{
  "objectId": string,
  "textRange": {
    object (Range)
  }
}
Pola
objectId

string

Identyfikator obiektu elementu strony zawierającego tekst.

textRange

object (Range)

Zakres tekstu kotwicy.

TableCellTextAnchor

Kotwica do określonego zakresu tekstu w elemencie TableCell 's TextElement.

Zapis JSON 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Pola
objectId

string

Identyfikator obiektu tabeli zawierającej komórkę.

cellLocation

object (TableCellLocation)

Lokalizacja komórki w tabeli.

textRange

object (Range)

Zakres tekstu kotwicy.

TableAnchor

Punkt zakotwiczenia w określonym zakresie komórek w Table. Służy do przypisywania komentarza do całego tekstu w każdej komórce w zakresie w tabeli.

Zapis JSON 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Pola
objectId

string

Identyfikator obiektu tabeli.

tableRange

object (TableRange)

Zakres komórek w tabeli, do którego ma być zastosowany punkt zakotwiczenia. Jeśli ten parametr zostanie pominięty, jako punkt odniesienia zostaną użyte wszystkie komórki w tabeli.

AddCommentReplyRequest

Wstawia odpowiedź Post do elementu CommentThread.

Zapis JSON 
{
  "commentId": string,
  "post": {
    object (Post)
  }
}
Pola
commentId

string

Identyfikator CommentThread , do którego chcesz dodać odpowiedź.

post

object (Post)

Post reprezentujący odpowiedź.

UpdateCommentPostRequest

Aktualizuje Post w CommentThread.

Zwraca błąd 400 (Nieprawidłowe żądanie), jeśli:

  • Użytkownik wysyłający prośbę nie jest autorem posta.

  • W tym samym BatchUpdatePresentationRequest znajduje się wiele elementów UpdateCommentPostRequest dotyczących tego samego postId.

Zapis JSON 
{
  "commentId": string,
  "postId": string,
  "content": string
}
Pola
commentId

string

Identyfikator CommentThread, do którego należy post.

postId

string

Identyfikator aktualizowanego posta.

content

string

Nowy tekst komentarza w formie zwykłego tekstu.

Tekst będzie traktowany podobnie jak komentarze utworzone w edytorze Prezentacji. Będzie działać podobnie w przypadku formatowania, powiadomień itp.

To pole nie może być puste i nie może przekraczać 2048 jednostek kodu UTF-8.

DeleteCommentRequest

Usuwa CommentThread.

Zwraca błąd 400 (Nieprawidłowe żądanie), jeśli użytkownik wysyłający żądanie nie jest autorem headPost.

Zapis JSON 
{
  "commentId": string
}
Pola
commentId

string

Identyfikator CommentThread, który jest usuwany.

DeleteCommentReplyRequest

Usuwa odpowiedź Post z CommentThread.

Zwraca błąd 400 (Nieprawidłowe żądanie), jeśli:

Zapis JSON 
{
  "commentId": string,
  "postId": string
}
Pola
commentId

string

Identyfikator CommentThread, do którego należy post.

postId

string

Identyfikator odpowiedziPost, która ma zostać usunięta.