> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/tutorials-and-examples/external-services/spreadsheet-data.md).

# 스프레드시트의 데이터

Google 시트로 구동되는 장면 콘텐츠로, 재배포 없이 업데이트됩니다.

Google 스프레드시트에서 씬 콘텐츠를 관리합니다. 씬을 다시 배포하지 않고도 시트에서 아티스트 이름, 동영상 스트림, 추천 웨어러블을 변경할 수 있습니다.

## 프로젝트 정보

**관리자:** Decentraland

[소스 보기](https://github.com/decentraland/Read_Spreadsheet_Scene)

**라이선스:** [Apache-2.0](https://github.com/decentraland/Read_Spreadsheet_Scene/blob/main/LICENSE). 재사용하기 전에 원본 프로젝트의 이용 약관을 확인하세요. 코드와 에셋에 서로 다른 약관이 적용될 수 있습니다.

## 코드 살펴보기

이 링크는 특정 소스 스냅샷을 가리키므로, 상위 프로젝트의 개발이 계속되어도 설명을 유용하게 참고할 수 있습니다. 학습을 위한 참고 자료이며 보안 평가 자료는 아닙니다.

### 게시된 Google 스프레드시트를 JSON으로 읽기

`getSpreadsheetData` 는 Google Visualization 엔드포인트(`gviz/tq?tqx=out:json`)를 통해 시트에 요청하고, `setResponse(...)` 래퍼를 제거한 다음 각 행을 열 머리글을 키로 사용하는 객체로 변환합니다.

**프로젝트 맥락:** 링크가 있는 모든 사용자가 볼 수 있도록 시트를 공유해야 합니다. `gid` 는 탭을 선택하고, `headers=1` 은 첫 번째 행을 열 이름으로 처리합니다.

**소스 참고:**

* [`getSpreadsheetData`](https://github.com/decentraland/Read_Spreadsheet_Scene/blob/57bb4086aed3054d69a74f33f20f2d86c4eb9bb6/src/scheduler.ts#L1-L47)

### 행을 씬에 적용하기

`updateFromSpreadsheet` 는 한 행을 읽어 배너의 `TextShape`를 업데이트하고, 화면의 `VideoPlayer` 소스를 바꾸며, 디스펜서에 표시된 웨어러블을 교체하고, 디스펜서의 클릭 동작이 해당 행의 구매 링크를 가리키도록 합니다.

**프로젝트 맥락:** 다음과 같은 열 이름은 `NowPlaying`, `VideoURL`, `WearableURN`및 `BuyURL` 시트의 머리글과 일치해야 합니다. 엔티티는 Creator Hub 씬에 지정된 이름으로 조회됩니다.

**소스 참고:**

* [`updateFromSpreadsheet`](https://github.com/decentraland/Read_Spreadsheet_Scene/blob/57bb4086aed3054d69a74f33f20f2d86c4eb9bb6/src/index.ts#L10-L64)
* [`createWearable`](https://github.com/decentraland/Read_Spreadsheet_Scene/blob/57bb4086aed3054d69a74f33f20f2d86c4eb9bb6/src/index.ts#L100-L130)

### Creator Hub 버튼으로 행 순환하기

`main` 은 `Next` 및 `Previous` 동작을 `Switch Artist` 엔티티에서 감지하고, 다운로드한 데이터의 행 인덱스가 범위를 벗어나면 처음이나 마지막으로 되돌립니다.

**프로젝트 맥락:** 다음의 `getActionEvents` 를 사용합니다: `@dcl/asset-packs`에서 가져온 것으로, 따라서 Creator Hub에서 엔티티에 동작을 설정합니다.

**소스 참고:**

* [`main`](https://github.com/decentraland/Read_Spreadsheet_Scene/blob/57bb4086aed3054d69a74f33f20f2d86c4eb9bb6/src/index.ts#L69-L97)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-ko/tutorials-and-examples/external-services/spreadsheet-data.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
