Requests

Запрос

Единственный тип обновления, применимый к презентации.

JSON-представление
{

  // Union field kind can be only one of the following:
  "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)
  }
  // End of list of possible types for union field kind.
}
Поля
kind поля Союза. Тип обновления. Требуется ровно одно поле. kind может быть только одним из следующих:
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 )

Создает встроенную диаграмму Google Sheets.

createLine

object ( CreateLineRequest )

Создает линию.

refreshSheetsChart

object ( RefreshSheetsChartRequest )

Обновляет диаграмму Google Таблиц.

updateShapeProperties

object ( UpdateShapePropertiesRequest )

Обновляет свойства Shape .

updateImageProperties

object ( UpdateImagePropertiesRequest )

Обновляет свойства Image .

updateVideoProperties

object ( UpdateVideoPropertiesRequest )

Обновляет свойства Video .

updatePageProperties

object ( UpdatePagePropertiesRequest )

Обновляет свойства Page .

updateTableCellProperties

object ( UpdateTableCellPropertiesRequest )

Обновляет свойства TableCell .

updateLineProperties

object ( UpdateLinePropertiesRequest )

Обновляет свойства Line .

createParagraphBullets

object ( CreateParagraphBulletsRequest )

Создает маркеры для абзацев.

replaceAllShapesWithImage

object ( ReplaceAllShapesWithImageRequest )

Заменяет все фигуры, соответствующие некоторым критериям, изображением.

duplicateObject

object ( DuplicateObjectRequest )

Дублирует элемент слайда или страницы.

updateTextStyle

object ( UpdateTextStyleRequest )

Обновляет стиль текста внутри Shape или Table .

replaceAllShapesWithSheetsChart

object ( ReplaceAllShapesWithSheetsChartRequest )

Заменяет все фигуры, соответствующие некоторым критериям, диаграммой Google Таблиц.

deleteParagraphBullets

object ( DeleteParagraphBulletsRequest )

Удаляет маркеры из абзацев.

updateParagraphStyle

object ( UpdateParagraphStyleRequest )

Обновляет стиль абзацев внутри Shape или Table .

updateTableBorderProperties

object ( UpdateTableBorderPropertiesRequest )

Обновляет свойства границ таблицы в Table .

updateTableColumnProperties

object ( UpdateTableColumnPropertiesRequest )

Обновляет свойства столбца Table .

updateTableRowProperties

object ( UpdateTableRowPropertiesRequest )

Обновляет свойства строки Table .

mergeTableCells

object ( MergeTableCellsRequest )

Объединяет ячейки в Table .

unmergeTableCells

object ( UnmergeTableCellsRequest )

Разъединяет ячейки в Table .

groupObjects

object ( GroupObjectsRequest )

Группирует объекты, например элементы страницы.

ungroupObjects

object ( UngroupObjectsRequest )

Разгруппирует объекты, например groups .

updatePageElementAltText

object ( UpdatePageElementAltTextRequest )

Обновляет заголовок и/или описание page element .

replaceImage

object ( ReplaceImageRequest )

Заменяет существующее изображение новым изображением.

updateSlideProperties

object ( UpdateSlidePropertiesRequest )

Обновляет свойства слайда

updatePageElementsZOrder

object ( UpdatePageElementsZOrderRequest )

Обновляет Z-порядок page elements .

updateLineCategory

object ( UpdateLineCategoryRequest )

Обновляет категорию line .

rerouteLine

object ( RerouteLineRequest )

Перенаправляет line так, чтобы она соединялась в двух ближайших местах соединения на связанных элементах страницы.

Создать запрос слайда

Создает слайд.

JSON-представление
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
Поля
objectId

string

Идентификатор объекта, предоставленный пользователем.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина идентификатора должна составлять от 5 до 50 символов включительно.

Если вы не укажете идентификатор, будет создан уникальный идентификатор.

insertionIndex

integer

Необязательный индекс, отсчитываемый от нуля, указывающий, куда вставить слайды.

Если вы не укажете индекс, слайд будет создан в конце.

slideLayoutReference

object ( LayoutReference )

Ссылка на макет слайда, который необходимо вставить, на основе текущего мастера , который является одним из следующих:

  • Мастер предыдущего индекса слайдов.
  • Мастер первого слайда, если InsertionIndex равен нулю.
  • Первый мастер в презентации, если нет слайдов.

Если LayoutReference не найден в текущем мастер-файле, возвращается ошибка 400 неверного запроса.

Если вы не укажете ссылку на макет, слайд будет использовать предопределенный макет BLANK .

placeholderIdMappings[]

object ( LayoutPlaceholderIdMapping )

Необязательный список сопоставлений идентификаторов объектов из placeholder (ей) в макете с заполнителями, созданными на слайде из указанного макета. Можно использовать только в том случае, если указан slideLayoutReference .

Справочник по макету

Справочник по макету слайда. Это может относиться либо к:

  • Предопределенный макет
  • Один из макетов в презентации.
JSON-представление
{

  // Union field kind can be only one of the following:
  "predefinedLayout": enum (PredefinedLayout),
  "layoutId": string
  // End of list of possible types for union field kind.
}
Поля
kind поля Союза. Тип LayoutReference. kind может быть только одним из следующих:
predefinedLayout

enum ( PredefinedLayout )

Предопределенный макет.

layoutId

string

Идентификатор макета: идентификатор объекта одного из макетов в презентации.

Предопределенный макет

Предопределенные типы макетов. Это часто встречающиеся макеты в презентациях. Однако нет никакой гарантии, что эти макеты присутствуют в текущем мастер-файле, поскольку они могли быть удалены или не являться частью используемой темы. Кроме того, заполнители в каждом макете могли быть изменены.

Перечисления
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 kind can be only one of the following:
  "layoutPlaceholder": {
    object (Placeholder)
  },
  "layoutPlaceholderObjectId": string
  // End of list of possible types for union field kind.
}
Поля
objectId

string

Предоставляемый пользователем идентификатор объекта для указанного выше заполнителя, который будет создан на слайде.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина идентификатора не должна быть меньше 5 или больше 50.

Если вы не укажете идентификатор, будет создан уникальный идентификатор.

kind поля Союза. Тип для идентификации заполнителя в макете. kind может быть только одним из следующих:
layoutPlaceholder

object ( Placeholder )

Заполнитель макета, который будет применен к слайду. Нужны только type и index . Например, предопределенный макет TITLE_AND_BODY обычно может иметь заполнитель TITLE с индексом 0 и заполнитель BODY с индексом 0.

layoutPlaceholderObjectId

string

Идентификатор объекта заполнителя в макете, который будет применен к слайду.

CreateShapeRequest

Создает новую форму.

JSON-представление
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
Поля
objectId

string

Идентификатор объекта, предоставленный пользователем.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина идентификатора не должна быть меньше 5 или больше 50. Если оно пустое, будет сгенерирован уникальный идентификатор.

elementProperties

object ( PageElementProperties )

Свойства элемента для фигуры.

shapeType

enum ( Type )

Тип фигуры.

Свойства элемента страницы

Общие свойства элемента страницы.

Примечание. Когда вы изначально создаете PageElement , API может изменить значения size и transform , но визуальный размер останется неизменным.

JSON-представление
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
Поля
pageObjectId

string

Идентификатор объекта страницы, на которой расположен элемент.

size

object ( Size )

Размер элемента.

transform

object ( AffineTransform )

Преобразование элемента.

CreateTableRequest

Создает новую таблицу.

JSON-представление
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
Поля
objectId

string

Идентификатор объекта, предоставленный пользователем.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина идентификатора не должна быть меньше 5 или больше 50.

Если вы не укажете идентификатор, будет создан уникальный идентификатор.

elementProperties

object ( PageElementProperties )

Свойства элемента таблицы.

Таблица будет создана в указанном размере с учетом минимального размера. Если размер не указан, размер таблицы будет изменен автоматически.

Преобразования таблицы должны иметь масштаб 1 и не содержать компонентов сдвига. Если преобразование не указано, таблица будет центрирована на странице.

rows

integer

Количество строк в таблице.

columns

integer

Количество столбцов в таблице.

Вставитьтекстовый запрос

Вставляет текст в фигуру или ячейку таблицы.

JSON-представление
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
Поля
objectId

string

Идентификатор объекта фигуры или таблицы, в которую будет вставлен текст.

cellLocation

object ( TableCellLocation )

Необязательное расположение ячейки таблицы, если текст должен быть вставлен в ячейку таблицы. Если присутствует, objectId должен ссылаться на таблицу.

text

string

Текст, который необходимо вставить.

Вставка символа новой строки неявно создаст новый ParagraphMarker по этому индексу. Стиль нового абзаца будет скопирован из абзаца с текущим индексом вставки, включая списки и маркеры.

Стили текста для вставленного текста будут определяться автоматически, как правило, с сохранением стиля соседнего текста. В большинстве случаев текст будет добавлен в TextRun , существующий по индексу вставки.

Некоторые управляющие символы (U+0000–U+0008, U+000C–U+001F) и символы из области частного использования базовой многоязычной плоскости Unicode (U+E000–U+F8FF) будут удалены из вставленного текста.

insertionIndex

integer

Индекс, в который будет вставлен текст, в единицах кода Юникода, на основе индексов TextElement .

Индекс начинается с нуля и вычисляется с начала строки. Индекс можно настроить, чтобы предотвратить вставки внутри кластеров графем Юникода. В этих случаях текст будет вставлен сразу после кластера графем.

Инсертаблеровсреквест

Вставляет строки в таблицу.

JSON-представление
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
Поля
tableObjectId

string

Таблица, в которую нужно вставить строки.

cellLocation

object ( TableCellLocation )

Местоположение ячейки ссылочной таблицы, из которой будут вставлены строки.

Новая строка будет вставлена ​​выше (или ниже) строки, в которой находится ссылочная ячейка. Если эталонная ячейка является объединенной ячейкой, новая строка будет вставлена ​​над (или под) объединенной ячейкой.

insertBelow

boolean

Вставлять ли новые строки ниже местоположения ссылочной ячейки.

  • True : вставить под ячейку.
  • False : вставить над ячейкой.
number

integer

Количество строк, которые необходимо вставить. Максимум 20 за запрос.

Инсертаблеколумнсреквест

Вставляет столбцы в таблицу.

Размер других столбцов таблицы будет изменен в соответствии с новым столбцом.

JSON-представление
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
Поля
tableObjectId

string

Таблица, в которую нужно вставить столбцы.

cellLocation

object ( TableCellLocation )

Местоположение ячейки ссылочной таблицы, из которой будут вставлены столбцы.

Новый столбец будет вставлен слева (или справа) от столбца, в котором находится ссылочная ячейка. Если эталонная ячейка является объединенной ячейкой, новый столбец будет вставлен слева (или справа) от объединенной ячейки.

insertRight

boolean

Вставлять ли новые столбцы справа от местоположения ссылочной ячейки.

  • True : вставить вправо.
  • False : вставить слева.
number

integer

Количество столбцов, которые необходимо вставить. Максимум 20 за запрос.

Удалитьтаблероврекуест

Удаляет строку из таблицы.

JSON-представление
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Поля
tableObjectId

string

Таблица, из которой удаляются строки.

cellLocation

object ( TableCellLocation )

Местоположение ячейки ссылочной таблицы, из которой будет удалена строка.

Строка, охватываемая этой ячейкой, будет удалена. Если это объединенная ячейка, несколько строк будут удалены. Если после этого удаления в таблице не останется ни одной строки, будет удалена вся таблица.

Удалитьтаблеколонквест

Удаляет столбец из таблицы.

JSON-представление
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
Поля
tableObjectId

string

Таблица, из которой удаляются столбцы.

cellLocation

object ( TableCellLocation )

Местоположение ячейки ссылочной таблицы, из которой будет удален столбец.

Столбец, охватываемый этой ячейкой, будет удален. Если это объединенная ячейка, несколько столбцов будут удалены. Если после удаления в таблице не осталось ни одного столбца, удаляется вся таблица.

ЗаменитьAllTextRequest

Заменяет все экземпляры текста, соответствующие критерию, на replace text .

JSON-представление
{
  "replaceText": string,
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.
}
Поля
replaceText

string

Текст, который заменит совпавший текст.

pageObjectIds[]

string

Если не пусто, ограничивает совпадения элементами страницы только на заданных страницах.

Возвращает ошибку 400 неверного запроса, если указан идентификатор объекта страницы notes master или если страница с этим идентификатором объекта не существует в презентации.

criteria союзного поля. Критерии, используемые для сопоставления текста для замены. criteria может быть только один из следующих:
containsText

object ( SubstringMatchCriteria )

Находит текст в фигуре, соответствующей этой подстроке.

ПодстрокаMatchCriteria

Критерий, соответствующий определенной строке текста в фигуре или таблице.

JSON-представление
{
  "text": string,
  "matchCase": boolean
}
Поля
text

string

Текст для поиска в фигуре или таблице.

matchCase

boolean

Указывает, должен ли поиск учитывать регистр:

  • True : поиск чувствителен к регистру.
  • False : поиск нечувствителен к регистру.

УдалитьОбъектЗапрос

Удаляет объект ( pages или page elements ) из презентации.

JSON-представление
{
  "objectId": string
}
Поля
objectId

string

Идентификатор объекта страницы или элемента страницы, который необходимо удалить.

Если после операции удаления group содержит только 1 элемент страницы или не содержит ни одного элемента страницы, группа также удаляется.

Если в макете удаляется заполнитель, все пустые наследуемые заполнители также удаляются.

UpdatePageElementTransformRequest

Обновляет преобразование элемента страницы.

Обновление преобразования группы изменит абсолютное преобразование элементов страницы в этой группе, что может изменить их внешний вид. Дополнительные сведения см. в документации по PageElement.transform .

JSON-представление
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
Поля
objectId

string

Идентификатор объекта обновляемого элемента страницы.

transform

object ( AffineTransform )

Входная матрица преобразования, используемая для обновления элемента страницы.

applyMode

enum ( ApplyMode )

Режим применения обновления преобразования.

Режим применения

Режимы применения обновления преобразования.

Перечисления
APPLY_MODE_UNSPECIFIED Неопределенный режим.
RELATIVE Применяет новую матрицу AffineTransform к существующей и заменяет существующую результирующей конкатенацией.
ABSOLUTE Заменяет существующую матрицу AffineTransform новой.

Обновление слайдов позиции запроса

Обновляет положение слайдов в презентации.

JSON-представление
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
Поля
slideObjectIds[]

string

Идентификаторы слайдов презентации, которые следует переместить. Слайды в этом списке должны быть в существующем порядке презентации, без дубликатов.

insertionIndex

integer

Индекс, в который должны быть вставлены слайды, основан на расположении слайдов до перемещения. Должно быть от нуля до количества слайдов в презентации включительно.

Удалитьтекстовый запрос

Удаляет текст из фигуры или ячейки таблицы.

JSON-представление
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Поля
objectId

string

Идентификатор объекта фигуры или таблицы, из которой будет удален текст.

cellLocation

object ( TableCellLocation )

Необязательное расположение ячейки таблицы, если текст должен быть удален из ячейки таблицы. Если присутствует, objectId должен ссылаться на таблицу.

textRange

object ( Range )

Диапазон удаляемого текста на основе индексов TextElement .

В конце текста фигуры или ячейки таблицы всегда есть неявный символ новой строки, который невозможно удалить. Range.Type.ALL будет использовать правильные границы, но необходимо соблюдать осторожность при указании явных границ для типов диапазонов FROM_START_INDEX и FIXED_RANGE . Например, если текст — «ABC», за которым следует неявный символ новой строки, то максимальное значение равно 2 для textRange.start_index и 3 для textRange.end_index .

Удаление текста, пересекающего границу абзаца, может привести к изменению стилей и списков абзацев при объединении двух абзацев.

Диапазоны, включающие только одну кодовую единицу суррогатной пары, расширяются за счет включения обеих кодовых единиц.

Диапазон

Указывает непрерывный диапазон индексированной коллекции, например символы в тексте.

JSON-представление
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
Поля
startIndex

integer

Необязательный индекс начала коллекции, отсчитываемый от нуля. Требуется для диапазонов FIXED_RANGE и FROM_START_INDEX .

endIndex

integer

Необязательный индекс конца коллекции, отсчитываемый от нуля. Требуется для диапазонов FIXED_RANGE .

type

enum ( Type )

Тип диапазона.

Тип

Типы диапазонов.

Перечисления
RANGE_TYPE_UNSPECIFIED Неопределенный тип диапазона. Это значение нельзя использовать.
FIXED_RANGE Фиксированный диапазон. Необходимо указать как startIndex , так и endIndex .
FROM_START_INDEX Начинает диапазон с startIndex и продолжает до конца коллекции. endIndex не может быть указан.
ALL Устанавливает диапазон на всю длину коллекции. Не следует указывать как startIndex , так и endIndex .

CreateImageRequest

Создает изображение.

JSON-представление
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Поля
objectId

string

Идентификатор объекта, предоставленный пользователем.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина идентификатора не должна быть меньше 5 или больше 50.

Если вы не укажете идентификатор, будет создан уникальный идентификатор.

elementProperties

object ( PageElementProperties )

Свойства элемента изображения.

Если соотношение сторон предоставленного размера не соответствует соотношению сторон изображения, изображение масштабируется и центрируется по размеру, чтобы сохранить соотношение сторон. Предоставленное преобразование применяется после этой операции.

Свойство PageElementProperties.size является необязательным. Если вы не укажете размер, используется размер изображения по умолчанию.

Свойство PageElementProperties.transform является необязательным. Если вы не укажете преобразование, изображение будет помещено в верхний левый угол страницы.

Поле объединения image_source . Тип источника изображения. image_source может быть только одним из следующих:
url

string

URL-адрес изображения.

Изображение извлекается один раз во время вставки, а его копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в одном из форматов PNG, JPEG или GIF.

Предоставленный URL-адрес должен быть общедоступным и иметь длину до 2 КБ. URL-адрес сохраняется вместе с изображением и отображается через поле Image.source_url .

Создать видеозапрос

Создает видео.

ПРИМЕЧАНИЕ. Для создания видео с Google Диска необходимо, чтобы запрашивающее приложение имело хотя бы одну из областей OAuth диск, диск.readonly или диск.файл.

JSON-представление
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
Поля
objectId

string

Идентификатор объекта, предоставленный пользователем.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина идентификатора не должна быть меньше 5 или больше 50.

Если вы не укажете идентификатор, будет создан уникальный идентификатор.

elementProperties

object ( PageElementProperties )

Свойства элемента для видео.

Свойство PageElementProperties.size является необязательным. Если вы не укажете размер, сервер выберет размер по умолчанию.

Свойство PageElementProperties.transform является необязательным. Преобразование не должно иметь компонентов сдвига. Если вы не укажете преобразование, видео будет размещено в верхнем левом углу страницы.

source

enum ( Source )

Источник видео.

id

string

Уникальный идентификатор источника видео для этого видео.

например, для видео YouTube https://www.youtube.com/watch?v=7U3axjORYZ0 идентификатор — 7U3axjORYZ0. Для видео с Google Диска https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q идентификатор — 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q.

Чтобы получить доступ к видеофайлу на Google Диске, вам может потребоваться добавить ключ ресурса в заголовок HTTP для подмножества старых файлов. Дополнительные сведения см. в разделе Доступ к файлам, доступным по ссылке, с помощью ключей ресурсов .

Запрос CreateSheetsChart

Создает встроенную диаграмму Google Sheets.

ПРИМЕЧАНИЕ. Для создания диаграммы требуется хотя бы одна из областей OAuth: электронные таблицы.readonly, электронные таблицы, диск.readonly, диск.файл или диск.

JSON-представление
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
Поля
objectId

string

Идентификатор объекта, предоставленный пользователем.

Если указано, идентификатор должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться со слова [a-zA-Z0-9_], за которым следует любое количество следующих символов [a-zA-Z0-9_-:]. Длина идентификатора не должна быть меньше 5 или больше 50. Если оно пустое, будет сгенерирован уникальный идентификатор.

elementProperties

object ( PageElementProperties )

Свойства элемента диаграммы.

Если соотношение сторон предоставленного размера не соответствует соотношению сторон диаграммы, диаграмма масштабируется и центрируется относительно размера, чтобы сохранить соотношение сторон. Предоставленное преобразование применяется после этой операции.

spreadsheetId

string

Идентификатор таблицы Google Sheets, содержащей диаграмму.

Возможно, вам придется добавить ключ ресурса в заголовок HTTP для подмножества старых файлов. Дополнительные сведения см. в разделе Доступ к файлам, доступным по ссылке, с помощью ключей ресурсов .

chartId

integer

Идентификатор конкретной диаграммы в электронной таблице Google Sheets.

linkingMode

enum ( LinkingMode )

Режим, в котором диаграмма связана с исходной электронной таблицей. Если не указано иное, диаграмма будет представлять собой изображение, на которое нет ссылки.

Режим связывания

Режим, в котором диаграмма связана с исходной электронной таблицей.

Перечисления
NOT_LINKED_IMAGE Диаграмма не связана с исходной таблицей и не может быть обновлена. Диаграмма, на которую нет ссылки, будет вставлена ​​как изображение.
LINKED Связывание диаграммы позволяет ее обновлять, и другие соавторы увидят ссылку на таблицу.

CreateLineRequest

Создает линию.

JSON-представление
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
Поля
objectId

string

Идентификатор объекта, предоставленный пользователем.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страницы в презентации. Идентификатор должен начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина идентификатора не должна быть меньше 5 или больше 50.

Если вы не укажете идентификатор, будет создан уникальный идентификатор.

elementProperties

object ( PageElementProperties )

Свойства элемента для линии.

lineCategory
(deprecated)

enum ( Category )

Категория создаваемой линии.

Устарело : вместо этого используйте category .

Точный line type определяется на основе категории и способа ее маршрутизации для подключения к другим элементам страницы.

Если вы укажете и category , и lineCategory , category будет иметь приоритет.

category

enum ( LineCategory )

Категория создаваемой линии.

Точный line type определяется на основе категории и способа ее маршрутизации для подключения к другим элементам страницы.

Если вы укажете и category , и lineCategory , category будет иметь приоритет.

Если вы не указываете значение для category , но указываете значение для lineCategory , то используется указанное значение lineCategory .

Если вы не укажете ни того, ни другого, то используется STRAIGHT .

Категория

Категории линий.

Перечисления
STRAIGHT Прямые соединители, включая прямой соединитель 1. Это категория по умолчанию, если она не указана.
BENT Изогнутые разъемы, включая изогнутые разъемы 2–5.
CURVED Изогнутые разъемы, включая изогнутые разъемы 2–5.

ОбновитьлистыДиаграммаЗапрос

Обновляет встроенную диаграмму Google Sheets, заменяя ее последней версией диаграммы из Google Sheets.

ПРИМЕЧАНИЕ. Для обновления диаграмм требуется хотя бы одна из областей: «spreadsheets.readonly», «endsheets», «drive.readonly» или «drive OAuth».

JSON-представление
{
  "objectId": string
}
Поля
objectId

string

Идентификатор объекта обновляемой диаграммы.

Запрос UpdateShapePropertiesRequest

Обновите свойства Shape .

JSON-представление
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта фигуры, к которой применяются обновления.

shapeProperties

object ( ShapeProperties )

Свойства фигуры, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые следует обновить.

Должно быть указано хотя бы одно поле. Корневой shapeProperties подразумевается и не должен указываться. Для обозначения каждого поля можно использовать одиночный символ "*" .

Например, чтобы обновить цвет сплошной заливки фона фигуры, установите для fields значение "shapeBackgroundFill.solidFill.color" .

Чтобы вернуть свойству значение по умолчанию, включите имя его поля в маску поля, но оставьте само поле незаданным.

Запрос свойств обновления изображения

Обновите свойства Image .

JSON-представление
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта изображения, к которому применяются обновления.

imageProperties

object ( ImageProperties )

Свойства изображения, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые следует обновить.

Должно быть указано хотя бы одно поле. Корневой imageProperties подразумевается и не должен указываться. Одиночный символ "*" может использоваться как сокращение для перечисления каждого поля.

Например, чтобы обновить цвет контура изображения, установите для fields значение "outline.outlineFill.solidFill.color" .

Чтобы вернуть свойству значение по умолчанию, включите имя его поля в маску поля, но оставьте само поле незаданным.

Обновление свойств видеозапрос

Обновите свойства Video .

JSON-представление
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта видео, к которому применяются обновления.

videoProperties

object ( VideoProperties )

Свойства видео, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые следует обновить.

Должно быть указано хотя бы одно поле. Корневой videoProperties подразумевается и не должен указываться. Одиночный символ "*" может использоваться как сокращение для перечисления каждого поля.

Например, чтобы обновить цвет контура видео, установите для fields значение "outline.outlineFill.solidFill.color" .

Чтобы вернуть свойству значение по умолчанию, включите имя его поля в маску поля, но оставьте само поле незаданным.

Обновление свойств страницыЗапрос

Обновляет свойства Page .

JSON-представление
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта страницы, к которой применяется обновление.

pageProperties

object ( PageProperties )

Свойства страницы, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые следует обновить.

Должно быть указано хотя бы одно поле. Корневой pageProperties подразумевается и не должен указываться. Одиночный символ "*" может использоваться как сокращение для перечисления каждого поля.

Например, чтобы обновить цвет сплошной заливки фона страницы, установите для fields значение "pageBackgroundFill.solidFill.color" .

Чтобы вернуть свойству значение по умолчанию, включите имя его поля в маску поля, но оставьте само поле незаданным.

UpdateTableCellPropertiesRequest

Обновите свойства TableCell .

JSON-представление
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "tableCellProperties": {
    object (TableCellProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта таблицы.

tableRange

object ( TableRange )

Диапазон таблицы, представляющий подмножество таблицы, к которой применяются обновления. Если диапазон таблицы не указан, обновления будут применяться ко всей таблице.

tableCellProperties

object ( TableCellProperties )

Свойства ячейки таблицы, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые следует обновить.

Должно быть указано хотя бы одно поле. Корневой tableCellProperties подразумевается и не должен указываться. Одиночный символ "*" может использоваться как сокращение для перечисления каждого поля.

Например, чтобы обновить цвет сплошной заливки фона ячейки таблицы, установите для fields значение "tableCellBackgroundFill.solidFill.color" .

Чтобы вернуть свойству значение по умолчанию, включите имя его поля в маску поля, но оставьте само поле незаданным.

ТаблицаДиапазон

Диапазон таблицы представляет собой ссылку на подмножество таблицы.

Важно отметить, что ячейки, указанные в диапазоне таблицы, не обязательно образуют прямоугольник. Например, предположим, что у нас есть таблица 3 x 3, в которой все ячейки последней строки объединены вместе. Таблица выглядит следующим образом:

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

Диапазон таблицы с местоположением = (0, 0), диапазоном строк = 3 и диапазоном столбцов = 2 определяет следующие ячейки:

 [ x ][ x ][   ]
 [ x ][ x ][   ]
 [ x    x    x ]
JSON-представление
{
  "location": {
    object (TableCellLocation)
  },
  "rowSpan": integer,
  "columnSpan": integer
}
Поля
location

object ( TableCellLocation )

Начальное местоположение диапазона таблицы.

rowSpan

integer

Диапазон строк диапазона таблицы.

columnSpan

integer

Диапазон столбцов диапазона таблицы.

Запрос UpdateLinePropertiesRequest

Обновляет свойства Line .

JSON-представление
{
  "objectId": string,
  "lineProperties": {
    object (LineProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта строки, к которой применяется обновление.

lineProperties

object ( LineProperties )

Свойства линии, которые необходимо обновить.

fields

string ( FieldMask format)

Поля, которые следует обновить.

Должно быть указано хотя бы одно поле. Корневой lineProperties подразумевается и не должен указываться. Для обозначения каждого поля можно использовать одиночный символ "*" .

Например, чтобы обновить цвет сплошной заливки линии, установите для fields значение "lineFill.solidFill.color" .

Чтобы вернуть свойству значение по умолчанию, включите имя его поля в маску поля, но оставьте само поле незаданным.

CreateParagraphBulletsRequest

Создает маркеры для всех абзацев, которые перекрываются с заданным диапазоном текстовых индексов.

Уровень вложенности каждого абзаца будет определяться путем подсчета табуляции перед каждым абзацем. Чтобы избежать лишнего пространства между маркером и соответствующим абзацем, эти ведущие табуляции удаляются по этому запросу. При этом могут измениться индексы частей текста.

Если абзац непосредственно перед обновляемыми абзацами находится в списке с соответствующим набором настроек, обновляемые абзацы добавляются к этому предыдущему списку.

JSON-представление
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  },
  "bulletPreset": enum (BulletGlyphPreset)
}
Поля
objectId

string

Идентификатор объекта фигуры или таблицы, содержащей текст, к которому нужно добавить маркеры.

cellLocation

object ( TableCellLocation )

Необязательное расположение ячейки таблицы, если изменяемый текст находится в ячейке таблицы. Если присутствует, objectId должен ссылаться на таблицу.

textRange

object ( Range )

Диапазон текста, к которому применяются стили маркеров, на основе индексов TextElement .

bulletPreset

enum ( BulletGlyphPreset )

Виды маркеров, которые будут использоваться. По умолчанию используется предустановка BULLET_DISC_CIRCLE_SQUARE .

ПуляГлифПресет

Предустановленные шаблоны маркеров для списков в тексте.

В этих шаблонах используются следующие типы маркеров:

  • ARROW : стрелка, соответствующая кодовой точке Unicode U+2794.
  • ARROW3D : стрелка с трехмерной заливкой, соответствующая кодовой точке Unicode U+27a2.
  • CHECKBOX : пустой квадрат, соответствующий кодовой точке Unicode U+274f.
  • CIRCLE : полый кружок, соответствующий кодовой точке Unicode U+25cb.
  • DIAMOND : сплошной ромб, соответствующий кодовой точке Unicode U+25c6.
  • DIAMONDX : ромб с буквой «x», соответствующий кодовой точке Unicode U+2756.
  • HOLLOWDIAMOND : полый ромб, соответствующий кодовой точке Unicode U+25c7.
  • DISC : сплошной круг, соответствующий кодовой точке Unicode U+25cf.
  • SQUARE : сплошной квадрат, соответствующий кодовой точке Unicode U+25a0.
  • STAR : звездочка, соответствующая кодовой точке Unicode U+2605.
  • ALPHA : строчная буква, например «a», «b» или «c».
  • UPPERALPHA : Прописная буква, например «A», «B» или «C».
  • DIGIT : число, например «1», «2» или «3».
  • ZERODIGIT : число, в котором однозначные числа начинаются с нуля, например «01», «02» или «03». Числа, состоящие более чем из одной цифры, не имеют префикса нуля.
  • ROMAN : римская цифра в нижнем регистре, например «i», «ii» или «iii».
  • UPPERROMAN : римская цифра в верхнем регистре, например «I», «II» или «III».
  • LEFTTRIANGLE : треугольник, направленный влево, соответствующий кодовой точке Unicode U+25c4.
Перечисления
BULLET_DISC_CIRCLE_SQUARE Маркированный список с символами DISC , CIRCLE и SQUARE для первых трех уровней вложенности списка.
BULLET_DIAMONDX_ARROW3D_SQUARE Маркированный список с символами DIAMONDX , ARROW3D и SQUARE для первых трех уровней вложенности списка.
BULLET_CHECKBOX Маркированный список с символами маркеров CHECKBOX для всех уровней вложенности списка.
BULLET_ARROW_DIAMOND_DISC Маркированный список со ARROW , DIAMOND и DISC для первых трех уровней вложенности списка.
BULLET_STAR_CIRCLE_SQUARE Маркированный список со STAR , CIRCLE и SQUARE для первых трех уровней вложенности списка.
BULLET_ARROW3D_CIRCLE_SQUARE Маркированный список со ARROW3D , CIRCLE и SQUARE для первых трех уровней вложенности списка.
BULLET_LEFTTRIANGLE_DIAMOND_DISC Маркированный список с символами LEFTTRIANGLE , DIAMOND и DISC для первых трех уровней вложенности списка.
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE Маркированный список с символами DIAMONDX , HOLLOWDIAMOND и SQUARE для первых трех уровней вложенности списка.
BULLET_DIAMOND_CIRCLE_SQUARE Маркированный список с DIAMOND , CIRCLE и SQUARE для первых трех уровней вложенности списка.
NUMBERED_DIGIT_ALPHA_ROMAN Нумерованный список с DIGIT , ALPHA и ROMAN цифровыми глифами для первых трех уровней вложенности списка, за которыми следуют точки.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS Нумерованный список с DIGIT , ALPHA и ROMAN цифровыми глифами для первых трех уровней вложенности списка, за которыми следуют круглые скобки.
NUMBERED_DIGIT_NESTED Нумерованный список с DIGIT числовыми глифами, разделенными точками, где каждый уровень вложенности использует глиф предыдущего уровня вложенности в качестве префикса. Например: «1.», «1.1.», «2.», «2.2.».
NUMBERED_UPPERALPHA_ALPHA_ROMAN Нумерованный список с UPPERALPHA , ALPHA и ROMAN цифровыми глифами для первых трех уровней вложенности списка, за которыми следуют точки.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT Нумерованный список с цифровыми глифами UPPERROMAN , UPPERALPHA и DIGIT для первых трех уровней вложенности списка, за которыми следуют точки.
NUMBERED_ZERODIGIT_ALPHA_ROMAN Нумерованный список с ZERODIGIT , ALPHA и ROMAN цифровыми глифами для первых трех уровней вложенности списка, за которыми следуют точки.

ЗаменитьAllShapesWithImageRequest

Заменяет все фигуры, соответствующие заданным критериям, предоставленным изображением.

Изображения, заменяющие фигуры, после вставки в презентацию имеют прямоугольную форму и не принимают формы фигур.

JSON-представление
{
  "replaceMethod": enum (ReplaceMethod),
  "imageReplaceMethod": enum (ImageReplaceMethod),
  "pageObjectIds": [
    string
  ],

  // Union field criteria can be only one of the following:
  "containsText": {
    object (SubstringMatchCriteria)
  }
  // End of list of possible types for union field criteria.

  // Union field image_source can be only one of the following:
  "imageUrl": string
  // End of list of possible types for union field image_source.
}
Поля
replaceMethod
(deprecated)

enum ( ReplaceMethod )

Метод замены.

Устарело : вместо этого используйте imageReplaceMethod .

Если вы укажете и replaceMethod , и imageReplaceMethod , то imageReplaceMethod будет иметь приоритет.

imageReplaceMethod

enum ( ImageReplaceMethod )

Метод замены изображения.

Если вы укажете и replaceMethod , и imageReplaceMethod , то imageReplaceMethod будет иметь приоритет.

Если вы не указываете значение imageReplaceMethod , но указываете значение replaceMethod , то используется указанное значение replaceMethod .

Если вы не укажете ни того, ни другого, используется CENTER_INSIDE.

pageObjectIds[]

string

Если не пусто, ограничивает совпадения элементами страницы только на заданных страницах.

Возвращает ошибку 400 неверного запроса, если указан идентификатор объекта страницы notes page или notes master , или если страница с этим идентификатором объекта не существует в презентации.

criteria поля Союза. Критерии, которым должны соответствовать фигуры для замены. criteria может быть только один из следующих:
containsText

object ( SubstringMatchCriteria )

Если установлено, этот запрос заменит все фигуры, содержащие данный текст.

Поле объединения image_source . Тип источника изображения. image_source может быть только одним из следующих:
imageUrl

string

URL-адрес изображения.

Изображение извлекается один раз во время вставки, а его копия сохраняется для отображения внутри презентации. Изображения должны иметь размер менее 50 МБ, не превышать 25 мегапикселей и быть в формате PNG, JPEG или GIF.

Длина предоставленного URL-адреса не может превышать 2 КБ. Сам URL-адрес сохраняется вместе с изображением и отображается через поле Image.source_url .

ЗаменитьМетод

Метод замены.

Перечисления
CENTER_INSIDE Масштабирует и центрирует изображение, чтобы оно соответствовало границам исходной формы, и сохраняет соотношение сторон изображения. Размер визуализированного изображения может быть меньше размера фигуры. Это метод по умолчанию, если он не указан.
CENTER_CROP Масштабирует и центрирует изображение, чтобы заполнить границы исходной фигуры. Изображение можно обрезать, чтобы заполнить форму. Визуализированный размер изображения будет таким же, как и у исходной фигуры.

Метод замены изображения

Метод замены изображения.

Перечисления
IMAGE_REPLACE_METHOD_UNSPECIFIED Неуказанный метод замены изображения. Это значение нельзя использовать.
CENTER_INSIDE Масштабирует и центрирует изображение, чтобы оно соответствовало границам исходной формы, и сохраняет соотношение сторон изображения. Размер визуализированного изображения может быть меньше размера фигуры. Это метод по умолчанию, если он не указан.
CENTER_CROP Масштабирует и центрирует изображение, чтобы заполнить границы исходной фигуры. Изображение можно обрезать, чтобы заполнить форму. Визуализированный размер изображения будет таким же, как и исходная форма.

Запрос дубликата объекта

Дублирует элемент слайда или страницы.

При дублировании слайда дубликат слайда будет создан сразу после указанного слайда. При дублировании элемента страницы дубликат будет размещен на той же странице в том же месте, что и оригинал.

JSON-представление
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
Поля
objectId

string

Идентификатор объекта для дублирования.

objectIds

map (key: string, value: string)

Дублируемый объект может содержать другие объекты, например, при дублировании слайда или элемента страницы группы. Эта карта определяет, как генерируются идентификаторы дублированных объектов: ключи — это идентификаторы исходных объектов, а ее значения — это идентификаторы, которые будут присвоены соответствующему дублирующемуся объекту. Идентификатор дубликата исходного объекта также может быть указан в этой карте, используя то же значение поля objectId в качестве ключа и новый желаемый идентификатор в качестве значения.

Все ключи должны соответствовать существующим идентификаторам в презентации. Все значения должны быть уникальными в представлении и должны начинаться с буквенно-цифрового символа или знака подчеркивания (соответствует регулярному выражению [a-zA-Z0-9_] ); остальные символы могут включать их, а также дефис или двоеточие (соответствует регулярному выражению [a-zA-Z0-9_-:] ). Длина нового идентификатора не должна быть меньше 5 или больше 50.

Если какие -либо идентификаторы объектов исходных объектов будут опущены с карты, будет назначен новый случайный идентификатор. Если карта пустая или не установлена, все дубликаты объектов получат новый случайный идентификатор.

UpdateTextStyleRequest

Обновите стиль текста в Shape или Table .

JSON-представление
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта формы или таблицы с текстом для стилилизации.

cellLocation

object ( TableCellLocation )

Расположение ячейки в таблице, содержащая текст в стиле. Если objectId относится к таблице, cellLocation должна иметь значение. В противном случае это не должно.

style

object ( TextStyle )

Стиль (ы) для установки на текст.

Если значение для конкретного стиля соответствует значению родителя, этот стиль будет наследовать.

Некоторые изменения в стиле текста могут привести к другим изменениям, предназначенным для отражения поведения редактора слайдов. Смотрите документацию TextStyle для получения дополнительной информации.

textRange

object ( Range )

Диапазон текста в стиле.

Диапазон может быть расширен, чтобы включить соседние новеньши.

Если диапазон полностью содержит абзац, принадлежащий списку, пуля абзаца также обновляется с помощью соответствующего текстового стиля.

fields

string ( FieldMask format)

Поля, которые должны быть обновлены.

По крайней мере, одно поле должно быть указано. Корневой style подразумевается и не должен быть указан. Один "*" может использоваться в качестве короткого рук для перечисления каждого поля.

Например, чтобы обновить стиль текста, жирный, установите fields "bold" .

Чтобы сбросить свойство до значения по умолчанию, включите название его поля в полевую маску, но оставьте само поле.

ЗаменитьAllShapesWithSheetsChartRequest

Заменяет все формы, которые соответствуют данным критериям с помощью диаграммы Google Sheets. Диаграмма будет масштабирована и центрирована, чтобы соответствовать границам исходной формы.

ПРИМЕЧАНИЕ. Замена фигур на диаграмму требует хотя бы одной из таблиц.

JSON-представление
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
Поля
containsText

object ( SubstringMatchCriteria )

Критерии, которые формы должны соответствовать, чтобы быть заменены. Запрос заменит все формы, которые содержат заданный текст.

spreadsheetId

string

Идентификатор электронной таблицы Google Sheets, который содержит диаграмму.

chartId

integer

Идентификатор конкретной таблицы в таблице Google Sheets.

linkingMode

enum ( LinkingMode )

Режим, с которым диаграмма связан с таблицей исходной таблицы. Когда не указано, диаграмма будет изображением, которое не связано.

pageObjectIds[]

string

Если не пустые, ограничивает совпадения элементами страницы только на данных страницах.

Возвращает ошибку плохого запроса 400, если предоставлен идентификатор объекта страницы notes page или notes master , или если страница с этим идентификатором объекта не существует в презентации.

Режим связывания

Режим, с которым диаграмма связан с таблицей исходной таблицы.

Перечисления
NOT_LINKED_IMAGE Диаграмма не связана с исходной таблицей и не может быть обновлена. Диаграмма, которая не связана, будет вставлена ​​в качестве изображения.
LINKED Связывание диаграммы позволяет обновлять его, а другие сотрудники увидят ссылку на электронную таблицу.

Удалить абзац. Запрос маркеров.

Удаляет пули со всех параграфов, которые перекрываются с данным range текстового индекса.

Уровень гнездования каждого абзаца будет визуально сохранен путем добавления отступления к началу соответствующего абзаца.

JSON-представление
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
Поля
objectId

string

Идентификатор объекта формы или таблицы, содержащий текст для удаления пуль.

cellLocation

object ( TableCellLocation )

Необязательное местоположение ячейки таблицы, если текст, который будет изменен, находится в табличной ячейке. Если присутствует, ObjectId должен относиться к таблице.

textRange

object ( Range )

Диапазон текста для удаления пуль, на основе индексов TextElement .

Запрос обновления абзаца стиля

Обновляет стиль для всех абзацев в Shape или Table , которые перекрываются с данным диапазоном текстового индекса.

JSON-представление
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта формы или таблицы с текстом для стилилизации.

cellLocation

object ( TableCellLocation )

Расположение ячейки в таблице, содержащее абзац (ы) в стиле. Если objectId относится к таблице, cellLocation должна иметь значение. В противном случае это не должно.

style

object ( ParagraphStyle )

Стиль абзаца.

textRange

object ( Range )

Диапазон текста, содержащий абзац (ы) в стиле.

fields

string ( FieldMask format)

Поля, которые должны быть обновлены.

По крайней мере, одно поле должно быть указано. Корневой style подразумевается и не должен быть указан. Один "*" может использоваться в качестве короткого рук для перечисления каждого поля.

Например, чтобы обновить выравнивание абзаца, установите fields на "alignment" .

Чтобы сбросить свойство до значения по умолчанию, включите название его поля в полевую маску, но оставьте само поле.

UpdateTableBorderPropertiesRequest

Обновляет свойства границ таблицы в Table .

JSON-представление
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  },
  "borderPosition": enum (BorderPosition),
  "tableBorderProperties": {
    object (TableBorderProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта таблицы.

tableRange

object ( TableRange )

Диапазон таблиц, представляющий подмножество таблицы, к которой применяются обновления. Если диапазон таблиц не указан, обновления будут применяться ко всей таблице.

borderPosition

enum ( BorderPosition )

Положение границы в диапазоне таблиц, к которому должны применяться обновления. Если пограничная позиция не указана, обновления будут применяться ко всем границам в диапазоне таблиц.

tableBorderProperties

object ( TableBorderProperties )

Свойства границы стола для обновления.

fields

string ( FieldMask format)

Поля, которые должны быть обновлены.

По крайней мере, одно поле должно быть указано. Корневые tableBorderProperties подразумеваются и не должны быть указаны. Один "*" может использоваться в качестве короткого рук для перечисления каждого поля.

Например, для обновления сплошной заполнения таблицы, установите fields на "tableBorderFill.solidFill.color" .

Чтобы сбросить свойство до значения по умолчанию, включите название его поля в полевую маску, но оставьте само поле.

ГраницаПозиция

Положение границы стола.

Перечисления
ALL Все границы в диапазоне.
BOTTOM Границы в нижней части диапазона.
INNER Границы на внутренней стороне диапазона.
INNER_HORIZONTAL Горизонтальные границы на внутренней стороне диапазона.
INNER_VERTICAL Вертикальные границы на внутренней стороне диапазона.
LEFT Границы слева от диапазона.
OUTER Границы вдоль дальнейшего диапазона.
RIGHT Границы справа от диапазона.
TOP Границы в верхней части диапазона.

UpdateTableColumnPropertiesRequest

Обновляет свойства столбца Table .

JSON-представление
{
  "objectId": string,
  "columnIndices": [
    integer
  ],
  "tableColumnProperties": {
    object (TableColumnProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта таблицы.

columnIndices[]

integer

Список индексов на основе нуля, указывающий, какие столбцы обновляются. Если индексы не предоставляются, все столбцы в таблице будут обновлены.

tableColumnProperties

object ( TableColumnProperties )

Свойства столбца таблицы для обновления.

Если значение tableColumnProperties#columnWidth в запросе составляет менее 406 400 EMU (32 балла), возвращается ошибка 400 плохого запроса.

fields

string ( FieldMask format)

Поля, которые должны быть обновлены.

По крайней мере, одно поле должно быть указано. Корневые tableColumnProperties подразумеваются и не должны быть указаны. Один "*" может использоваться в качестве короткого рук для перечисления каждого поля.

Например, чтобы обновить ширину столбца, установите fields на "columnWidth" .

Если «Wildwidth» столбца включена в полевую маску, но свойство остается бездействующим, ширина столбца по умолчанию будет по умолчанию до 406 400 EMU (32 балла).

UpdateTableRowPropertiesRequest

Обновляет свойства строки Table .

JSON-представление
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта таблицы.

rowIndices[]

integer

Список индексов на основе нуля, указывающий, какие строки обновлять. Если индексы не предоставляются, все строки в таблице будут обновлены.

tableRowProperties

object ( TableRowProperties )

Свойства строки таблицы для обновления.

fields

string ( FieldMask format)

Поля, которые должны быть обновлены.

По крайней мере, одно поле должно быть указано. Корневые tableRowProperties подразумеваются и не должны быть указаны. Один "*" может использоваться в качестве короткого рук для перечисления каждого поля.

Например, чтобы обновить минимальную высоту строки, установите fields на "minRowHeight" .

Если «minrowheight» включен в полевую маску, но свойство остается без заведения, минимальная высота строки по умолчанию будет 0.

Запрос MergeTableCells

Объединяет ячейки в Table .

JSON-представление
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Поля
objectId

string

Идентификатор объекта таблицы.

tableRange

object ( TableRange )

Диапазон таблиц указывает, какие ячейки таблицы слияют.

Любой текст в объединенных ячейках будет объединяться и храниться в ячейке верхнего левого («голова») диапазона. Если диапазон неретангол (который может возникнуть в некоторых случаях, когда диапазон охватывает клетки, которые уже объединены), возвращается ошибка плохого запроса 400.

UnmergeTableCellsRequest

Uncerces ячейки в Table .

JSON-представление
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
Поля
objectId

string

Идентификатор объекта таблицы.

tableRange

object ( TableRange )

Диапазон таблиц, указывающий, какие ячейки таблицы в непосредственное значение.

Все объединенные ячейки в этом диапазоне будут невыполнены, а клетки, которые уже не будут затронуты, не будут затронуты. Если диапазон не имеет объединенных ячеек, запрос ничего не сделает. Если в любой из объединенных ячеек есть текст, текст останется в верхней левой («головной») ячейке результирующего блока нередерных ячеек.

ГруппаОбъектыЗапрос

Группы объекты для создания объектной группы. Например, группы PageElements для создания Group на той же странице, что и все дети.

JSON-представление
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
Поля
groupObjectId

string

Идентификатор объекта, поставленного пользователем для создания группы.

Если вы указываете идентификатор, он должен быть уникальным среди всех страниц и элементов страниц в презентации. Идентификатор должен начинаться с буквенно-цифрового персонажа или подчеркивания (совпадает с режимом [a-zA-Z0-9_] ); Оставшиеся символы могут включать в себя, а также дефис или толстую кишку (соответствует корпорации [a-zA-Z0-9_-:] ). Длина идентификатора должна быть не менее 5 или более 50.

Если вы не указываете идентификатор, генерируется уникальный.

childrenObjectIds[]

string

Идентификаторы объекта объектов для группы.

Только элементы страницы могут быть сгруппированы. На той же странице должно быть как минимум двух страниц, которые еще не находятся в другой группе. Некоторые элементы страницы, такие как videos , tables и placeholders не могут быть сгруппированы.

РазгруппироватьОбъектыЗапрос

Объекты Ungroups, такие как groups .

JSON-представление
{
  "objectIds": [
    string
  ]
}
Поля
objectIds[]

string

Идентификаторы объекта объектов в негрупп.

Только groups , которые не находятся внутри других groups могут быть негруппированы. Все группы должны быть на одной странице. Сама группа удалена. Визуальные размеры и позиции всех детей сохраняются.

ОбновлениеPageElementAltTextRequest

Обновляет заголовок Alt Text и/или описание page element .

JSON-представление
{
  "objectId": string,
  "title": string,
  "description": string
}
Поля
objectId

string

Идентификатор объекта элемента страницы, к которому применяются обновления.

title

string

Обновленное альтернативное название элемента страницы. Если не будет поддерживать существующее значение. Название подвергается воздействию считывателей экрана и других интерфейсов доступности. Используйте только читаемые значения человека, связанные с содержанием элемента страницы.

description

string

Обновленное описание текста Alt из элемента страницы. Если не будет поддерживать существующее значение. Описание подвергается воздействию считывателей экрана и других интерфейсов доступности. Используйте только читаемые значения человека, связанные с содержанием элемента страницы.

ЗаменитьImageRequest

Заменяет существующее изображение новым изображением.

Замена изображения удаляет некоторые image effects из существующего изображения.

JSON-представление
{
  "imageObjectId": string,
  "imageReplaceMethod": enum (ImageReplaceMethod),

  // Union field image_source can be only one of the following:
  "url": string
  // End of list of possible types for union field image_source.
}
Поля
imageObjectId

string

Идентификатор существующего изображения, который будет заменен. Идентификатор может быть извлечен из ответа запроса GET.

imageReplaceMethod

enum ( ImageReplaceMethod )

Метод замены.

Союз Полевый image_source . Вид источника изображения. image_source может быть только одним из следующих:
url

string

Изображение URL.

Изображение выбирается один раз во время вставки, и копия хранится для отображения внутри презентации. Изображения должны быть менее 50 МБ, не могут превышать 25 мегапикселей и должны быть в формате PNG, JPEG или GIF.

Предоставленный URL не может превзойти длиной 2 КБ. URL сохраняется с изображением и обнажается через поле Image.source_url .

Обновить запрос свойств слайда

Обновляет свойства слайда.

JSON-представление
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
Поля
objectId

string

Идентификатор объекта слайда, к которому применяется обновление.

slideProperties

object ( SlideProperties )

Свойства слайда для обновления.

fields

string ( FieldMask format)

Поля, которые должны быть обновлены.

По крайней мере, одно поле должно быть указано. Корневые «слайдпропертистики» подразумеваются и не должны быть указаны. Один "*" может использоваться в качестве короткого рук для перечисления каждого поля.

Например, чтобы обновить, пропущен ли слайд, установите fields "isSkipped" .

Чтобы сбросить свойство до значения по умолчанию, включите название его поля в полевую маску, но оставьте само поле.

ОбновлениеPageElementsZOrderRequest

Обновляет Z-порядка элементов страницы. Z-order-это упорядочение элементов на странице с задней части. Элемент страницы спереди может охватывать элементы, которые находятся за ним.

JSON-представление
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
Поля
pageElementObjectIds[]

string

Идентификаторы объекта элементов страницы для обновления.

Все элементы страницы должны быть на одной странице и не должны быть сгруппированы.

operation

enum ( ZOrderOperation )

Операция Z-порядка для применения на элементах страницы.

При применении операции на нескольких элементах страниц относительные Z-ордер в этих элементах страницы до того, как операция будет поддержана.

ZOrderOperation

Операция по обновлению Z-порядка элемента страницы.

Перечисления
Z_ORDER_OPERATION_UNSPECIFIED Неопределенная операция.
BRING_TO_FRONT Приносит элементы страницы на переднюю часть страницы.
BRING_FORWARD Выводит элементы страницы на странице одним элементом по сравнению с самым первым в указанных элементах страницы.
SEND_BACKWARD Отправляет элементы страницы назад на странице одним элементом по сравнению с самым дальним позади одного в указанных элементах страницы.
SEND_TO_BACK Отправляет элементы страницы на заднюю часть страницы.

UpdateLineCategoryRequest

Обновляет категорию line .

JSON-представление
{
  "objectId": string,
  "lineCategory": enum (LineCategory)
}
Поля
objectId

string

Идентификатор объекта линии, к которой применяется обновление.

Может быть обновлена ​​только линия с category , указывающей, что это «соединитель».

Линия может быть перенаправлена ​​после обновления своей категории.

lineCategory

enum ( LineCategory )

Категория строки для обновления.

Точный line type определяется на основе категории для обновления и того, как она направлена ​​на подключение к другим элементам страницы.

Запрос перенаправления линии

Передает line , так что она подключена на двух ближайших сайтах подключения на подключенных элементах страницы.

JSON-представление
{
  "objectId": string
}
Поля
objectId

string

Идентификатор объекта линии для перенаправления.

Только линия с category , указывающей, что это «соединитель», может быть перенаправлена. Начальные и конечные соединения линии должны быть в разных элементах страницы.