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 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)

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

  • 이전 슬라이드 색인의 마스터입니다.
  • insertionIndex가 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 단일 열에 정렬된 제목 하나와 본문 하나가 있는 레이아웃
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인 제목 자리표시자와 색인이 0인 본문 자리표시자가 있습니다.

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부터 시작하며 문자열의 시작부터 계산됩니다. 유니코드 그래핀 클러스터 내 삽입을 방지하기 위해 색인이 조정될 수 있습니다. 이 경우 텍스트는 그래핀 클러스터 바로 뒤에 삽입됩니다.

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 잘못된 요청 오류가 반환됩니다.

통합 필드 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 미만이어야 하고, 2, 500만 화소를 초과할 수 없으며, 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-zA-Z0-9_] 로 시작하고 그 뒤에 다음 문자[a-zA-Z0-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 : 유니코드 U+27a2 코드 포인트에 해당하는 3D 음영이 있는 화살표
  • 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 : 한 자리 숫자에 0이 접두사로 붙은 숫자입니다(예: '01', '02', '03'). 두 자리 이상의 숫자는 앞에 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 첫 3개 목록 중첩 수준에 DIGIT, ALPHA, ROMAN 숫자 글리프가 있고 그 뒤에 마침표가 오는 번호가 매겨진 목록
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS DIGIT, ALPHA, ROMAN 숫자 글리프가 처음 3개 목록 중첩 수준에 사용되고 괄호가 뒤에 오는 번호가 매겨진 목록
NUMBERED_DIGIT_NESTED 각 중첩 수준이 이전 중첩 수준의 글리프를 접두사로 사용하는 마침표로 구분된 DIGIT 숫자 글리프가 있는 번호가 매겨진 목록입니다. 예: '1.', '1.1.', '2.', '2.2.'.
NUMBERED_UPPERALPHA_ALPHA_ROMAN 첫 3개 목록 중첩 수준에 UPPERALPHA, ALPHA, ROMAN 숫자 글리프가 있고 그 뒤에 마침표가 오는 번호가 매겨진 목록
NUMBERED_UPPERROMAN_UPPERALPHA_DIGIT 첫 3개 목록 중첩 수준에 UPPERROMAN, UPPERALPHA, DIGIT 숫자 글리프가 있고 그 뒤에 마침표가 오는 번호가 매겨진 목록
NUMBERED_ZERODIGIT_ALPHA_ROMAN 첫 3개 목록 중첩 수준에 ZERODIGIT, ALPHA, ROMAN 숫자 글리프가 있고 그 뒤에 마침표가 오는 번호가 매겨진 목록

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 잘못된 요청 오류가 반환됩니다.

통합 필드 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 잘못된 요청 오류가 반환됩니다.

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는 가져오기 요청의 응답에서 가져올 수 있습니다.

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-order는 페이지의 요소를 뒤에서 앞으로 정렬한 순서입니다. 앞에 있는 페이지 요소가 뒤에 있는 요소를 가릴 수 있습니다.

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

string

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

모든 페이지 요소는 동일한 페이지에 있어야 하며 그룹화되지 않아야 합니다.

operation

enum (ZOrderOperation)

페이지 요소에 적용할 Z-order 작업입니다.

여러 페이지 요소에 작업을 적용할 때 작업 전 이러한 페이지 요소 내의 상대 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가 있는 선만 다시 라우팅할 수 있습니다. 선의 시작 연결과 종료 연결은 서로 다른 페이지 요소에 있어야 합니다.