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입니다. 업데이트 유형입니다. 필드는 정확히 1개만 필요합니다. 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 Sheets 차트를 새로고침합니다.

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 Sheets 차트로 바꿉니다.

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)

page elements의 Z 순서를 업데이트합니다.

updateLineCategory

object (UpdateLineCategoryRequest)

line의 카테고리를 업데이트합니다.

rerouteLine

object (RerouteLineRequest)

연결된 페이지 요소에서 가장 가까운 두 연결 지점에서 연결되도록 line의 경로를 다시 변경합니다.

CreateSlideRequest

슬라이드를 만듭니다.

JSON 표현 
{
  "objectId": string,
  "insertionIndex": integer,
  "slideLayoutReference": {
    object (LayoutReference)
  },
  "placeholderIdMappings": [
    {
      object (LayoutPlaceholderIdMapping)
    }
  ]
}
필드
objectId

string

사용자가 제공한 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다(정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론(정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID 길이는 5~50자(영문 기준)여야 합니다.

ID를 지정하지 않으면 고유한 ID가 생성됩니다.

insertionIndex

integer

슬라이드를 삽입할 위치를 나타내는 0부터 시작하는 색인(선택사항)입니다.

색인을 지정하지 않으면 슬라이드가 마지막에 생성됩니다.

slideLayoutReference

object (LayoutReference)

삽입할 슬라이드의 레이아웃 참조로, 다음 중 하나인 현재 마스터를 기준으로 합니다.

  • 이전 슬라이드 색인의 마스터입니다.
  • 삽입 색인이 0인 경우 첫 번째 슬라이드의 마스터입니다.
  • 슬라이드가 없는 경우 프레젠테이션의 첫 번째 마스터입니다.

LayoutReference가 현재 마스터에서 발견되지 않으면 400 잘못된 요청 오류가 반환됩니다.

레이아웃 참조를 지정하지 않으면 슬라이드에서 사전 정의된 BLANK 레이아웃을 사용합니다.

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

레이아웃의 placeholder(들)에서 지정된 레이아웃의 슬라이드에 생성된 자리표시자(들)로의 객체 ID 매핑 목록(선택사항)입니다. slideLayoutReference가 지정된 경우에만 사용할 수 있습니다.

LayoutReference

슬라이드 레이아웃 참조 다음 중 하나를 참조할 수 있습니다.

  • 사전 정의된 레이아웃
  • 프레젠테이션의 레이아웃 중 하나입니다.
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

레이아웃 ID: 프레젠테이션의 레이아웃 중 하나의 객체 ID입니다.

PredefinedLayout

사전 정의된 레이아웃 유형입니다. 프레젠테이션에서 흔히 볼 수 있는 레이아웃입니다. 그러나 이러한 레이아웃이 현재 마스터에 있는 것은 아닙니다. 삭제되었거나 사용된 테마의 일부가 아닐 수 있기 때문입니다. 또한 각 레이아웃의 자리표시자가 변경되었을 수 있습니다.

열거형
PREDEFINED_LAYOUT_UNSPECIFIED 지정되지 않은 레이아웃
BLANK 자리표시자가 없는 빈 레이아웃
CAPTION_ONLY 하단에 자막이 있는 레이아웃
TITLE 제목과 부제목이 있는 레이아웃
TITLE_AND_BODY 제목과 본문이 있는 레이아웃
TITLE_AND_TWO_COLUMNS 제목과 열 2개가 있는 레이아웃
TITLE_ONLY 제목만 있는 레이아웃
SECTION_HEADER 섹션 제목이 있는 레이아웃
SECTION_TITLE_AND_DESCRIPTION 한쪽에 제목과 부제목이 있고 다른 한쪽에 설명이 있는 레이아웃
ONE_COLUMN_TEXT 제목 1개와 본문 1개가 단일 열로 정렬된 레이아웃
MAIN_POINT 주요 내용이 포함된 레이아웃
BIG_NUMBER 큰 숫자 제목이 있는 레이아웃

LayoutPlaceholderIdMapping

지정된 레이아웃에서 슬라이드에 생성될 자리표시자의 사용자 지정 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

슬라이드에 생성할 위에서 식별된 자리표시자의 사용자 제공 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID의 길이는 5자 이상 50자 이하여야 합니다.

ID를 지정하지 않으면 고유한 ID가 생성됩니다.

공용체 필드 kind입니다. 레이아웃에서 자리표시자를 식별하는 종류입니다. kind는 다음 중 하나여야 합니다.
layoutPlaceholder

object (Placeholder)

슬라이드에 적용될 레이아웃의 자리표시자입니다. type 및 index만 필요합니다. 예를 들어 사전 정의된 TITLE_AND_BODY 레이아웃에는 일반적으로 색인이 0인 TITLE 자리표시자와 색인이 0인 BODY 자리표시자가 있을 수 있습니다.

layoutPlaceholderObjectId

string

슬라이드에 적용할 레이아웃의 자리표시자의 객체 ID입니다.

CreateShapeRequest

새 도형을 만듭니다.

JSON 표현 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "shapeType": enum (Type)
}
필드
objectId

string

사용자가 제공한 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID의 길이는 5자 이상 50자 이하여야 합니다. 비워 두면 고유 식별자가 생성됩니다.

elementProperties

object (PageElementProperties)

도형의 요소 속성입니다.

shapeType

enum (Type)

도형 유형입니다.

PageElementProperties

페이지 요소의 공통 속성

참고: PageElement를 처음 만들 때 API는 size 및 transform의 값을 모두 수정할 수 있지만 시각적 크기는 변경되지 않습니다.

JSON 표현 
{
  "pageObjectId": string,
  "size": {
    object (Size)
  },
  "transform": {
    object (AffineTransform)
  }
}
필드
pageObjectId

string

요소가 있는 페이지의 객체 ID입니다.

size

object (Size)

요소의 크기입니다.

transform

object (AffineTransform)

요소의 변환입니다.

CreateTableRequest

새 테이블을 만듭니다.

JSON 표현 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "rows": integer,
  "columns": integer
}
필드
objectId

string

사용자가 제공한 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID의 길이는 5자 이상 50자 이하여야 합니다.

ID를 지정하지 않으면 고유한 ID가 생성됩니다.

elementProperties

object (PageElementProperties)

표의 요소 속성입니다.

테이블은 최소 크기를 기준으로 제공된 크기로 생성됩니다. 크기를 지정하지 않으면 테이블 크기가 자동으로 조정됩니다.

테이블 변환의 크기는 1이어야 하며 전단 구성요소가 없어야 합니다. 변환이 제공되지 않으면 표가 페이지 중앙에 배치됩니다.

rows

integer

테이블의 행 수입니다.

columns

integer

테이블의 열 수입니다.

InsertTextRequest

도형이나 표 셀에 텍스트를 삽입합니다.

JSON 표현 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "text": string,
  "insertionIndex": integer
}
필드
objectId

string

텍스트가 삽입될 도형 또는 표의 객체 ID입니다.

cellLocation

object (TableCellLocation)

텍스트를 표 셀에 삽입할 경우 선택사항인 표 셀 위치입니다. 있는 경우 objectId는 테이블을 참조해야 합니다.

text

string

삽입할 텍스트입니다.

줄바꿈 문자를 삽입하면 해당 색인에 새 ParagraphMarker가 암시적으로 생성됩니다. 새 단락의 단락 스타일은 목록 및 글머리기호를 포함하여 현재 삽입 색인의 단락에서 복사됩니다.

삽입된 텍스트의 텍스트 스타일은 일반적으로 인접한 텍스트의 스타일을 유지하면서 자동으로 결정됩니다. 대부분의 경우 텍스트는 삽입 색인에 있는 TextRun에 추가됩니다.

일부 제어 문자 (U+0000~U+0008, U+000C~U+001F)와 유니코드 기본 다국어 평면 개인 사용 영역 (U+E000~U+F8FF)의 문자는 삽입된 텍스트에서 제거됩니다.

insertionIndex

integer

TextElement 색인을 기반으로 텍스트가 삽입될 색인(유니코드 코드 단위)입니다.

색인은 0부터 시작하며 문자열의 시작 부분에서 계산됩니다. 유니코드 그래프eme 클러스터 내부에 삽입이 이루어지지 않도록 색인이 조정될 수 있습니다. 이 경우 텍스트가 그래프eme 클러스터 바로 뒤에 삽입됩니다.

InsertTableRowsRequest

테이블에 행을 삽입합니다.

JSON 표현 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertBelow": boolean,
  "number": integer
}
필드
tableObjectId

string

행을 삽입할 테이블입니다.

cellLocation

object (TableCellLocation)

행이 삽입될 참조 테이블 셀 위치입니다.

참조 셀이 있는 행 위에 (또는 아래에) 새 행이 삽입됩니다. 참조 셀이 병합된 셀인 경우 병합된 셀 위에 (또는 아래에) 새 행이 삽입됩니다.

insertBelow

boolean

참조 셀 위치 아래에 새 행을 삽입할지 여부입니다.

  • True : 셀 아래에 삽입합니다.
  • False : 셀 위에 삽입합니다.
number

integer

삽입할 행 수입니다. 요청당 최대 20개

InsertTableColumnsRequest

테이블에 열을 삽입합니다.

표의 다른 열은 새 열에 맞게 크기가 조절됩니다.

JSON 표현 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "insertRight": boolean,
  "number": integer
}
필드
tableObjectId

string

열을 삽입할 테이블입니다.

cellLocation

object (TableCellLocation)

열이 삽입될 참조 표 셀 위치입니다.

참조 셀이 있는 열의 왼쪽 (또는 오른쪽)에 새 열이 삽입됩니다. 참조 셀이 병합된 셀인 경우 병합된 셀의 왼쪽 (또는 오른쪽)에 새 열이 삽입됩니다.

insertRight

boolean

참조 셀 위치의 오른쪽에 새 열을 삽입할지 여부입니다.

  • True : 오른쪽에 삽입합니다.
  • False : 왼쪽에 삽입합니다.
number

integer

삽입할 열의 개수입니다. 요청당 최대 20개

DeleteTableRowRequest

테이블에서 행을 삭제합니다.

JSON 표현 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
필드
tableObjectId

string

행을 삭제할 테이블입니다.

cellLocation

object (TableCellLocation)

행이 삭제될 참조 테이블 셀 위치입니다.

이 셀이 걸쳐 있는 행이 삭제됩니다. 병합된 셀인 경우 여러 행이 삭제됩니다. 이 삭제 후 테이블에 행이 남아 있지 않으면 전체 테이블이 삭제됩니다.

DeleteTableColumnRequest

테이블에서 열을 삭제합니다.

JSON 표현 
{
  "tableObjectId": string,
  "cellLocation": {
    object (TableCellLocation)
  }
}
필드
tableObjectId

string

열을 삭제할 테이블입니다.

cellLocation

object (TableCellLocation)

열이 삭제될 참조 테이블 셀 위치입니다.

이 셀이 걸쳐 있는 열이 삭제됩니다. 병합된 셀인 경우 여러 열이 삭제됩니다. 이 삭제 후 테이블에 열이 남아 있지 않으면 전체 테이블이 삭제됩니다.

ReplaceAllTextRequest

기준과 일치하는 텍스트의 모든 인스턴스를 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

비어 있지 않은 경우 일치를 지정된 페이지의 페이지 요소로만 제한합니다.

notes master의 페이지 객체 ID가 주어지거나 해당 객체 ID의 페이지가 프레젠테이션에 없는 경우 400 Bad Request 오류를 반환합니다.

공용체 필드 criteria입니다. 대체할 텍스트를 일치시키는 데 사용되는 기준입니다. criteria는 다음 중 하나여야 합니다.
containsText

object (SubstringMatchCriteria)

이 하위 문자열과 일치하는 도형의 텍스트를 찾습니다.

SubstringMatchCriteria

도형 또는 표의 특정 텍스트 문자열과 일치하는 기준입니다.

JSON 표현 
{
  "text": string,
  "matchCase": boolean,
  "searchByRegex": boolean
}
필드
text

string

도형 또는 표에서 검색할 텍스트입니다.

matchCase

boolean

검색 시 대소문자를 구분해야 하는지 여부를 나타냅니다.

  • True : 검색 시 대소문자가 구분됩니다.
  • False : 검색 시 대소문자를 구분하지 않습니다.
searchByRegex

boolean

선택사항입니다. 찾을 값을 정규 표현식으로 처리해야 하는 경우 true입니다. 패턴의 백슬래시는 이스케이프 처리해야 합니다.

  • True : 검색 텍스트가 정규 표현식으로 처리됩니다.
  • False : 검색 텍스트가 일치의 하위 문자열로 취급됩니다.

DeleteObjectRequest

프레젠테이션에서 pages 또는 page elements 객체를 삭제합니다.

JSON 표현 
{
  "objectId": string
}
필드
objectId

string

삭제할 페이지 또는 페이지 요소의 객체 ID입니다.

삭제 작업 후 group에 페이지 요소가 1개만 있거나 요소가 없는 경우 그룹도 삭제됩니다.

레이아웃에서 자리표시자를 삭제하면 빈 상속 자리표시자도 삭제됩니다.

UpdatePageElementTransformRequest

페이지 요소의 변환을 업데이트합니다.

그룹의 변환을 업데이트하면 해당 그룹의 페이지 요소의 절대 변환이 변경되어 시각적 모양이 달라질 수 있습니다. 자세한 내용은 PageElement.transform 문서를 참고하세요.

JSON 표현 
{
  "objectId": string,
  "transform": {
    object (AffineTransform)
  },
  "applyMode": enum (ApplyMode)
}
필드
objectId

string

업데이트할 페이지 요소의 객체 ID입니다.

transform

object (AffineTransform)

페이지 요소를 업데이트하는 데 사용되는 입력 변환 행렬입니다.

applyMode

enum (ApplyMode)

변환 업데이트의 적용 모드입니다.

ApplyMode

변환 업데이트의 적용 모드입니다.

열거형
APPLY_MODE_UNSPECIFIED 지정되지 않은 모드입니다.
RELATIVE 새 AffineTransform 행렬을 기존 행렬에 적용하고, 기존 행렬을 결과 연결 문자열로 대체합니다.
ABSOLUTE 기존 AffineTransform 행렬을 새 행렬로 바꿉니다.

UpdateSlidesPositionRequest

프레젠테이션에서 슬라이드의 위치를 업데이트합니다.

JSON 표현 
{
  "slideObjectIds": [
    string
  ],
  "insertionIndex": integer
}
필드
slideObjectIds[]

string

이동해야 하는 프레젠테이션 슬라이드의 ID입니다. 이 목록의 슬라이드는 중복 없이 기존 프레젠테이션 순서여야 합니다.

insertionIndex

integer

이동하기 전의 슬라이드 배열을 기준으로 슬라이드를 삽입해야 하는 색인입니다. 0과 프레젠테이션의 슬라이드 수 사이(양 끝값 포함)여야 합니다.

DeleteTextRequest

도형이나 표 셀에서 텍스트를 삭제합니다.

JSON 표현 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
필드
objectId

string

텍스트가 삭제될 도형 또는 표의 객체 ID입니다.

cellLocation

object (TableCellLocation)

표 셀에서 텍스트를 삭제할 경우의 선택적 표 셀 위치입니다. 있는 경우 objectId는 테이블을 참조해야 합니다.

textRange

object (Range)

TextElement 색인을 기반으로 삭제할 텍스트 범위입니다.

도형 또는 표 셀의 텍스트 끝에는 항상 삭제할 수 없는 암시적 줄바꿈 문자가 있습니다. Range.Type.ALL는 올바른 경계를 사용하지만 범위 유형 FROM_START_INDEX 및 FIXED_RANGE에 명시적 경계를 지정할 때는 주의해야 합니다. 예를 들어 텍스트가 'ABC'이고 뒤에 암시적 새 줄이 오는 경우 최대 값은 textRange.start_index의 경우 2이고 textRange.end_index의 경우 3입니다.

단락 경계를 넘는 텍스트를 삭제하면 두 단락이 병합될 때 단락 스타일과 목록이 변경될 수 있습니다.

서로게이트 페어의 코드 단위 하나만 포함된 범위는 두 코드 단위를 모두 포함하도록 확장됩니다.

범위

색인이 생성된 컬렉션의 연속된 범위(예: 텍스트의 문자)를 지정합니다.

JSON 표현 
{
  "startIndex": integer,
  "endIndex": integer,
  "type": enum (Type)
}
필드
startIndex

integer

컬렉션 시작 부분의 0부터 시작하는 색인(선택사항)입니다. FIXED_RANGE 및 FROM_START_INDEX 범위에 필수입니다.

endIndex

integer

컬렉션의 끝에 관한 0부터 시작하는 색인(선택사항)입니다. 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

사용자가 제공한 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID의 길이는 5자 이상 50자 이하여야 합니다.

ID를 지정하지 않으면 고유한 ID가 생성됩니다.

elementProperties

object (PageElementProperties)

이미지의 요소 속성입니다.

제공된 크기의 가로세로 비율이 이미지 가로세로 비율과 일치하지 않으면 가로세로 비율을 유지하기 위해 이미지가 크기에 맞게 크기 조절되고 중앙에 배치됩니다. 제공된 변환은 이 작업 후에 적용됩니다.

PageElementProperties.size 속성은 선택사항입니다. 크기를 지정하지 않으면 이미지의 기본 크기가 사용됩니다.

PageElementProperties.transform 속성은 선택사항입니다. 변환을 지정하지 않으면 이미지가 페이지의 왼쪽 상단에 배치됩니다.

공용체 필드 image_source입니다. 이미지 소스의 종류입니다. image_source는 다음 중 하나여야 합니다.
url

string

이미지 URL입니다.

이미지는 삽입 시 한 번 가져오고 사본은 프레젠테이션 내부에 표시되도록 저장됩니다. 이미지 크기는 50MB 미만이어야 하며 25메가픽셀을 초과할 수 없으며 PNG, JPEG, GIF 형식 중 하나여야 합니다.

제공된 URL은 공개적으로 액세스할 수 있어야 하며 길이가 최대 2KB여야 합니다. URL은 이미지와 함께 저장되며 Image.source_url 필드를 통해 노출됩니다.

CreateVideoRequest

동영상을 만듭니다.

참고: Google Drive에서 동영상을 만들려면 요청하는 앱에 drive, drive.readonly 또는 drive.file OAuth 범위 중 하나 이상이 있어야 합니다.

JSON 표현 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "source": enum (Source),
  "id": string
}
필드
objectId

string

사용자가 제공한 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID의 길이는 5자 이상 50자 이하여야 합니다.

ID를 지정하지 않으면 고유한 ID가 생성됩니다.

elementProperties

object (PageElementProperties)

동영상의 요소 속성입니다.

PageElementProperties.size 속성은 선택사항입니다. 크기를 지정하지 않으면 서버에서 기본 크기를 선택합니다.

PageElementProperties.transform 속성은 선택사항입니다. 변환에 전단 구성요소가 없어야 합니다. 변환을 지정하지 않으면 동영상이 페이지 왼쪽 상단에 배치됩니다.

source

enum (Source)

동영상 소스입니다.

id

string

이 동영상의 동영상 소스 고유 식별자입니다.

예를 들어 YouTube 동영상 https://www.youtube.com/watch?v=7U3axjORYZ0의 ID는 7U3axjORYZ0입니다. Google Drive 동영상(https://drive.google.com/file/d/1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q)의 ID는 1xCgQLFTJi5_Xl8DgW_lcUYq5e-q6Hi5Q입니다.

Google Drive 동영상 파일에 액세스하려면 이전 파일의 하위 집합에 대한 HTTP 헤더에 리소스 키를 추가해야 할 수 있습니다. 자세한 내용은 리소스 키를 사용하여 링크 공유 파일에 액세스를 참고하세요.

CreateSheetsChartRequest

삽입된 Google Sheets 차트를 만듭니다.

참고: 차트를 만들려면 spreadsheets.readonly, spreadsheets, drive.readonly, drive.file 또는 drive OAuth 범위 중 하나 이상이 필요합니다.

JSON 표현 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode)
}
필드
objectId

string

사용자가 제공한 객체 ID입니다.

지정된 경우 ID는 프레젠테이션의 모든 페이지 및 페이지 요소에서 고유해야 합니다. ID는 단어 문자[a~z, A~Z, 0~9_] 로 시작하고 그 뒤에 다음 문자[a~z, A~Z, 0~9_-:]가 이어져야 합니다. ID의 길이는 5자(영문 기준) 이상 50자(영문 기준) 미만이어야 합니다. 비워 두면 고유 식별자가 생성됩니다.

elementProperties

object (PageElementProperties)

차트의 요소 속성입니다.

제공된 크기의 가로세로 비율이 차트 가로세로 비율과 일치하지 않으면 가로세로 비율을 유지하기 위해 차트가 크기를 기준으로 크기 조정되고 중앙에 배치됩니다. 제공된 변환은 이 작업 후에 적용됩니다.

spreadsheetId

string

차트가 포함된 Google Sheets 스프레드시트의 ID입니다.

이전 파일의 하위 집합에 HTTP 헤더에 리소스 키를 추가해야 할 수 있습니다. 자세한 내용은 리소스 키를 사용하여 링크 공유 파일에 액세스를 참고하세요.

chartId

integer

Google Sheets 스프레드시트의 특정 차트 ID입니다.

linkingMode

enum (LinkingMode)

차트가 소스 스프레드시트에 연결되는 모드입니다. 지정하지 않으면 차트가 연결되지 않은 이미지가 됩니다.

LinkingMode

차트가 소스 스프레드시트에 연결되는 모드입니다.

열거형
NOT_LINKED_IMAGE 차트가 소스 스프레드시트와 연결되어 있지 않으므로 업데이트할 수 없습니다. 연결되지 않은 차트는 이미지로 삽입됩니다.
LINKED 차트를 연결하면 업데이트할 수 있으며 다른 공동작업자에게는 스프레드시트 링크가 표시됩니다.

CreateLineRequest

선을 만듭니다.

JSON 표현 
{
  "objectId": string,
  "elementProperties": {
    object (PageElementProperties)
  },
  "lineCategory": enum (Category),
  "category": enum (LineCategory)
}
필드
objectId

string

사용자가 제공한 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID의 길이는 5자 이상 50자 이하여야 합니다.

ID를 지정하지 않으면 고유한 ID가 생성됩니다.

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를 포함한 곡선 커넥터

RefreshSheetsChartRequest

삽입된 Google Sheets 차트를 Google Sheets의 최신 버전 차트로 대체하여 새로고침합니다.

참고: 차트를 새로고침하려면 spreadsheets.readonly, spreadsheets, drive.readonly 또는 drive OAuth 범위 중 하나 이상이 필요합니다.

JSON 표현 
{
  "objectId": string
}
필드
objectId

string

새로고침할 차트의 객체 ID입니다.

UpdateShapePropertiesRequest

Shape의 속성을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "shapeProperties": {
    object (ShapeProperties)
  },
  "fields": string
}
필드
objectId

string

업데이트가 적용되는 도형의 객체 ID입니다.

shapeProperties

object (ShapeProperties)

업데이트할 도형 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 shapeProperties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 도형 배경의 단색 채우기 색상을 업데이트하려면 fields를 "shapeBackgroundFill.solidFill.color"로 설정합니다.

속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하되 필드 자체는 설정하지 않습니다.

UpdateImagePropertiesRequest

Image의 속성을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "imageProperties": {
    object (ImageProperties)
  },
  "fields": string
}
필드
objectId

string

업데이트가 적용되는 이미지의 객체 ID입니다.

imageProperties

object (ImageProperties)

업데이트할 이미지 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 imageProperties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 이미지 윤곽선 색상을 업데이트하려면 fields를 "outline.outlineFill.solidFill.color"로 설정합니다.

속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하되 필드 자체는 설정하지 않습니다.

UpdateVideoPropertiesRequest

Video의 속성을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "videoProperties": {
    object (VideoProperties)
  },
  "fields": string
}
필드
objectId

string

업데이트가 적용되는 동영상의 객체 ID입니다.

videoProperties

object (VideoProperties)

업데이트할 동영상 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 videoProperties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 동영상 윤곽선 색상을 업데이트하려면 fields를 "outline.outlineFill.solidFill.color"로 설정합니다.

속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하되 필드 자체는 설정하지 않습니다.

UpdatePagePropertiesRequest

Page의 속성을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "pageProperties": {
    object (PageProperties)
  },
  "fields": string
}
필드
objectId

string

업데이트가 적용되는 페이지의 객체 ID입니다.

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

테이블의 객체 ID입니다.

tableRange

object (TableRange)

업데이트가 적용되는 테이블의 하위 집합을 나타내는 테이블 범위입니다. 테이블 범위를 지정하지 않으면 업데이트가 전체 테이블에 적용됩니다.

tableCellProperties

object (TableCellProperties)

업데이트할 테이블 셀 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 tableCellProperties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 표 셀 배경 단색 채우기 색상을 업데이트하려면 fields를 "tableCellBackgroundFill.solidFill.color"로 설정합니다.

속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하되 필드 자체는 설정하지 않습니다.

TableRange

테이블 범위는 테이블의 하위 집합에 대한 참조를 나타냅니다.

테이블 범위로 지정된 셀이 반드시 직사각형을 형성하지는 않는다는 점에 유의해야 합니다. 예를 들어 마지막 행의 모든 셀이 병합된 3x3 표가 있다고 가정해 보겠습니다. 테이블은 다음과 같습니다. 

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

위치 = (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

업데이트가 적용되는 행의 객체 ID입니다.

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

글머리기호를 추가할 텍스트가 포함된 도형 또는 표의 객체 ID입니다.

cellLocation

object (TableCellLocation)

수정할 텍스트가 표 셀에 있는 경우 선택사항인 표 셀 위치입니다. 있는 경우 objectId는 테이블을 참조해야 합니다.

textRange

object (Range)

TextElement 색인을 기반으로 글머리 기호 사전 설정을 적용할 텍스트 범위입니다.

bulletPreset

enum (BulletGlyphPreset)

사용할 글리프 유형입니다. 기본값은 BULLET_DISC_CIRCLE_SQUARE 사전 설정입니다.

BulletGlyphPreset

텍스트 목록의 글머리기호 글리프의 사전 설정된 패턴입니다.

이러한 패턴은 다음과 같은 유형의 글머리 기호를 사용합니다.

  • ARROW : 유니코드 U+2794 코드 포인트에 해당하는 화살표
  • ARROW3D : 3D 음영 처리된 화살표로, 유니코드 U+27a2 코드 포인트에 해당합니다.
  • CHECKBOX : 유니코드 U+274f 코드 포인트에 해당하는 중공 사각형
  • CIRCLE : 유니코드 U+25cb 코드 포인트에 해당하는 중공 원
  • DIAMOND : 유니코드 U+25c6 코드 포인트에 해당하는 솔리드 다이아몬드
  • DIAMONDX : 'x'가 있는 다이아몬드로, 유니코드 U+2756 코드 포인트에 해당합니다.
  • HOLLOWDIAMOND : 유니코드 U+25c7 코드 포인트에 해당하는 중공 다이아몬드
  • DISC : 유니코드 U+25cf 코드 포인트에 해당하는 솔리드 원입니다.
  • SQUARE : 유니코드 U+25a0 코드 포인트에 해당하는 솔리드 정사각형
  • STAR : 별표로, 유니코드 U+2605 코드 포인트에 해당합니다.
  • ALPHA : 'a', 'b', 'c'와 같은 소문자입니다.
  • UPPERALPHA : 'A', 'B', 'C'와 같은 대문자입니다.
  • DIGIT : 숫자(예: '1', '2', '3')입니다.
  • ZERODIGIT : '01', '02', '03'과 같이 단일 숫자 앞에 0이 접두사로 추가된 숫자입니다. 숫자가 2자리 이상이면 앞에 0이 붙지 않습니다.
  • ROMAN : 'i', 'ii', 'iii'와 같은 소문자 로마 숫자입니다.
  • UPPERROMAN : 'I', 'II', 'III'와 같은 대문자 로마 숫자입니다.
  • LEFTTRIANGLE : 왼쪽을 가리키는 삼각형으로, 유니코드 U+25c4 코드 포인트에 해당합니다.
열거형
BULLET_DISC_CIRCLE_SQUARE 첫 번째 3개 목록 중첩 수준에 DISC, CIRCLE, SQUARE 글머리 기호 글리프가 있는 글머리기호 목록
BULLET_DIAMONDX_ARROW3D_SQUARE 첫 번째 3개 목록 중첩 수준에 DIAMONDX, ARROW3D, SQUARE 글머리 기호 글리프가 있는 글머리기호 목록
BULLET_CHECKBOX 모든 목록 중첩 수준에 CHECKBOX 글꼴로 된 글머리기호가 있는 글머리기호 목록입니다.
BULLET_ARROW_DIAMOND_DISC 첫 번째 3개 목록 중첩 수준에 ARROW, DIAMOND, DISC 글머리 기호 글리프가 있는 글머리기호 목록
BULLET_STAR_CIRCLE_SQUARE 첫 번째 3개 목록 중첩 수준에 STAR, CIRCLE, SQUARE 글머리 기호 글리프가 있는 글머리기호 목록
BULLET_ARROW3D_CIRCLE_SQUARE 첫 번째 3개 목록 중첩 수준에 ARROW3D, CIRCLE, SQUARE 글머리 기호 글리프가 있는 글머리기호 목록
BULLET_LEFTTRIANGLE_DIAMOND_DISC 첫 번째 3개 목록 중첩 수준에 LEFTTRIANGLE, DIAMOND, DISC 글머리 기호 글리프가 있는 글머리기호 목록
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE 첫 번째 3개 목록 중첩 수준에 DIAMONDX, HOLLOWDIAMOND, SQUARE 글머리 기호 글리프가 있는 글머리기호 목록
BULLET_DIAMOND_CIRCLE_SQUARE 첫 번째 3개 목록 중첩 수준에 DIAMOND, CIRCLE, SQUARE 글머리 기호 글리프가 있는 글머리기호 목록
NUMBERED_DIGIT_ALPHA_ROMAN DIGIT, ALPHA, ROMAN 숫자 글리프로 표시된 번호 목록으로, 처음 3개의 목록 중첩 수준에 마침표(.)가 뒤에 옵니다.
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS DIGIT, ALPHA, ROMAN 숫자 글리프가 있는 번호 목록으로, 첫 번째 3개 목록 중첩 수준에 적용되며 괄호가 뒤에 옵니다.
NUMBERED_DIGIT_NESTED DIGIT 숫자 글리프가 마침표로 구분된 번호 목록으로, 각 중첩 수준에서 이전 중첩 수준의 글리프를 접두사로 사용합니다. 예: '1.' '1.1.', '2.', '2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN UPPERALPHA, ALPHA, ROMAN 숫자 글리프로 표시된 번호 목록으로, 처음 3개의 목록 중첩 수준에 마침표(.)가 뒤에 옵니다.
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT UPPERROMAN, UPPERALPHA, DIGIT 숫자 글리프로 표시된 번호 목록으로, 처음 3개의 목록 중첩 수준에 마침표(.)가 뒤에 옵니다.
NUMBERED_ZERODIGIT_ALPHA_ROMAN ZERODIGIT, ALPHA, ROMAN 숫자 글리프로 표시된 번호 목록으로, 처음 3개의 목록 중첩 수준에 마침표(.)가 뒤에 옵니다.

ReplaceAllShapesWithImageRequest

지정된 기준과 일치하는 모든 도형을 제공된 이미지로 바꿉니다.

도형을 대체하는 이미지는 프레젠테이션에 삽입된 후 직사각형이 되며 도형의 형태를 취하지 않습니다.

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)

replace 메서드

지원 중단됨 : 대신 imageReplaceMethod를 사용하세요.

replaceMethod와 imageReplaceMethod를 모두 지정하면 imageReplaceMethod가 우선 적용됩니다.

imageReplaceMethod

enum (ImageReplaceMethod)

이미지 교체 메서드

replaceMethod와 imageReplaceMethod를 모두 지정하면 imageReplaceMethod가 우선 적용됩니다.

imageReplaceMethod의 값을 지정하지 않고 replaceMethod의 값을 지정하면 지정된 replaceMethod 값이 사용됩니다.

둘 중 하나를 지정하지 않으면 CENTER_INSIDE가 사용됩니다.

pageObjectIds[]

string

비어 있지 않은 경우 일치를 지정된 페이지의 페이지 요소로만 제한합니다.

notes page 또는 notes master의 페이지 객체 ID가 제공되거나 해당 객체 ID의 페이지가 프레젠테이션에 없는 경우 400 Bad Request 오류를 반환합니다.

공용체 필드 criteria입니다. 도형을 교체하기 위해 도형이 일치해야 하는 기준입니다. criteria는 다음 중 하나여야 합니다.
containsText

object (SubstringMatchCriteria)

이 요청을 설정하면 지정된 텍스트가 포함된 모든 도형이 대체됩니다.

공용체 필드 image_source입니다. 이미지 소스의 종류입니다. image_source는 다음 중 하나여야 합니다.
imageUrl

string

이미지 URL입니다.

이미지는 삽입 시 한 번 가져오고 사본은 프레젠테이션 내부에 표시되도록 저장됩니다. 이미지는 크기가 50MB 미만이어야 하며 25메가픽셀을 초과할 수 없으며 PNG, JPEG, GIF 형식 중 하나여야 합니다.

제공된 URL의 길이는 최대 2KB입니다. URL 자체는 이미지와 함께 저장되며 Image.source_url 필드를 통해 노출됩니다.

ReplaceMethod

replace 메서드

열거형
CENTER_INSIDE 원래 도형의 경계 내에 들어맞도록 이미지를 크기 조정하고 가운데에 배치하며 이미지의 가로세로 비율을 유지합니다. 렌더링된 이미지 크기가 도형 크기보다 작을 수 있습니다. 지정되지 않은 경우 기본 메서드입니다.
CENTER_CROP 원래 도형의 경계를 채우도록 이미지를 크기 조절하고 가운데에 배치합니다. 도형을 채우기 위해 이미지가 잘릴 수 있습니다. 렌더링된 이미지의 크기는 원래 도형의 크기와 동일합니다.

ImageReplaceMethod

이미지 교체 메서드

열거형
IMAGE_REPLACE_METHOD_UNSPECIFIED 지정되지 않은 이미지 교체 방법입니다. 이 값은 사용하면 안 됩니다.
CENTER_INSIDE 원래 도형의 경계 내에 들어맞도록 이미지를 크기 조정하고 가운데에 배치하며 이미지의 가로세로 비율을 유지합니다. 렌더링된 이미지 크기가 도형 크기보다 작을 수 있습니다. 지정되지 않은 경우 기본 메서드입니다.
CENTER_CROP 원래 도형의 경계를 채우도록 이미지를 크기 조절하고 가운데에 배치합니다. 도형을 채우기 위해 이미지가 잘릴 수 있습니다. 렌더링된 이미지 크기는 원래 도형과 동일합니다.

DuplicateObjectRequest

슬라이드 또는 페이지 요소를 복제합니다.

슬라이드를 복제하면 지정된 슬라이드 바로 뒤에 복제된 슬라이드가 생성됩니다. 페이지 요소를 복제하면 복제된 요소가 원본과 동일한 위치에 동일한 페이지에 배치됩니다.

JSON 표현 
{
  "objectId": string,
  "objectIds": {
    string: string,
    ...
  }
}
필드
objectId

string

중복할 객체의 ID입니다.

objectIds

map (key: string, value: string)

복제되는 객체에 다른 객체가 포함될 수 있습니다(예: 슬라이드 또는 그룹 페이지 요소를 복제할 때). 이 맵은 중복 객체의 ID가 생성되는 방식을 정의합니다. 키는 원본 객체의 ID이고 값은 해당하는 중복 객체에 할당될 ID입니다. 소스 객체의 중복 ID도 이 맵에 지정할 수 있습니다. 이때 동일한 objectId 필드 값을 키로, 새로 원하는 ID를 값으로 사용합니다.

모든 키는 프레젠테이션의 기존 ID와 일치해야 합니다. 모든 값은 프레젠테이션에서 고유해야 하며 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]와 일치). 나머지 문자는 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. 새 ID의 길이는 5자 이상 50자 이하여야 합니다.

소스 객체의 ID가 지도에서 생략되면 새 랜덤 ID가 할당됩니다. 맵이 비어 있거나 설정되지 않은 경우 모든 중복 객체에 새 랜덤 ID가 할당됩니다.

UpdateTextStyleRequest

Shape 또는 Table에서 텍스트의 스타일을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (TextStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
필드
objectId

string

스타일을 지정할 텍스트가 포함된 도형 또는 표의 객체 ID입니다.

cellLocation

object (TableCellLocation)

스타일을 지정할 텍스트가 포함된 테이블의 셀 위치입니다. objectId가 표를 참조하는 경우 cellLocation에 값이 있어야 합니다. 그렇지 않으면 안 됩니다.

style

object (TextStyle)

텍스트에 설정할 스타일입니다.

특정 스타일의 값이 상위 스타일의 값과 일치하면 해당 스타일이 상속되도록 설정됩니다.

특정 텍스트 스타일을 변경하면 Slides 편집기의 동작을 반영하기 위한 다른 변경사항이 발생할 수 있습니다. 자세한 내용은 TextStyle 문서를 참고하세요.

textRange

object (Range)

스타일을 지정할 텍스트 범위입니다.

인접한 줄바꿈을 포함하도록 범위가 확장될 수 있습니다.

범위에 목록에 속한 단락이 완전히 포함된 경우 단락의 글머리 기호도 일치하는 텍스트 스타일로 업데이트됩니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 style는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 텍스트 스타일을 굵게로 업데이트하려면 fields를 "bold"로 설정합니다.

속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하되 필드 자체는 설정하지 않습니다.

ReplaceAllShapesWithSheetsChartRequest

지정된 기준과 일치하는 모든 도형을 제공된 Google Sheets 차트로 바꿉니다. 원래 도형의 경계 내에 들어맞도록 차트의 크기가 조정되고 가운데에 배치됩니다.

참고: 도형을 차트로 대체하려면 spreadsheets.readonly, spreadsheets, drive.readonly 또는 drive OAuth 범위 중 하나 이상이 필요합니다.

JSON 표현 
{
  "containsText": {
    object (SubstringMatchCriteria)
  },
  "spreadsheetId": string,
  "chartId": integer,
  "linkingMode": enum (LinkingMode),
  "pageObjectIds": [
    string
  ]
}
필드
containsText

object (SubstringMatchCriteria)

도형을 교체하기 위해 도형이 일치해야 하는 기준입니다. 이 요청은 지정된 텍스트가 포함된 모든 도형을 대체합니다.

spreadsheetId

string

차트가 포함된 Google Sheets 스프레드시트의 ID입니다.

chartId

integer

Google Sheets 스프레드시트의 특정 차트 ID입니다.

linkingMode

enum (LinkingMode)

차트가 소스 스프레드시트에 연결되는 모드입니다. 지정하지 않으면 차트가 연결되지 않은 이미지가 됩니다.

pageObjectIds[]

string

비어 있지 않은 경우 일치를 지정된 페이지의 페이지 요소로만 제한합니다.

notes page 또는 notes master의 페이지 객체 ID가 제공되거나 해당 객체 ID의 페이지가 프레젠테이션에 없는 경우 400 Bad Request 오류를 반환합니다.

LinkingMode

차트가 소스 스프레드시트에 연결되는 모드입니다.

열거형
NOT_LINKED_IMAGE 차트가 소스 스프레드시트와 연결되어 있지 않으므로 업데이트할 수 없습니다. 연결되지 않은 차트는 이미지로 삽입됩니다.
LINKED 차트를 연결하면 업데이트할 수 있으며 다른 공동작업자에게는 스프레드시트 링크가 표시됩니다.

DeleteParagraphBulletsRequest

지정된 텍스트 색인 range와 겹치는 모든 단락에서 글머리기호를 삭제합니다.

각 단락의 중첩 수준은 해당 단락의 시작 부분에 들여쓰기를 추가하여 시각적으로 유지됩니다.

JSON 표현 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "textRange": {
    object (Range)
  }
}
필드
objectId

string

글머리기호를 삭제할 텍스트가 포함된 도형 또는 표의 객체 ID입니다.

cellLocation

object (TableCellLocation)

수정할 텍스트가 표 셀에 있는 경우 선택사항인 표 셀 위치입니다. 있는 경우 objectId는 테이블을 참조해야 합니다.

textRange

object (Range)

TextElement 색인을 기준으로 글머리기호를 삭제할 텍스트 범위입니다.

UpdateParagraphStyleRequest

지정된 텍스트 색인 범위와 겹치는 Shape 또는 Table 내의 모든 단락의 스타일을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "cellLocation": {
    object (TableCellLocation)
  },
  "style": {
    object (ParagraphStyle)
  },
  "textRange": {
    object (Range)
  },
  "fields": string
}
필드
objectId

string

스타일을 지정할 텍스트가 포함된 도형 또는 표의 객체 ID입니다.

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

테이블의 객체 ID입니다.

tableRange

object (TableRange)

업데이트가 적용되는 테이블의 하위 집합을 나타내는 테이블 범위입니다. 테이블 범위를 지정하지 않으면 업데이트가 전체 테이블에 적용됩니다.

borderPosition

enum (BorderPosition)

업데이트를 적용할 표 범위의 테두리 위치입니다. 테두리 위치를 지정하지 않으면 업데이트가 테이블 범위의 모든 테두리에 적용됩니다.

tableBorderProperties

object (TableBorderProperties)

업데이트할 표 테두리 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 tableBorderProperties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 표 테두리 단색 채우기 색상을 업데이트하려면 fields를 "tableBorderFill.solidFill.color"로 설정합니다.

속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하되 필드 자체는 설정하지 않습니다.

BorderPosition

테이블 테두리 위치입니다.

열거형
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

테이블의 객체 ID입니다.

columnIndices[]

integer

업데이트할 열을 지정하는 0부터 시작하는 색인 목록입니다. 색인이 제공되지 않으면 테이블의 모든 열이 업데이트됩니다.

tableColumnProperties

object (TableColumnProperties)

업데이트할 테이블 열 속성입니다.

요청의 tableColumnProperties#columnWidth 값이 406,400 EMU (32 포인트)보다 작으면 400 잘못된 요청 오류가 반환됩니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 tableColumnProperties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 열 너비를 업데이트하려면 fields를 "columnWidth"로 설정합니다.

'columnWidth'가 필드 마스크에 포함되어 있지만 속성이 설정되지 않은 경우 열 너비는 기본적으로 406,400 EMU (32포인트)로 설정됩니다.

UpdateTableRowPropertiesRequest

Table 행의 속성을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "rowIndices": [
    integer
  ],
  "tableRowProperties": {
    object (TableRowProperties)
  },
  "fields": string
}
필드
objectId

string

테이블의 객체 ID입니다.

rowIndices[]

integer

업데이트할 행을 지정하는 0부터 시작하는 색인 목록입니다. 색인을 제공하지 않으면 테이블의 모든 행이 업데이트됩니다.

tableRowProperties

object (TableRowProperties)

업데이트할 테이블 행 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 tableRowProperties는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 최소 행 높이를 업데이트하려면 fields를 "minRowHeight"로 설정합니다.

'minRowHeight'가 필드 마스크에 포함되어 있지만 속성이 설정되지 않은 경우 최소 행 높이는 기본적으로 0으로 설정됩니다.

MergeTableCellsRequest

Table의 셀을 병합합니다.

JSON 표현 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
필드
objectId

string

테이블의 객체 ID입니다.

tableRange

object (TableRange)

병합할 테이블의 셀을 지정하는 테이블 범위입니다.

병합되는 셀의 모든 텍스트가 연결되어 범위의 왼쪽 상단 ('헤드') 셀에 저장됩니다. 범위가 직사각형이 아닌 경우 (범위가 이미 병합된 셀을 포함하는 경우에 발생할 수 있음) 400 잘못된 요청 오류가 반환됩니다.

UnmergeTableCellsRequest

Table의 셀 병합을 취소합니다.

JSON 표현 
{
  "objectId": string,
  "tableRange": {
    object (TableRange)
  }
}
필드
objectId

string

테이블의 객체 ID입니다.

tableRange

object (TableRange)

병합을 해제할 테이블의 셀을 지정하는 테이블 범위입니다.

이 범위의 모든 병합된 셀이 병합 해제되며 이미 병합 해제된 셀은 영향을 받지 않습니다. 범위에 병합된 셀이 없으면 요청이 아무것도 하지 않습니다. 병합된 셀에 텍스트가 있는 경우 텍스트는 병합되지 않은 셀의 결과 블록 왼쪽 상단 ('헤드') 셀에 유지됩니다.

GroupObjectsRequest

객체를 그룹화하여 객체 그룹을 만듭니다. 예를 들어 그룹 PageElements는 모든 하위 요소와 동일한 페이지에 Group를 만듭니다.

JSON 표현 
{
  "groupObjectId": string,
  "childrenObjectIds": [
    string
  ]
}
필드
groupObjectId

string

생성할 그룹의 사용자 제공 객체 ID입니다.

ID를 지정하는 경우 프레젠테이션의 모든 페이지와 페이지 요소 간에 고유해야 합니다. ID는 영숫자 문자 또는 밑줄로 시작해야 합니다 (정규식 [a-zA-Z0-9_]과 일치). 나머지 문자는 영숫자 문자, 밑줄, 하이픈 또는 콜론 (정규식 [a-zA-Z0-9_-:]과 일치)을 포함할 수 있습니다. ID의 길이는 5자 이상 50자 이하여야 합니다.

ID를 지정하지 않으면 고유한 ID가 생성됩니다.

childrenObjectIds[]

string

그룹화할 객체의 객체 ID입니다.

페이지 요소만 그룹화할 수 있습니다. 같은 페이지에 아직 다른 그룹에 속하지 않은 페이지 요소가 2개 이상 있어야 합니다. videos, tables, placeholders와 같은 일부 페이지 요소는 그룹화할 수 없습니다.

UngroupObjectsRequest

groups와 같은 객체의 그룹을 해제합니다.

JSON 표현 
{
  "objectIds": [
    string
  ]
}
필드
objectIds[]

string

그룹화 해제할 객체의 객체 ID입니다.

다른 groups 내에 있지 않은 groups만 그룹 해제할 수 있습니다. 모든 그룹이 동일한 페이지에 있어야 합니다. 그룹 자체가 삭제됩니다. 모든 하위 요소의 시각적 크기와 위치는 유지됩니다.

UpdatePageElementAltTextRequest

page element의 대체 텍스트 제목 또는 설명을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "title": string,
  "description": string
}
필드
objectId

string

업데이트가 적용되는 페이지 요소의 객체 ID입니다.

title

string

페이지 요소의 업데이트된 대체 텍스트 제목입니다. 설정하지 않으면 기존 값이 유지됩니다. 제목은 스크린 리더 및 기타 접근성 인터페이스에 노출됩니다. 페이지 요소의 콘텐츠와 관련된 사람이 읽을 수 있는 값만 사용하세요.

description

string

페이지 요소의 업데이트된 대체 텍스트 설명입니다. 설정하지 않으면 기존 값이 유지됩니다. 설명은 스크린 리더 및 기타 접근성 인터페이스에 노출됩니다. 페이지 요소의 콘텐츠와 관련된 사람이 읽을 수 있는 값만 사용하세요.

ReplaceImageRequest

기존 이미지를 새 이미지로 바꿉니다.

이미지를 교체하면 기존 이미지에서 일부 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

대체할 기존 이미지의 ID입니다. ID는 get 요청의 응답에서 가져올 수 있습니다.

imageReplaceMethod

enum (ImageReplaceMethod)

교체 방법

공용체 필드 image_source입니다. 이미지 소스의 종류입니다. image_source는 다음 중 하나여야 합니다.
url

string

이미지 URL입니다.

이미지는 삽입 시 한 번 가져오고 사본은 프레젠테이션 내부에 표시되도록 저장됩니다. 이미지는 50MB 미만이어야 하며 25메가픽셀을 초과할 수 없으며 PNG, JPEG 또는 GIF 형식이어야 합니다.

제공된 URL의 길이는 2KB를 초과할 수 없습니다. URL은 이미지와 함께 저장되며 Image.source_url 필드를 통해 노출됩니다.

UpdateSlidePropertiesRequest

슬라이드의 속성을 업데이트합니다.

JSON 표현 
{
  "objectId": string,
  "slideProperties": {
    object (SlideProperties)
  },
  "fields": string
}
필드
objectId

string

업데이트가 적용되는 슬라이드의 객체 ID입니다.

slideProperties

object (SlideProperties)

업데이트할 슬라이드 속성입니다.

fields

string (FieldMask format)

업데이트해야 하는 필드입니다.

하나 이상의 필드를 지정해야 합니다. 루트 'slideProperties'는 암시되며 지정해서는 안 됩니다. 단일 "*"는 모든 필드를 나열하는 방법으로 사용할 수 있습니다.

예를 들어 슬라이드 건너뛰기 여부를 업데이트하려면 fields를 "isSkipped"로 설정합니다.

속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하되 필드 자체는 설정하지 않습니다.

UpdatePageElementsZOrderRequest

페이지 요소의 Z 순서를 업데이트합니다. Z 순서는 페이지의 요소를 뒤에서 앞으로 순서대로 정렬한 것입니다. 앞의 페이지 요소가 뒤에 있는 요소를 가릴 수 있습니다.

JSON 표현 
{
  "pageElementObjectIds": [
    string
  ],
  "operation": enum (ZOrderOperation)
}
필드
pageElementObjectIds[]

string

업데이트할 페이지 요소의 객체 ID입니다.

모든 페이지 요소가 동일한 페이지에 있어야 하며 그룹화되어서는 안 됩니다.

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

업데이트가 적용되는 행의 객체 ID입니다.

'커넥터'임을 나타내는 category가 있는 선만 업데이트할 수 있습니다.

카테고리를 업데이트하면 노선 경로가 변경될 수 있습니다.

lineCategory

enum (LineCategory)

업데이트할 선 카테고리입니다.

정확한 line type는 업데이트할 카테고리와 다른 페이지 요소에 연결되도록 라우팅되는 방식에 따라 결정됩니다.

RerouteLineRequest

연결된 페이지 요소에서 가장 가까운 두 연결 사이트에 연결되도록 line의 경로를 다시 변경합니다.

JSON 표현 
{
  "objectId": string
}
필드
objectId

string

경로를 변경할 선의 객체 ID입니다.

'연결자'임을 나타내는 category가 있는 선만 경로를 변경할 수 있습니다. 선의 시작 연결과 끝 연결은 서로 다른 페이지 요소에 있어야 합니다.