요청
문서에 적용할 단일 업데이트입니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드
request 적용할 특정 요청입니다. 정확히 1개의 입력란이 필요합니다.
request
다음 중 하나여야 합니다.
|
|
replaceAllText
|
지정된 텍스트의 모든 인스턴스를 바꿉니다. |
insertText
|
지정된 위치에 텍스트를 삽입합니다. |
updateTextStyle
|
지정된 범위에서 텍스트 스타일을 업데이트합니다. |
createParagraphBullets
|
단락의 글머리기호를 만듭니다. |
deleteParagraphBullets
|
단락에서 글머리기호를 삭제합니다. |
createNamedRange
|
이름이 지정된 범위를 만듭니다. |
deleteNamedRange
|
이름이 지정된 범위를 삭제합니다. |
updateParagraphStyle
|
지정된 범위에서 단락 스타일을 업데이트합니다. |
deleteContentRange
|
문서에서 콘텐츠를 삭제합니다. |
insertInlineImage
|
지정된 위치에 인라인 이미지를 삽입합니다. |
insertTable
|
지정된 위치에 테이블을 삽입합니다. |
insertTableRow
|
테이블에 빈 행을 삽입합니다. |
insertTableColumn
|
테이블에 빈 열을 삽입합니다. |
deleteTableRow
|
테이블에서 행을 삭제합니다. |
deleteTableColumn
|
테이블에서 열을 삭제합니다. |
insertPageBreak
|
지정된 위치에 페이지 나누기를 삽입합니다. |
deletePositionedObject
|
문서에서 위치가 지정된 객체를 삭제합니다. |
updateTableColumnProperties
|
테이블의 열 속성을 업데이트합니다. |
updateTableCellStyle
|
표 셀의 스타일을 업데이트합니다. |
updateTableRowStyle
|
표의 행 스타일을 업데이트합니다. |
replaceImage
|
문서의 이미지를 대체합니다. |
updateDocumentStyle
|
문서의 스타일을 업데이트합니다. |
mergeTableCells
|
표의 셀을 병합합니다. |
unmergeTableCells
|
표의 셀 병합을 취소합니다. |
createHeader
|
헤더를 만듭니다. |
createFooter
|
바닥글을 만듭니다. |
createFootnote
|
각주를 만듭니다. |
replaceNamedRangeContent
|
이름이 지정된 범위의 콘텐츠를 바꿉니다. |
updateSectionStyle
|
지정된 범위의 섹션 스타일을 업데이트합니다. |
insertSectionBreak
|
지정된 위치에 섹션 나누기를 삽입합니다. |
deleteHeader
|
문서에서 헤더를 삭제합니다. |
deleteFooter
|
문서에서 바닥글을 삭제합니다. |
pinTableHeaderRows
|
테이블에 고정된 헤더 행 수를 업데이트합니다. |
ReplaceAllTextRequest
기준과 일치하는 모든 텍스트 인스턴스를 다음으로 바꿉니다.
replace text
JSON 표현 |
---|
{ "replaceText": string, "tabsCriteria": { object ( |
필드 | |
---|---|
replaceText
|
일치하는 텍스트를 대체할 텍스트입니다. |
tabsCriteria
|
선택사항입니다. 대체를 실행할 탭을 지정하는 데 사용되는 기준입니다. 생략하면 대체가 모든 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
공용체 필드
criteria 대체할 텍스트를 일치시키는 데 사용되는 기준입니다.
criteria
다음 중 하나여야 합니다.
|
|
containsText
|
문서에서 이 하위 문자열과 일치하는 텍스트를 찾습니다. |
SubstringMatchCriteria
문서의 특정 텍스트 문자열과 일치하는 기준입니다.
JSON 표현 |
---|
{ "text": string, "matchCase": boolean } |
필드 | |
---|---|
text
|
문서에서 검색할 텍스트입니다. |
matchCase
|
검색에 대소문자가 적용되는지 여부를 나타냅니다.
|
TabsCriteria
요청이 실행되는 탭을 지정하는 기준입니다.
JSON 표현 |
---|
{ "tabIds": [ string ] } |
필드 | |
---|---|
tabIds[]
|
요청이 실행되는 탭 ID 목록입니다. |
InsertTextRequest
지정된 위치에 텍스트를 삽입합니다.
JSON 표현 |
---|
{ "text": string, // Union field |
필드 | |
---|---|
text
|
삽입할 텍스트입니다.
줄바꿈 문자를 삽입하면 암시적으로 새 줄이 생성됩니다.
삽입된 텍스트의 텍스트 스타일은 자동으로 결정되며, 일반적으로 주변 텍스트의 스타일이 유지됩니다. 대부분의 경우 삽입된 텍스트의 텍스트 스타일은 삽입 색인 바로 앞에 있는 텍스트와 일치합니다. 일부 제어 문자 (U+0000-U+0008, U+000C-U+001F)와 유니코드 기본 다국어 비행기 전용 영역 (U+E000-U+F8FF)의 문자는 삽입된 텍스트에서 제거됩니다. |
공용체 필드
insertion_location 텍스트가 삽입될 위치입니다.
insertion_location
다음 중 하나여야 합니다.
|
|
location
|
문서의 특정 색인에 텍스트를 삽입합니다.
텍스트는 기존
|
endOfSegmentLocation
|
머리글, 바닥글, 각주 또는 문서 본문 끝에 텍스트를 삽입합니다. |
위치
문서의 특정 위치입니다.
JSON 표현 |
---|
{ "segmentId": string, "index": integer, "tabId": string } |
필드 | |
---|---|
segmentId
|
위치가 포함된 머리글, 바닥글 또는 각주의 ID입니다. 세그먼트 ID가 비어 있으면 문서의 본문을 나타냅니다. |
index
|
0부터 시작하는 색인으로, UTF-16 코드 단위로 표시됩니다.
색인은
|
tabId
|
위치가 속한 탭입니다. 생략하면 요청이 첫 번째 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
EndOfSegmentLocation
본문, 머리글, 바닥글 또는 각주의 끝 위치 위치는 문서 세그먼트의 마지막 줄바꿈 바로 앞에 있습니다.
JSON 표현 |
---|
{ "segmentId": string, "tabId": string } |
필드 | |
---|---|
segmentId
|
위치가 포함된 머리글, 바닥글 또는 각주의 ID입니다. 세그먼트 ID가 비어 있으면 문서의 본문을 나타냅니다. |
tabId
|
위치가 속한 탭입니다. 생략하면 요청이 첫 번째 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
UpdateTextStyleRequest
텍스트 스타일을 업데이트합니다.
JSON 표현 |
---|
{ "textStyle": { object ( |
필드 | |
---|---|
textStyle
|
텍스트에 설정할 스타일입니다. 특정 스타일의 값이 상위 스타일의 값과 일치하면 해당 스타일은 상속하도록 설정됩니다.
특정 텍스트 스타일 변경으로 인해 문서 편집기의 동작을 반영하기 위해 다른 변경사항이 발생할 수 있습니다. 자세한 내용은
|
fields
|
업데이트해야 하는 필드입니다.
필드를 하나 이상 지정해야 합니다. 루트
예를 들어 텍스트 스타일을 굵게로 업데이트하려면
속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하고 필드 자체는 설정하지 않은 상태로 두세요. |
공용체 필드
insertion_location 텍스트 스타일이 업데이트될 때 사용되는 범위 유형입니다.
insertion_location
다음 중 하나여야 합니다.
|
|
range
|
스타일을 지정할 텍스트의 범위입니다. 인접한 줄바꿈을 포함하도록 범위를 확장할 수 있습니다. 범위에 완전히 목록에 속한 단락이 포함된 경우 단락의 글머리기호도 일치하는 텍스트 스타일로 업데이트됩니다. 상대 UpdateTextStyleRequest 내에 범위를 삽입할 수 없습니다. |
CreateParagraphBulletsRequest
지정된 범위와 겹치는 모든 단락에 대한 글머리기호를 만듭니다.
각 단락의 중첩 수준은 각 단락 앞에 있는 선행 탭을 계산하여 결정됩니다. 글머리기호와 해당 단락 사이에 불필요한 공백이 발생하지 않도록 선행 탭을 삭제합니다. 이렇게 하면 텍스트 일부의 색인이 변경될 수 있습니다.
업데이트되는 단락 직전에 단락이 일치하는 사전 설정이 있는 목록에 있는 경우 업데이트되는 단락은 이전 목록에 추가됩니다.
JSON 표현 |
---|
{ "range": { object ( |
필드 | |
---|---|
range
|
글머리기호 사전 설정을 적용할 범위입니다. |
bulletPreset
|
사용할 글머리 기호 글리프 유형입니다. |
BulletGlyphPreset
목록의 글머리기호 글리프 패턴 사전 설정
이러한 패턴에서는 다음과 같은 종류의 글머리기호를 사용합니다.
-
ARROW
: 화살표(유니코드 U+2794 코드 포인트에 해당) -
ARROW3D
: 3D 음영 화살표로, 유니코드 U+27a2 코드 포인트에 해당 -
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'와 같은 대문자입니다. -
DECIMAL
: '1', '2' 또는 '3'과 같은 숫자입니다. -
ZERODECIMAL
: '01', '02' 또는 '03'과 같이 한 자릿수 숫자 앞에 0이 붙는 숫자입니다. 숫자가 두 개 이상인 숫자는 앞에 0이 붙지 않습니다. -
ROMAN
: 'i', 'ii' 또는 'iii'와 같은 소문자 로마 숫자입니다. -
UPPERROMAN
: 'I', 'II' 또는 'III'과 같은 대문자 로마 숫자입니다. -
LEFTTRIANGLE
유니코드 U+25c4 코드 포인트에 해당하며 왼쪽을 가리키는 삼각형
열거형 | |
---|---|
BULLET_GLYPH_PRESET_UNSPECIFIED
|
글머리기호 글리프 사전 설정이 지정되지 않았습니다. |
BULLET_DISC_CIRCLE_SQUARE
|
글머리기호 목록을 사용하면
DISC ,
CIRCLE
및
<ph type="x-smartling-placeholder">SQUARE </ph>
글머리기호 글리프를 추가합니다.
|
BULLET_DIAMONDX_ARROW3D_SQUARE
|
글머리기호 목록을 사용하면
DIAMONDX ,
ARROW3D
및
<ph type="x-smartling-placeholder">SQUARE </ph>
글머리기호 글리프를 추가합니다.
|
BULLET_CHECKBOX
|
글머리 기호 목록으로
CHECKBOX
글머리기호 글리프를 사용합니다.
|
BULLET_ARROW_DIAMOND_DISC
|
글머리기호 목록을 사용하면
ARROW ,
DIAMOND
및
<ph type="x-smartling-placeholder">DISC </ph>
글머리기호 글리프를 추가합니다.
|
BULLET_STAR_CIRCLE_SQUARE
|
글머리기호 목록을 사용하면
STAR ,
CIRCLE
및
<ph type="x-smartling-placeholder">SQUARE </ph>
글머리기호 글리프를 추가합니다.
|
BULLET_ARROW3D_CIRCLE_SQUARE
|
글머리기호 목록을 사용하면
ARROW3D ,
CIRCLE
및
<ph type="x-smartling-placeholder">SQUARE </ph>
글머리기호 글리프를 추가합니다.
|
BULLET_LEFTTRIANGLE_DIAMOND_DISC
|
글머리기호 목록을 사용하면
LEFTTRIANGLE ,
DIAMOND
및
<ph type="x-smartling-placeholder">DISC </ph>
글머리기호 글리프를 추가합니다.
|
BULLET_DIAMONDX_HOLLOWDIAMOND_SQUARE
|
글머리기호 목록을 사용하면
DIAMONDX ,
HOLLOWDIAMOND
및
<ph type="x-smartling-placeholder">SQUARE </ph>
글머리기호 글리프를 추가합니다.
|
BULLET_DIAMOND_CIRCLE_SQUARE
|
글머리기호 목록을 사용하면
DIAMOND ,
CIRCLE
및
<ph type="x-smartling-placeholder">SQUARE </ph>
글머리기호 글리프를 추가합니다.
|
NUMBERED_DECIMAL_ALPHA_ROMAN
|
번호가 매겨진 목록과
DECIMAL ,
ALPHA
및
<ph type="x-smartling-placeholder">ROMAN </ph>
숫자 글리프를 입력합니다.
|
NUMBERED_DECIMAL_ALPHA_ROMAN_PARENS
|
번호가 매겨진 목록과
DECIMAL ,
ALPHA
및
<ph type="x-smartling-placeholder">ROMAN </ph>
숫자 글리프로 시작하고 그 뒤에 괄호가 옵니다.
|
NUMBERED_DECIMAL_NESTED
|
번호가 매겨진 목록과
DECIMAL
마침표로 구분된 숫자 글리프. 각 중첩 수준은 이전 중첩 수준의 글리프를 접두사로 사용합니다. 예: '1.', '1.1.', '2.', '2.2.'.
|
NUMBERED_UPPERALPHA_ALPHA_ROMAN
|
번호가 매겨진 목록과
UPPERALPHA ,
ALPHA
및
<ph type="x-smartling-placeholder">ROMAN </ph>
숫자 글리프를 입력합니다.
|
NUMBERED_UPPERROMAN_UPPERALPHA_DECIMAL
|
번호가 매겨진 목록과
UPPERROMAN ,
UPPERALPHA
및
<ph type="x-smartling-placeholder">DECIMAL </ph>
숫자 글리프를 입력합니다.
|
NUMBERED_ZERODECIMAL_ALPHA_ROMAN
|
번호가 매겨진 목록과
ZERODECIMAL ,
ALPHA
및
<ph type="x-smartling-placeholder">ROMAN </ph>
숫자 글리프를 입력합니다.
|
DeleteParagraphBulletsRequest
지정된 범위와 겹치는 모든 단락에서 글머리기호를 삭제합니다.
각 단락의 중첩 수준은 해당 단락의 시작 부분에 들여쓰기를 추가하여 시각적으로 보존됩니다.
JSON 표현 |
---|
{
"range": {
object (
|
필드 | |
---|---|
range
|
글머리기호를 삭제할 범위입니다. |
CreateNamedRangeRequest
만들기
NamedRange
곱합니다.
JSON 표현 |
---|
{
"name": string,
"range": {
object (
|
필드 | |
---|---|
name
|
NamedRange의 이름입니다. 이름은 고유하지 않아도 됩니다. 이름은 UTF-16 코드 단위로 측정된 1자 이상 256자(영문 기준) 이하여야 합니다. |
range
|
이름을 적용할 범위입니다. |
DeleteNamedRangeRequest
JSON 표현 |
---|
{ "tabsCriteria": { object ( |
필드 | |
---|---|
tabsCriteria
|
선택사항입니다. 범위 삭제가 발생해야 하는 탭을 지정하는 데 사용되는 기준입니다. 생략하면 범위 삭제가 모든 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
공용체 필드
named_range_reference 삭제할 범위를 결정하는 값입니다. 정확히 1개를 설정해야 합니다.
named_range_reference
다음 중 하나여야 합니다.
|
|
namedRangeId
|
삭제할 이름이 지정된 범위의 ID입니다. |
name
|
삭제할 범위의 이름입니다. 지정된 이름의 이름이 지정된 범위가 모두 삭제됩니다. |
UpdateParagraphStyleRequest
지정된 범위와 겹치는 모든 단락의 스타일을 업데이트합니다.
JSON 표현 |
---|
{ "paragraphStyle": { object ( |
필드 | |
---|---|
paragraphStyle
|
단락에 설정할 스타일입니다.
특정 단락 스타일 변경으로 인해 문서 편집기의 동작을 반영하기 위해 다른 변경사항이 발생할 수 있습니다. 자세한 내용은
|
fields
|
업데이트해야 하는 필드입니다.
필드를 하나 이상 지정해야 합니다. 루트
예를 들어 단락 스타일의 정렬 속성을 업데이트하려면
속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하고 필드 자체는 설정하지 않은 상태로 두세요. |
공용체 필드
insertion_location 단락 스타일이 업데이트될 때 사용되는 범위 유형입니다.
insertion_location
다음 중 하나여야 합니다.
|
|
range
|
스타일을 지정할 단락과 겹치는 범위입니다. |
DeleteContentRangeRequest
문서에서 콘텐츠를 삭제합니다.
JSON 표현 |
---|
{
"range": {
object (
|
필드 | |
---|---|
range
|
삭제할 콘텐츠의 범위입니다. 단락 경계를 가로지르는 텍스트를 삭제하면 두 단락이 병합될 때 단락 스타일, 목록, 위치가 지정된 객체, 북마크가 변경될 수 있습니다. 특정 범위를 삭제하려고 하면 문서 구조가 잘못되어 400 잘못된 요청 오류가 반환될 수 있습니다. 잘못된 삭제 요청의 예는 다음과 같습니다.
|
InsertInlineImageRequest
삽입
InlineObject
지정된 위치에 이미지를 포함합니다.
JSON 표현 |
---|
{ "uri": string, "objectSize": { object ( |
필드 | |
---|---|
uri
|
이미지 URI입니다. 이미지는 삽입 시 한 번 가져오며 문서 내부에 표시되도록 사본이 저장됩니다. 이미지는 50MB 미만이어야 하고, 25메가픽셀을 초과할 수 없으며, PNG, JPEG, GIF 형식이어야 합니다.
제공된 URI는 공개적으로 액세스할 수 있어야 하며 길이가 2KB 이하여야 합니다. URI 자체는 이미지와 함께 저장되고
|
objectSize
|
문서에 표시되어야 하는 이미지의 크기입니다. 이 속성은 선택사항이며 문서에 포함된 이미지의 최종 크기는 다음 규칙에 따라 결정됩니다. * 너비와 높이를 모두 지정하지 않으면 해상도를 기준으로 이미지의 기본 크기가 계산됩니다. * 한 크기가 지정되면 이미지의 가로세로 비율이 유지되도록 다른 크기가 계산됩니다. * 너비와 높이를 모두 지정한 경우 이미지는 가로 세로 비율을 유지하면서 제공된 크기에 맞도록 조정됩니다. |
공용체 필드
insertion_location 이미지가 삽입될 위치입니다.
insertion_location
다음 중 하나여야 합니다.
|
|
location
|
문서의 특정 색인에 이미지를 삽입합니다.
이미지는 기존
인라인 이미지는 각주나 등식 내에 삽입할 수 없습니다. |
endOfSegmentLocation
|
머리글, 바닥글 또는 문서 본문 끝에 텍스트를 삽입합니다. 인라인 이미지는 각주 내에 삽입할 수 없습니다. |
InsertTableRequest
지정된 위치에 테이블을 삽입합니다.
삽입된 테이블 앞에 줄바꿈 문자가 삽입됩니다.
JSON 표현 |
---|
{ "rows": integer, "columns": integer, // Union field |
필드 | |
---|---|
rows
|
테이블의 행 수입니다. |
columns
|
테이블의 열 수입니다. |
공용체 필드
insertion_location 표가 삽입될 위치입니다.
insertion_location
다음 중 하나여야 합니다.
|
|
location
|
특정 모델 색인에 테이블을 삽입합니다. 삽입된 테이블 앞에 줄바꿈 문자가 삽입되므로 테이블 시작 색인은 지정된 위치 색인 + 1에 배치됩니다.
테이블은 기존
각주 또는 등식 안에는 표를 삽입할 수 없습니다. |
endOfSegmentLocation
|
지정한 머리글, 바닥글 또는 문서 본문의 끝에 표를 삽입합니다. 삽입된 테이블 앞에 줄바꿈 문자가 삽입됩니다. 각주 안에는 표를 삽입할 수 없습니다. |
InsertTableRowRequest
테이블에 빈 행을 삽입합니다.
JSON 표현 |
---|
{
"tableCellLocation": {
object (
|
필드 | |
---|---|
tableCellLocation
|
행을 삽입할 참조 표의 셀 위치입니다. 참조 셀이 있는 행 위 또는 아래에 새 행이 삽입됩니다. 참조 셀이 병합된 셀인 경우 병합된 셀 위 또는 아래에 새 행이 삽입됩니다. |
insertBelow
|
참조 셀 위치 아래에 새 행을 삽입할지 여부입니다.
|
TableCellLocation
표 내에서 단일 셀의 위치입니다.
JSON 표현 |
---|
{
"tableStartLocation": {
object (
|
필드 | |
---|---|
tableStartLocation
|
문서에서 표가 시작되는 위치입니다. |
rowIndex
|
0부터 시작하는 행 색인입니다. 예를 들어 테이블의 두 번째 행의 행 색인은 1입니다. |
columnIndex
|
0부터 시작하는 열 색인입니다. 예를 들어 테이블의 두 번째 열의 열 색인은 1입니다. |
InsertTableColumnRequest
테이블에 빈 열을 삽입합니다.
JSON 표현 |
---|
{
"tableCellLocation": {
object (
|
필드 | |
---|---|
tableCellLocation
|
열을 삽입할 참조 표의 셀 위치입니다. 참조 셀이 있는 열의 왼쪽 (또는 오른쪽)에 새 열이 삽입됩니다. 참조 셀이 병합된 셀인 경우 병합된 셀의 왼쪽 (또는 오른쪽)에 새 열이 삽입됩니다. |
insertRight
|
참조 셀 위치의 오른쪽에 새 열을 삽입할지 여부입니다.
|
DeleteTableRowRequest
테이블에서 행을 삭제합니다.
JSON 표현 |
---|
{
"tableCellLocation": {
object (
|
필드 | |
---|---|
tableCellLocation
|
행이 삭제될 참조 표의 셀 위치입니다. 이 셀에 걸쳐 있는 행이 삭제됩니다. 여러 행에 걸쳐 있는 병합된 셀인 경우 셀에 걸쳐 있는 모든 행이 삭제됩니다. 삭제 후 테이블에 남은 행이 없으면 전체 테이블이 삭제됩니다. |
DeleteTableColumnRequest
테이블에서 열을 삭제합니다.
JSON 표현 |
---|
{
"tableCellLocation": {
object (
|
필드 | |
---|---|
tableCellLocation
|
열이 삭제될 참조 표 셀 위치입니다. 이 셀에 걸쳐 있는 열입니다. 여러 열에 걸쳐 병합된 셀인 경우 셀 범위에 있는 모든 열이 삭제됩니다. 삭제 후 테이블에 남은 열이 없으면 전체 테이블이 삭제됩니다. |
InsertPageBreakRequest
지정된 위치에 페이지 나누기와 줄바꿈을 차례로 삽입합니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드
insertion_location 페이지 나누기가 삽입될 위치입니다.
insertion_location
다음 중 하나여야 합니다.
|
|
location
|
문서의 특정 색인에 페이지 나누기를 삽입합니다.
페이지 나누기는 기존
표, 등식, 각주, 머리글 또는 바닥글에는 페이지 나누기를 삽입할 수 없습니다. 페이지 나누기는 본문 안에만 삽입할 수 있으므로
|
endOfSegmentLocation
|
문서 본문 끝에 페이지 나누기를 삽입합니다.
각주, 머리글 또는 바닥글에는 페이지 나누기를 삽입할 수 없습니다. 페이지 나누기는 본문 안에만 삽입할 수 있으므로
|
DeletePositionedObjectRequest
PositionedObject
삭제합니다.
JSON 표현 |
---|
{ "objectId": string, "tabId": string } |
필드 | |
---|---|
objectId
|
삭제할 위치가 지정된 객체의 ID입니다. |
tabId
|
삭제할 객체가 있는 탭입니다. 생략하면 요청이 첫 번째 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
UpdateTableColumnPropertiesRequest
업데이트
TableColumnProperties
할 수 있습니다.
JSON 표현 |
---|
{ "tableStartLocation": { object ( |
필드 | |
---|---|
tableStartLocation
|
문서에서 표가 시작되는 위치입니다. |
columnIndices[]
|
속성을 업데이트해야 하는 0부터 시작하는 열 색인의 목록입니다. 색인을 지정하지 않으면 모든 열이 업데이트됩니다. |
tableColumnProperties
|
업데이트할 표 열 속성입니다.
값이
|
fields
|
업데이트해야 하는 필드입니다.
필드를 하나 이상 지정해야 합니다. 루트
예를 들어 열 너비를 업데이트하려면
|
UpdateTableCellStyleRequest
표 셀 범위의 스타일을 업데이트합니다.
JSON 표현 |
---|
{ "tableCellStyle": { object ( |
필드 | |
---|---|
tableCellStyle
|
표 셀에 설정할 스타일입니다. 테두리를 업데이트할 때 셀이 인접한 셀과 테두리를 공유하는 경우 인접 셀의 해당 테두리 속성도 업데이트됩니다. 병합되어 보이지 않는 테두리는 업데이트되지 않습니다. 동일한 요청에서 인접한 셀에 공유된 테두리를 업데이트하면 테두리 업데이트 시 충돌이 발생할 수 있으므로 테두리 업데이트는 다음 순서로 적용됩니다.
|
fields
|
업데이트해야 하는 필드입니다.
필드를 하나 이상 지정해야 합니다. 루트
예를 들어 표 셀 배경색을 업데이트하려면
속성을 기본값으로 재설정하려면 필드 마스크에 필드 이름을 포함하고 필드 자체는 설정하지 않은 상태로 두세요. |
공용체 필드
cells 업데이트할 셀입니다.
cells
다음 중 하나여야 합니다.
|
|
tableRange
|
업데이트가 적용되는 테이블의 하위 집합을 나타내는 테이블 범위입니다. |
tableStartLocation
|
문서에서 표가 시작되는 위치입니다. 이 플래그를 지정하면 업데이트가 표의 모든 셀에 적용됩니다. |
TableRange
테이블 범위는 테이블의 하위 집합에 대한 참조를 나타냅니다.
표 범위에 의해 지정된 셀이 반드시 직사각형을 형성하는 것은 아닙니다. 예를 들어 마지막 행의 모든 셀을 병합하는 3x3 테이블이 있다고 가정해 보겠습니다. 표는 다음과 같습니다.
[ ][ ][ ]
[ ][ ][ ]
[ ]
테이블 셀 위치가 (tableStartLocation, 행 = 0, 열 = 0), 행 스팬이 3이고 열 스팬이 2인 테이블 범위는 다음 셀을 지정합니다.
[ x ][ x ][ ]
[ x ][ x ][ ]
[ x x x ]
JSON 표현 |
---|
{
"tableCellLocation": {
object (
|
필드 | |
---|---|
tableCellLocation
|
표 범위가 시작되는 셀 위치입니다. |
rowSpan
|
표 범위의 행 범위입니다. |
columnSpan
|
표 범위의 열 범위입니다. |
UpdateTableRowStyleRequest
업데이트
TableRowStyle
할 수 있습니다.
JSON 표현 |
---|
{ "tableStartLocation": { object ( |
필드 | |
---|---|
tableStartLocation
|
문서에서 표가 시작되는 위치입니다. |
rowIndices[]
|
스타일을 업데이트해야 하는 0 기준 행 색인의 목록입니다. 색인을 지정하지 않으면 모든 행이 업데이트됩니다. |
tableRowStyle
|
행에 설정할 스타일입니다. |
fields
|
업데이트해야 하는 필드입니다.
필드를 하나 이상 지정해야 합니다. 루트
예를 들어 최소 행 높이를 업데이트하려면
|
ReplaceImageRequest
기존 이미지를 새 이미지로 대체합니다.
이미지를 대체하면 일부 이미지가 삭제됨
image effects
기존 이미지에서 삭제됩니다.
JSON 표현 |
---|
{
"imageObjectId": string,
"uri": string,
"imageReplaceMethod": enum (
|
필드 | |
---|---|
imageObjectId
|
대체될 기존 이미지의 ID입니다. ID는 get 요청의 응답에서 가져올 수 있습니다. |
uri
|
새 이미지의 URI입니다. 이미지는 삽입 시 한 번 가져오며 문서 내부에 표시되도록 사본이 저장됩니다. 이미지는 50MB 미만이어야 하고, 25메가픽셀을 초과할 수 없으며, PNG, JPEG 또는 GIF 형식이어야 합니다.
제공된 URI의 길이는 2KB를 초과할 수 없습니다. URI는 이미지와 함께 저장되고
|
imageReplaceMethod
|
대체 메서드입니다. |
tabId
|
교체할 이미지가 있는 탭입니다. 생략하면 요청이 첫 번째 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
ImageReplaceMethod
이미지 바꾸기 메서드입니다.
열거형 | |
---|---|
IMAGE_REPLACE_METHOD_UNSPECIFIED
|
지정되지 않은 이미지 교체 메서드입니다. 이 값을 사용해서는 안 됩니다. |
CENTER_CROP
|
원본 이미지의 경계를 채우도록 이미지의 크기를 조정하고 가운데로 조정합니다. 원본 이미지의 경계를 채우기 위해 이미지를 자를 수 있습니다. 렌더링된 이미지의 크기는 원본 이미지와 동일합니다. |
UpdateDocumentStyleRequest
업데이트
DocumentStyle
JSON 표현 |
---|
{
"documentStyle": {
object (
|
필드 | |
---|---|
documentStyle
|
문서에 설정할 스타일입니다.
특정 문서 스타일 변경사항의 경우 문서 편집기의 동작을 반영하기 위해 다른 변경사항이 발생할 수 있습니다. 자세한 내용은
|
fields
|
업데이트해야 하는 필드입니다.
필드를 하나 이상 지정해야 합니다. 루트
예를 들어 배경을 업데이트하려면
|
tabId
|
업데이트할 스타일이 포함된 탭입니다. 생략하면 요청이 첫 번째 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
MergeTableCellsRequest
셀 병합
Table
JSON 표현 |
---|
{
"tableRange": {
object (
|
필드 | |
---|---|
tableRange
|
표에서 병합할 셀을 지정하는 테이블 범위입니다. 병합되는 셀의 텍스트는 연결되어 'head'에 저장됩니다. 범위 내의 셀입니다. 콘텐츠 방향이 왼쪽에서 오른쪽인 경우 범위의 왼쪽 상단 셀, 그렇지 않으면 범위의 오른쪽 상단 셀입니다. 범위가 직사각형이 아니면 (범위가 이미 병합된 셀을 포괄하거나 표가 직사각형이 아닌 셀을 포함하는 경우에 발생할 수 있음) 400 잘못된 요청 오류가 반환됩니다. |
UnmergeTableCellsRequest
셀의 병합 취소
Table
JSON 표현 |
---|
{
"tableRange": {
object (
|
필드 | |
---|---|
tableRange
|
표에서 병합 취소할 셀을 지정하는 표 범위입니다. 이 범위의 병합된 모든 셀은 병합 취소되며 이미 병합 취소된 셀은 영향을 받지 않습니다. 범위에 병합된 셀이 없으면 요청은 아무 작업도 수행하지 않습니다. 병합된 셀에 텍스트가 있는 경우 텍스트가 '헤드'에 그대로 남게 됩니다. 병합되지 않은 셀의 결과 블록의 셀입니다. 'head' 셀은 콘텐츠 방향이 왼쪽에서 오른쪽이면 왼쪽 상단 셀이고, 그렇지 않으면 오른쪽 상단입니다. |
CreateHeaderRequest
만들기
Header
새 헤더가
SectionStyle
의 위치에서
SectionBreak
지정하지 않으면
DocumentStyle
입니다.
지정된 유형의 헤더가 이미 있는 경우 400 잘못된 요청 오류가 반환됩니다.
JSON 표현 |
---|
{ "type": enum ( |
필드 | |
---|---|
type
|
생성할 헤더 유형입니다. |
sectionBreakLocation
|
|
CreateFootnoteRequest
만들기
Footnote
새로운
FootnoteReference
전달합니다.
새로운
Footnote
세그먼트에는 공백 뒤에 줄바꿈 문자가 포함됩니다.
JSON 표현 |
---|
{ // Union field |
필드 | |
---|---|
공용체 필드
footnote_reference_location 각주 참조를 삽입할 위치입니다.
footnote_reference_location
다음 중 하나여야 합니다.
|
|
location
|
문서의 특정 색인에 각주 참조를 삽입합니다.
각주 참조는 기존
각주 참조는 등식, 머리글, 바닥글 또는 각주 내에 삽입할 수 없습니다. 각주 참조는 본문에만 삽입할 수 있으므로
|
endOfSegmentLocation
|
각주 참조를 문서 본문 끝에 삽입합니다.
각주 참조는 머리글, 바닥글 또는 각주 내에 삽입할 수 없습니다. 각주 참조는 본문에만 삽입할 수 있으므로
|
ReplaceNamedRangeContentRequest
지정된
NamedRange
또는
NamedRanges
교체합니다.
한 개인이
NamedRange
불연속적인 여러 개의
ranges
입니다. 이 경우 첫 번째 범위의 콘텐츠만 대체됩니다. 다른 범위와 그 내용은 삭제됩니다.
범위를 바꾸거나 삭제하여 문서 구조가 잘못된 경우 400 잘못된 요청 오류가 반환됩니다.
JSON 표현 |
---|
{ "tabsCriteria": { object ( |
필드 | |
---|---|
tabsCriteria
|
선택사항입니다. 대체를 실행할 탭을 지정하는 데 사용되는 기준입니다. 생략하면 대체가 모든 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
공용체 필드
replacement_content 이름이 지정된 범위의 기존 콘텐츠를 대체할 콘텐츠입니다.
replacement_content
다음 중 하나여야 합니다.
|
|
text
|
지정된 이름이 지정된 범위의 내용을 지정된 텍스트로 바꿉니다. |
공용체 필드
named_range_reference 콘텐츠가 대체될 이름이 지정된 범위에 대한 참조입니다.
named_range_reference
다음 중 하나여야 합니다.
|
|
namedRangeId
|
콘텐츠가 대체될 이름이 지정된 범위의 ID입니다. 지정된 ID를 가진 이름이 지정된 범위가 없으면 400 잘못된 요청 오류가 반환됩니다. |
namedRangeName
|
이
여러 개의
|
UpdateSectionStyleRequest
업데이트
SectionStyle
JSON 표현 |
---|
{ "range": { object ( |
필드 | |
---|---|
range
|
스타일을 지정할 섹션과 겹치는 범위입니다.
섹션 나누기는 본문 내에만 삽입할 수 있으므로
|
sectionStyle
|
섹션에 설정할 스타일입니다.
특정 섹션 스타일 변경사항의 경우 문서 편집기의 동작을 반영하기 위해 다른 변경사항이 발생할 수 있습니다. 자세한 내용은
|
fields
|
업데이트해야 하는 필드입니다.
필드를 하나 이상 지정해야 합니다. 루트
예를 들어 왼쪽 여백을 업데이트하려면
|
InsertSectionBreakRequest
지정된 위치에 섹션 나누기를 삽입합니다.
섹션 나누기 앞에 줄바꿈 문자가 삽입됩니다.
JSON 표현 |
---|
{ "sectionType": enum ( |
필드 | |
---|---|
sectionType
|
삽입할 섹션의 유형입니다. |
공용체 필드
insertion_location 줄바꿈이 삽입될 위치입니다.
insertion_location
다음 중 하나여야 합니다.
|
|
location
|
문서의 특정 색인에 줄바꿈과 섹션 나누기를 삽입합니다.
섹션 나누기는 기존
표, 등식, 각주, 머리글 또는 바닥글에는 섹션 나누기를 삽입할 수 없습니다. 섹션 나누기는 본문 내에만 삽입할 수 있으므로
|
endOfSegmentLocation
|
문서 본문 끝에 줄바꿈과 섹션 나누기를 삽입합니다.
각주, 머리글 또는 바닥글에는 섹션 나누기를 삽입할 수 없습니다. 섹션 나누기는 본문 내에만 삽입할 수 있으므로
|
DeleteHeaderRequest
Header
삭제합니다.
JSON 표현 |
---|
{ "headerId": string, "tabId": string } |
필드 | |
---|---|
headerId
|
삭제할 헤더의 ID입니다. 이 헤더가
|
tabId
|
삭제할 헤더가 포함된 탭입니다. 생략하면 요청이 첫 번째 탭에 적용됩니다. 단일 탭이 포함된 문서에서 다음을 수행합니다.
여러 탭이 포함된 문서에서:
|
PinTableHeaderRowsRequest
표에 고정된 표 헤더 행 수를 업데이트합니다.
JSON 표현 |
---|
{
"tableStartLocation": {
object (
|
필드 | |
---|---|
tableStartLocation
|
문서에서 표가 시작되는 위치입니다. |
pinnedHeaderRowsCount
|
고정할 테이블 행 수입니다. 0은 모든 행이 고정 해제되었음을 의미합니다. |