이 가이드에서는 Google Sheets API를 사용하여 스프레드시트에 스마트 칩을 추가하고 관리하는 방법과 이유를 설명합니다.
스마트 칩이란 무엇인가요?
스마트 칩을 사용하면 다른 Google Workspace 애플리케이션의 풍부한 대화형 데이터를 Sheets로 직접 가져올 수 있습니다. 스마트 칩을 사용하면 정보와 작업에 빠르게 액세스할 수 있으며 셀 링크가 동적 객체로 변환됩니다. 자세한 내용은 Google Sheets에 스마트 칩 삽입하기를 참고하세요.
스마트 칩 추가하기
칩은 CellData의 일부인 칩 실행으로 표현되므로 UpdateCellsRequest 또는 AppendCellsRequest를 제공하여 기존 spreadsheets.batchUpdate 메서드를 사용하여 칩을 삽입할 수 있습니다.
요청에는 chipRuns 필드가 포함되어야 합니다. 칩 실행은 칩의 속성과 셀 텍스트 내 위치를 설명합니다.
chipRuns를 작성할 때는 추가하려는 각 칩의 자리표시자 문자 (@)가 포함된 userEnteredValue도 제공해야 합니다. chipRuns 배열의 각 실행은 자리표시자 중 하나에 해당합니다. 칩이 없는 실행은 쓰기 시 생략할 수 있습니다.
다음 예에서는 파일 칩, 사용자 칩, 일반 텍스트를 단일 셀 A1에 쓰는 방법을 보여줍니다. * {JSON}
{
"updateCells": {
"rows": [
{
"values": [
{
"userEnteredValue": {
"stringValue": "@ is the owner of @."
},
"chipRuns": [
{
"chip": {
"personProperties": {
"email": "johndoe@gmail.com",
"displayFormat": "DEFAULT"
}
}
},
{
"startIndex": 18,
"chip": {
"richLinkProperties": {
"uri": "https://docs.google.com/document/d/YOUR_DOCUMENT_ID/edit"
}
}
}
]
}
]
}
],
"fields": "userEnteredValue,chipRuns",
"range": {
"startRowIndex": 0,
"startColumnIndex": 0
}
}
}
칩 속성 구성
칩 객체는 다음 속성 유형 중 하나를 가질 수 있습니다.
personProperties
이를 사용하여 사람 칩을 만듭니다.
email: (필수) 연결할 사용자의 이메일 주소입니다.displayFormat: (선택사항) 사람 이름의 기본 표시 형식입니다. 다음 중 하나일 수 있습니다.DEFAULT: 표준 '이름 성' 형식입니다.LAST_NAME_COMMA_FIRST_NAME: '성, 이름' 형식입니다.EMAIL: 사용자의 이메일 주소입니다.
richLinkProperties
이를 사용하여 리치 링크 칩을 만듭니다. API는 YouTube 또는 Calendar와 같은 다양한 Google 서비스의 링크를 읽을 수 있지만 Google Drive 파일의 링크만 칩으로 작성할 수 있습니다.
uri: (필수) 리소스의 URI입니다. 쓰기의 경우 Google Drive 파일 링크여야 합니다. URI는 2,000바이트를 초과할 수 없습니다.
스마트 칩 읽기
스마트 칩의 데이터를 읽으려면 spreadsheets.get 메서드를 사용하고 필드 매개변수에 sheets.data.rowData.values(chipRuns)를 포함합니다.
대답의 chipRuns 배열에는 셀 텍스트의 모든 하위 섹션에 대한 객체가 포함됩니다.
- 잘린 구간: 이러한 섹션에는
personProperties또는richLinkProperties가 포함된chip객체가 채워져 있습니다. - 칩이 없는 실행: 일반 텍스트 섹션에도 실행 객체가 있지만
chip필드는 비어 있습니다.
칩의 표시 텍스트를 가져오려면 formattedValue를 필드로 추가합니다.
스마트 칩 업데이트
스마트 칩을 업데이트하거나 바꾸려면 셀의 내용을 덮어써야 합니다. 칩을 추가할 때와 동일한 UpdateCellsRequest 또는 AppendCellsRequest를 사용하여 새 userEnteredValue 및 chipRun를 제공합니다. 이렇게 하면 셀의 기존 칩이 대체됩니다.
다른 Sheets 기능과 함께 스마트 칩 사용하기
표: 스마트 칩을 표 열 유형으로 사용하여 프로젝트 소유자 (사용자 칩) 또는 관련 문서 (파일 칩)를 추적할 수 있습니다.
필터: 범위 내 스마트 칩의 텍스트 값을 기준으로 범위를 필터링할 수 있습니다.