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-order를 업데이트합니다.

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)

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

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

현재 마스터에서 LayoutReference를 찾을 수 없는 경우 400 잘못된 요청 오류가 반환됩니다.

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

placeholderIdMappings[]

object (LayoutPlaceholderIdMapping)

레이아웃의 placeholder(s)에서 지정된 레이아웃의 슬라이드에 생성된 자리표시자로 연결되는 객체 ID 매핑의 선택적 목록입니다. 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

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

사전 정의된 레이아웃

사전 정의된 레이아웃 유형 프레젠테이션에서 흔히 사용되는 레이아웃입니다. 그러나 이러한 레이아웃은 삭제되었거나 사용된 테마의 일부가 아닐 수 있으므로 현재 마스터에 있다고 보장할 수 없습니다. 또한 각 레이아웃의 자리표시자가 변경되었을 수도 있습니다.

열거형
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 큰 제목이 있는 레이아웃

레이아웃 장소 홀더 매핑

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

슬라이드에 적용될 레이아웃의 자리표시자입니다. typeindex만 있으면 됩니다. 예를 들어 사전 정의된 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)

도형 유형입니다.

페이지 요소 속성

페이지 요소의 일반적인 속성입니다.

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

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

테이블의 열 수입니다.

텍스트 삽입 요청

도형 또는 표 셀에 텍스트를 삽입합니다.

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

string

텍스트를 삽입할 도형 또는 테이블의 객체 ID입니다.

cellLocation

object (TableCellLocation)

텍스트를 표 셀에 삽입해야 하는 경우 선택할 수 있는 표 셀 위치입니다. 객체 ID가 있으면 테이블을 참조해야 합니다.

text

string

삽입할 텍스트입니다.

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

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

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

insertionIndex

integer

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

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

테이블 행 삽입 요청

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

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)

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

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

DeleteTableColumnRequest

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

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

string

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

cellLocation

object (TableCellLocation)

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

이 셀 범위에 있는 열이 삭제됩니다. 병합된 셀인 경우 여러 열이 삭제됩니다. 이 삭제 후에도 테이블에 남아 있는 열이 없으면 전체 테이블이 삭제됩니다.

모든 텍스트 요청 교체

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

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

하위 문자열 일치 기준

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

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

string

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

matchCase

boolean

검색의 대소문자 사용 여부를 나타냅니다.

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

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

적용 모드

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

열거형
APPLY_MODE_UNSPECIFIED 지정되지 않은 모드입니다.
RELATIVE 새 AffineTransform 매트릭스를 기존 행렬에 적용하고 그 결과인 연결 조합으로 대체합니다.
ABSOLUTE 기존 AffineTransform 매트릭스를 새로운 행렬로 대체합니다.

SlidesSlideRequestRequest

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

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

string

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

insertionIndex

integer

이동이 시작되기 전 슬라이드 정렬을 기준으로 슬라이드를 삽입할 색인입니다. 프레젠테이션의 슬라이드 수와 0 사이여야 합니다.

삭제 텍스트 요청

도형 또는 표 셀의 텍스트를 삭제합니다.

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

string

텍스트를 삭제할 도형 또는 테이블의 객체 ID입니다.

cellLocation

object (TableCellLocation)

표 셀에서 텍스트를 삭제할 경우 선택할 수 있는 표 셀 위치입니다. 객체 ID가 있으면 테이블을 참조해야 합니다.

textRange

object (Range)

삭제할 텍스트 범위(TextElement 색인 기준)

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

단락 경계를 가로지르는 텍스트를 삭제하면 두 단락이 병합되므로 단락 스타일과 목록이 변경될 수 있습니다.

서로게이트 쌍의 코드 단위가 하나뿐인 범위는 두 코드 단위를 모두 포함하도록 확장됩니다.

범위

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

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

integer

컬렉션 시작 부분의 선택적 0 기반 색인입니다. FIXED_RANGEFROM_START_INDEX 범위에 필요합니다.

endIndex

integer

컬렉션 끝의 0부터 시작하는 선택적 색인입니다. FIXED_RANGE 범위에 필요합니다.

type

enum (Type)

범위 유형입니다.

유형

범위의 유형입니다.

열거형
RANGE_TYPE_UNSPECIFIED 지정되지 않은 범위 유형입니다. 이 값은 사용할 수 없습니다.
FIXED_RANGE 고정된 범위 startIndexendIndex를 모두 지정해야 합니다.
FROM_START_INDEX startIndex에서 범위를 시작하고 컬렉션이 끝날 때까지 계속합니다. endIndex은 지정하지 않아야 합니다.
ALL 범위를 컬렉션의 전체 길이로 설정합니다. startIndexendIndex 모두 지정해서는 안 됩니다.

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 필드를 통해 노출됩니다.

동영상 만들기 요청

동영상을 만듭니다.

참고: Google 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 헤더에 추가해야 할 수 있습니다. 자세한 내용은 리소스 키를 사용하여 링크 공유 파일에 액세스를 참조하세요.

Sheets 시트 요청 만들기

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

참고: 차트를 만들려면 스프레드 시트.readonly, 스프레드시트, drive.readonly, drive.file 또는 드라이브 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)

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

연결 모드

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

열거형
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는 카테고리 및 다른 페이지 요소에 연결하기 위해 카테고리가 라우팅되는 방식에 따라 결정됩니다.

categorylineCategory를 모두 지정하면 category이 우선 적용됩니다.

category

enum (LineCategory)

만들 선의 카테고리입니다.

생성된 정확한 line type는 카테고리 및 다른 페이지 요소에 연결하기 위해 카테고리가 라우팅되는 방식에 따라 결정됩니다.

categorylineCategory를 모두 지정하면 category이 우선 적용됩니다.

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

둘 다 지정하지 않으면 STRAIGHT이 사용됩니다.

카테고리

선 카테고리입니다.

열거형
STRAIGHT 직선 커넥터(직선 커넥터 1 포함) 를 지정하지 않으면 기본 카테고리입니다.
BENT 구부러진 커넥터(2-5 구부러진 커넥터 포함)
CURVED 곡선 커넥터 2~5를 포함한 곡선 커넥터

RefreshSheetsChartRequest 클래스의 생성자

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

참고: 차트를 새로 고치려면 스프레드시트.읽기 전용, 스프레드시트, 드라이브.읽기 전용 또는 드라이브 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"로 설정합니다.

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

테이블 범위

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

표 범위에 의해 지정된 셀이 반드시 직사각형인 것은 아닙니다. 예를 들어 마지막 행의 모든 셀이 함께 병합되는 3x3 테이블이 있다고 가정해 보겠습니다. 표는 다음과 같습니다.

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

location = (0, 0), row span = 3, column span = 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"로 설정합니다.

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

CreateParagraphBullet요청

지정된 텍스트 색인 범위와 겹치는 모든 단락에 글머리 기호를 만듭니다.

각 단락 앞에 중첩된 탭을 집계하여 각 단락의 중첩 수준이 결정됩니다. 글머리기호 및 해당 단락 사이의 불필요한 공백이 발생하지 않도록 이 요청은 이 선행 탭을 삭제합니다. 이렇게 하면 텍스트 일부의 색인이 변경될 수 있습니다.

업데이트 중인 단락 바로 앞에 있는 단락이 일치하는 미리 설정이 있는 목록에 있으면 업데이트 중인 단락이 이전 목록에 추가됩니다.

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

string

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

cellLocation

object (TableCellLocation)

수정할 텍스트가 표 셀에 있는 경우, 선택할 수 있는 표 셀 위치입니다. 객체 ID가 있으면 테이블을 참조해야 합니다.

textRange

object (Range)

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

bulletPreset

enum (BulletGlyphPreset)

사용할 글머리기호 글리프의 종류입니다. 기본값은 BULLET_DISC_CIRCLE_SQUARE 사전 설정입니다.

글머리기호 글리프 사전 설정

텍스트 목록의 글머리 기호 글리프 패턴을 미리 설정합니다.

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

  • ARROW: 유니코드 U+2794 코드 포인트에 해당하는 화살표
  • ARROW3D: 유니코드 U+27a2 코드 포인트에 해당하는 3D 음영이 있는 화살표
  • CHECKBOX: 유니코드 U+274f 코드 포인트에 해당하는 빈 정사각형입니다.
  • CIRCLE: 유니코드 U+25cb 코드 포인트에 해당하는 빈 원
  • DIAMOND : 유니코드 U+25c6 코드 포인트에 해당하는 다이아몬드입니다.
  • DIAMONDX: 유니코드 U+2756 코드 포인트에 해당하는 'x'가 있는 다이아몬드
  • 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')입니다. 자릿수가 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 처음 3개의 목록 중첩 수준과 그 뒤에 마침표가 오는 DIGIT, ALPHA, ROMAN 숫자 글리프가 포함된 번호가 매겨진 목록
NUMBERED_DIGIT_ALPHA_ROMAN_PARENS 처음 3개의 목록 중첩 수준에 대한 DIGIT, ALPHAROMAN 숫자 글리프, 이어서 괄호가 있는 번호 매기기 목록
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 숫자 글리프가 포함된 번호가 매겨진 목록

모든 도형으로 이미지 요청 대체

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

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

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를 사용하세요.

replaceMethodimageReplaceMethod를 모두 지정하면 imageReplaceMethod이 우선 적용됩니다.

imageReplaceMethod

enum (ImageReplaceMethod)

이미지 대체 메서드입니다.

replaceMethodimageReplaceMethod를 모두 지정하면 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

대체 메서드입니다.

열거형
CENTER_INSIDE 원래 도형의 경계에 맞게 이미지의 크기를 조정하고 중앙에 배치하며 이미지의 가로세로 비율을 유지합니다. 렌더링된 이미지의 크기가 도형의 크기보다 작을 수 있습니다. 지정하지 않으면 기본 메서드입니다.
CENTER_CROP 원래 도형의 경계를 채우도록 이미지의 크기를 조정하고 중앙에 배치합니다. 도형을 채우기 위해 이미지를 자를 수 있습니다. 이미지의 렌더링된 크기는 원래 도형의 크기와 동일합니다.

ImageReplace 메서드

이미지 대체 메서드입니다.

열거형
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와 일치해야 합니다. 모든 값은 프레젠테이션에서 고유해야 하며 영숫자 문자 또는 밑줄 (정규식 [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"로 설정합니다.

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

모든 도형 도형 바꾸기 차트 요청

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

참고: 도형을 차트로 바꾸려면 스프레드시트.읽기 전용, 스프레드시트, 드라이브.읽기 전용 또는 드라이브 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 잘못된 요청 오류를 반환합니다.

연결 모드

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

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

DeleteParagraphBullet요청

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

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

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

string

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

cellLocation

object (TableCellLocation)

수정할 텍스트가 표 셀에 있는 경우, 선택할 수 있는 표 셀 위치입니다. 객체 ID가 있으면 테이블을 참조해야 합니다.

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"로 설정합니다.

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

테두리 위치

표 테두리 위치입니다.

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

병합되지 않은 테이블 셀 요청

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 같은 일부 페이지 요소는 그룹화할 수 없습니다.

그룹 삭제 요청

객체(예: 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

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

이미지 교체 요청

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

이미지를 바꾸면 기존 이미지에서 일부 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-order는 페이지 요소를 앞뒤로 정렬합니다. 전면의 페이지 요소가 뒤에 있는 요소를 덮을 수 있습니다.

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

string

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

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

operation

enum (ZOrderOperation)

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

여러 페이지 요소에 작업을 적용할 때 해당 작업이 유지되기 전에 해당 페이지 요소 내의 상대적인 Z-order를 적용합니다.

ZOrderOperation

페이지 요소의 Z-order를 업데이트하는 작업입니다.

열거형
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은 업데이트할 카테고리와 다른 페이지 요소에 연결하기 위해 라우팅되는 방법을 기반으로 결정됩니다.

경로 변경 요청

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

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

string

다시 라우팅할 선의 객체 ID입니다.

'커넥터'임을 나타내는 category이 있는 선만 다시 라우팅될 수 있습니다. 선의 시작과 끝 연결은 다른 페이지 요소에 있어야 합니다.