Запрос
Единственный тип обновления, применимый к презентации.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
kind поля Союза. Тип обновления. Требуется ровно одно поле. kind может быть только одним из следующих: | |
createSlide | Создает новый слайд. |
createShape | Создает новую форму. |
createTable | Создает новую таблицу. |
insertText | Вставляет текст в ячейку фигуры или таблицы. |
insertTableRows | Вставляет строки в таблицу. |
insertTableColumns | Вставляет столбцы в таблицу. |
deleteTableRow | Удаляет строку из таблицы. |
deleteTableColumn | Удаляет столбец из таблицы. |
replaceAllText | Заменяет все экземпляры указанного текста. |
deleteObject | Удаляет страницу или элемент страницы из презентации. |
updatePageElementTransform | Обновляет преобразование элемента страницы. |
updateSlidesPosition | Обновляет положение набора слайдов в презентации. |
deleteText | Удаляет текст из фигуры или ячейки таблицы. |
createImage | Создает изображение. |
createVideo | Создает видео. |
createSheetsChart | Создает встроенную диаграмму Google Sheets. |
createLine | Создает линию. |
refreshSheetsChart | Обновляет диаграмму Google Таблиц. |
updateShapeProperties | Обновляет свойства |
updateImageProperties | Обновляет свойства |
updateVideoProperties | Обновляет свойства |
updatePageProperties | Обновляет свойства |
updateTableCellProperties | Обновляет свойства |
updateLineProperties | Обновляет свойства |
createParagraphBullets | Создает маркеры для абзацев. |
replaceAllShapesWithImage | Заменяет все фигуры, соответствующие некоторым критериям, изображением. |
duplicateObject | Дублирует элемент слайда или страницы. |
updateTextStyle | |
replaceAllShapesWithSheetsChart | Заменяет все фигуры, соответствующие некоторым критериям, диаграммой Google Таблиц. |
deleteParagraphBullets | Удаляет маркеры из абзацев. |
updateParagraphStyle | |
updateTableBorderProperties | Обновляет свойства границ таблицы в |
updateTableColumnProperties | Обновляет свойства столбца |
updateTableRowProperties | Обновляет свойства строки |
mergeTableCells | Объединяет ячейки в |
unmergeTableCells | Разъединяет ячейки в |
groupObjects | Группирует объекты, например элементы страницы. |
ungroupObjects | Разгруппирует объекты, например |
updatePageElementAltText | Обновляет заголовок и/или описание |
replaceImage | Заменяет существующее изображение новым изображением. |
updateSlideProperties | Обновляет свойства слайда |
updatePageElementsZOrder | Обновляет Z-порядок |
updateLineCategory | Обновляет категорию |
rerouteLine | Перенаправляет |
Создать запрос слайда
Создает слайд.
JSON-представление |
---|
{ "objectId": string, "insertionIndex": integer, "slideLayoutReference": { object ( |
Поля | |
---|---|
objectId | Идентификатор объекта, предоставленный пользователем. Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению Если вы не укажете идентификатор, будет создан уникальный идентификатор. |
insertionIndex | Необязательный индекс, отсчитываемый от нуля, указывающий, куда вставить слайды. Если вы не укажете индекс, слайд будет создан в конце. |
slideLayoutReference | Ссылка на макет слайда, который необходимо вставить, на основе текущего мастера , который является одним из следующих:
Если LayoutReference не найден в текущем мастере, возвращается ошибка 400 неверного запроса. Если вы не укажете ссылку на макет, слайд будет использовать предопределенный макет |
placeholderIdMappings[] | Необязательный список сопоставлений идентификаторов объектов из |
Справочник по макету
Справочник по макету слайда. Это может относиться либо к:
- Предопределенный макет
- Один из макетов в презентации.
JSON-представление |
---|
{ // Union field |
Поля | |
---|---|
kind поля Союза. Тип LayoutReference. kind может быть только одним из следующих: | |
predefinedLayout | Предопределенный макет. |
layoutId | Идентификатор макета: идентификатор объекта одного из макетов в презентации. |
Предопределенный макет
Предопределенные типы макетов. Это часто встречающиеся макеты в презентациях. Однако нет никакой гарантии, что эти макеты присутствуют в текущем мастер-файле, поскольку они могли быть удалены или не являться частью используемой темы. Кроме того, заполнители в каждом макете могли быть изменены.
Перечисления | |
---|---|
PREDEFINED_LAYOUT_UNSPECIFIED | Неопределенная планировка. |
BLANK | Пустой макет, без заполнителей. |
CAPTION_ONLY | Макет с надписью внизу. |
TITLE | Макет с заголовком и подзаголовком. |
TITLE_AND_BODY | Макет с заголовком и телом. |
TITLE_AND_TWO_COLUMNS | Макет с заголовком и двумя столбцами. |
TITLE_ONLY | Макет только с заголовком. |
SECTION_HEADER | Макет с названием раздела. |
SECTION_TITLE_AND_DESCRIPTION | Макет с заголовком и подзаголовком с одной стороны и описанием с другой. |
ONE_COLUMN_TEXT | Макет с одним заголовком и одним текстом, расположенными в одном столбце. |
MAIN_POINT | Макет с основной точкой. |
BIG_NUMBER | Макет с крупным заголовком. |
МакетЗаполнительIdСопоставление
Указанное пользователем сопоставление идентификаторов для заполнителя, который будет создан на слайде из указанного макета.
JSON-представление |
---|
{ "objectId": string, // Union field |
Поля | |
---|---|
objectId | Предоставляемый пользователем идентификатор объекта для указанного выше заполнителя, который будет создан на слайде. Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению Если вы не укажете идентификатор, будет создан уникальный идентификатор. |
kind поля Союза. Тип для идентификации заполнителя в макете. kind может быть только одним из следующих: | |
layoutPlaceholder | Заполнитель макета, который будет применен к слайду. Нужны только |
layoutPlaceholderObjectId | Идентификатор объекта заполнителя в макете, который будет применен к слайду. |
CreateShapeRequest
Создает новую форму.
JSON-представление |
---|
{ "objectId": string, "elementProperties": { object ( |
Поля | |
---|---|
objectId | Идентификатор объекта, предоставленный пользователем. Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению |
elementProperties | Свойства элемента для фигуры. |
shapeType | Тип фигуры. |
Свойства элемента страницы
Общие свойства элемента страницы.
Примечание. Когда вы изначально создаете PageElement
, API может изменить значения size
и transform
, но визуальный размер останется неизменным.
JSON-представление |
---|
{ "pageObjectId": string, "size": { object ( |
Поля | |
---|---|
pageObjectId | Идентификатор объекта страницы, на которой расположен элемент. |
size | Размер элемента. |
transform | Преобразование элемента. |
CreateTableRequest
Создает новую таблицу.
JSON-представление |
---|
{
"objectId": string,
"elementProperties": {
object ( |
Поля | |
---|---|
objectId | Идентификатор объекта, предоставленный пользователем. Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению Если вы не укажете идентификатор, будет создан уникальный идентификатор. |
elementProperties | Свойства элемента таблицы. Таблица будет создана в указанном размере с учетом минимального размера. Если размер не указан, размер таблицы будет изменен автоматически. Преобразования таблицы должны иметь масштаб 1 и не содержать компонентов сдвига. Если преобразование не указано, таблица будет центрирована на странице. |
rows | Количество строк в таблице. |
columns | Количество столбцов в таблице. |
Вставитьтекстовый запрос
Вставляет текст в фигуру или ячейку таблицы.
JSON-представление |
---|
{
"objectId": string,
"cellLocation": {
object ( |
Поля | |
---|---|
objectId | Идентификатор объекта фигуры или таблицы, в которую будет вставлен текст. |
cellLocation | Необязательное расположение ячейки таблицы, если текст должен быть вставлен в ячейку таблицы. Если присутствует, objectId должен ссылаться на таблицу. |
text | Текст, который необходимо вставить. Вставка символа новой строки неявно создаст новый Стили текста для вставленного текста будут определяться автоматически, как правило, с сохранением стиля соседнего текста. В большинстве случаев текст будет добавлен в Некоторые управляющие символы (U+0000-U+0008, U+000C-U+001F) и символы из области частного использования Unicode Basic Multilingual Plane (U+E000-U+F8FF) будут удалены из вставленного текста. |
insertionIndex | Индекс, в который будет вставлен текст, в единицах кода Юникода, на основе индексов Индекс начинается с нуля и вычисляется с начала строки. Индекс можно настроить, чтобы предотвратить вставки внутри кластеров графем Юникода. В этих случаях текст будет вставлен сразу после кластера графем. |
Инсертаблеровсреквест
Вставляет строки в таблицу.
JSON-представление |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
Поля | |
---|---|
tableObjectId | Таблица, в которую нужно вставить строки. |
cellLocation | Местоположение ячейки ссылочной таблицы, из которой будут вставлены строки. Новая строка будет вставлена выше (или ниже) строки, в которой находится ссылочная ячейка. Если эталонная ячейка является объединенной ячейкой, новая строка будет вставлена над (или под) объединенной ячейкой. |
insertBelow | Вставлять ли новые строки ниже местоположения ссылочной ячейки.
|
number | Количество строк, которые необходимо вставить. Максимум 20 за запрос. |
Инсертаблеколумнсреквест
Вставляет столбцы в таблицу.
Размер других столбцов таблицы будет изменен в соответствии с новым столбцом.
JSON-представление |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
Поля | |
---|---|
tableObjectId | Таблица, в которую нужно вставить столбцы. |
cellLocation | Местоположение ячейки ссылочной таблицы, из которой будут вставлены столбцы. Новый столбец будет вставлен слева (или справа) от столбца, в котором находится ссылочная ячейка. Если эталонная ячейка является объединенной ячейкой, новый столбец будет вставлен слева (или справа) от объединенной ячейки. |
insertRight | Вставлять ли новые столбцы справа от местоположения ссылочной ячейки.
|
number | Количество столбцов, которые необходимо вставить. Максимум 20 за запрос. |
Удалитьтаблероврекуест
Удаляет строку из таблицы.
JSON-представление |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
Поля | |
---|---|
tableObjectId | Таблица, из которой нужно удалить строки. |
cellLocation | Местоположение ячейки ссылочной таблицы, из которой будет удалена строка. Строка, охватываемая этой ячейкой, будет удалена. Если это объединенная ячейка, несколько строк будут удалены. Если после удаления в таблице не останется ни одной строки, будет удалена вся таблица. |
Удалитьтаблеколонквест
Удаляет столбец из таблицы.
JSON-представление |
---|
{
"tableObjectId": string,
"cellLocation": {
object ( |
Поля | |
---|---|
tableObjectId | Таблица, из которой удаляются столбцы. |
cellLocation | Местоположение ячейки ссылочной таблицы, из которой будет удален столбец. Столбец, охватываемый этой ячейкой, будет удален. Если это объединенная ячейка, несколько столбцов будут удалены. Если после удаления в таблице не осталось ни одного столбца, удаляется вся таблица. |
ЗаменитьAllTextRequest
Заменяет все экземпляры текста, соответствующие критерию, на replace text
.
JSON-представление |
---|
{ "replaceText": string, "pageObjectIds": [ string ], // Union field |
Поля | |
---|---|
replaceText | Текст, который заменит совпавший текст. |
pageObjectIds[] | Если не пусто, ограничивает совпадения элементами страницы только на заданных страницах. Возвращает ошибку 400 неверного запроса, если указан идентификатор объекта страницы |
criteria поля Союза. Критерии, используемые для сопоставления заменяемого текста. criteria может быть только один из следующих: | |
containsText | Находит текст в фигуре, соответствующей этой подстроке. |
ПодстрокаMatchCriteria
Критерий, соответствующий определенной строке текста в фигуре или таблице.
JSON-представление |
---|
{ "text": string, "matchCase": boolean, "searchByRegex": boolean } |
Поля | |
---|---|
text | Текст для поиска в фигуре или таблице. |
matchCase | Указывает, должен ли поиск учитывать регистр:
|
searchByRegex | Необязательный. Значение true, если искомое значение следует рассматривать как регулярное выражение. Любые обратные косые черты в шаблоне следует экранировать.
|
УдалитьОбъектЗапрос
Удаляет объект ( pages
или page elements
) из презентации.
JSON-представление |
---|
{ "objectId": string } |
Поля | |
---|---|
objectId | Идентификатор объекта страницы или элемента страницы, который необходимо удалить. Если после операции удаления Если в макете удаляется заполнитель, все пустые наследуемые заполнители также удаляются. |
UpdatePageElementTransformRequest
Обновляет преобразование элемента страницы.
Обновление преобразования группы изменит абсолютное преобразование элементов страницы в этой группе, что может изменить их внешний вид. Дополнительные сведения см. в документации по PageElement.transform
.
JSON-представление |
---|
{ "objectId": string, "transform": { object ( |
Поля | |
---|---|
objectId | Идентификатор объекта обновляемого элемента страницы. |
transform | Входная матрица преобразования, используемая для обновления элемента страницы. |
applyMode | Режим применения обновления преобразования. |
Режим применения
Режимы применения обновления преобразования.
Перечисления | |
---|---|
APPLY_MODE_UNSPECIFIED | Неопределенный режим. |
RELATIVE | Применяет новую матрицу AffineTransform к существующей и заменяет существующую результирующей конкатенацией. |
ABSOLUTE | Заменяет существующую матрицу AffineTransform новой. |
Обновление слайдов позиции запроса
Обновляет положение слайдов в презентации.
JSON-представление |
---|
{ "slideObjectIds": [ string ], "insertionIndex": integer } |
Поля | |
---|---|
slideObjectIds[] | Идентификаторы слайдов презентации, которые следует переместить. Слайды в этом списке должны быть в существующем порядке презентации, без дубликатов. |
insertionIndex | Индекс, в который должны быть вставлены слайды, основан на расположении слайдов до перемещения. Должно быть от нуля до количества слайдов в презентации включительно. |
Удалитьтекстовый запрос
Удаляет текст из фигуры или ячейки таблицы.
JSON-представление |
---|
{ "objectId": string, "cellLocation": { object ( |
Поля | |
---|---|
objectId | Идентификатор объекта фигуры или таблицы, из которой будет удален текст. |
cellLocation | Необязательное расположение ячейки таблицы, если текст должен быть удален из ячейки таблицы. Если присутствует, objectId должен ссылаться на таблицу. |
textRange | Диапазон удаляемого текста на основе индексов В конце текста фигуры или ячейки таблицы всегда есть неявный символ новой строки, который невозможно удалить. Удаление текста, пересекающего границу абзаца, может привести к изменению стилей и списков абзацев при объединении двух абзацев. Диапазоны, включающие только одну кодовую единицу суррогатной пары, расширяются за счет включения обеих кодовых единиц. |
Диапазон
Указывает непрерывный диапазон индексированной коллекции, например символы в тексте.
JSON-представление |
---|
{
"startIndex": integer,
"endIndex": integer,
"type": enum ( |
Поля | |
---|---|
startIndex | Необязательный индекс начала коллекции, отсчитываемый от нуля. Требуется для диапазонов |
endIndex | Необязательный индекс конца коллекции, отсчитываемый от нуля. Требуется для диапазонов |
type | Тип диапазона. |
Тип
Типы диапазонов.
Перечисления | |
---|---|
RANGE_TYPE_UNSPECIFIED | Неопределенный тип диапазона. Это значение нельзя использовать. |
FIXED_RANGE | Фиксированный диапазон. Необходимо указать как startIndex , так и endIndex . |
FROM_START_INDEX | Начинает диапазон с startIndex и продолжает до конца коллекции. endIndex не может быть указан. |
ALL | Устанавливает диапазон на всю длину коллекции. Не следует указывать как startIndex , так и endIndex . |
CreateImageRequest
Создает изображение.
JSON-представление |
---|
{ "objectId": string, "elementProperties": { object ( |
Поля | |
---|---|
objectId | Идентификатор объекта, предоставленный пользователем. Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению Если вы не укажете идентификатор, будет создан уникальный идентификатор. |
elementProperties | Свойства элемента изображения. Если соотношение сторон предоставленного размера не соответствует соотношению сторон изображения, изображение масштабируется и центрируется по размеру, чтобы сохранить соотношение сторон. Предоставленное преобразование применяется после этой операции. Свойство Свойство |
Поле объединения image_source . Тип источника изображения. image_source может быть только одним из следующих: | |
url | URL-адрес изображения. Изображение извлекается один раз во время вставки, а его копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в одном из форматов PNG, JPEG или GIF. Предоставленный URL-адрес должен быть общедоступным и иметь длину до 2 КБ. URL-адрес сохраняется вместе с изображением и отображается через поле |
Создать видеозапрос
Создает видео.
ПРИМЕЧАНИЕ. Для создания видео с Google Диска необходимо, чтобы запрашивающее приложение имело хотя бы одну из областей OAuth диск, диск.readonly или диск.файл.
JSON-представление |
---|
{
"objectId": string,
"elementProperties": {
object ( |