# Unity Google Sheet

![](/files/-MLNA4Re1K-ivt0aXOP5)

<figure><img src="/files/9ViqtUN4aZLPA1k3VcBl" alt=""><figcaption><p>UGS 사용의 좋은 예</p></figcaption></figure>

<figure><img src="/files/6DqazpnwRe7yyEsnxOxa" alt=""><figcaption><p>직관적으로 데이터를 확인하고 싶으신가요?</p></figcaption></figure>

## 유니티에서 구글시트를 쉽게 사용하세요! [(무료 오픈소스)](https://github.com/shlifedev/uni-google-sheets)

{% embed url="<https://www.youtube.com/watch?v=1Hxzgft-lTY&ab_channel=HamsterCheeseAllergy>" %}

&#x20;UGS는 구글 스프레드시트를 이용하여 게임 데이터를 체계적이고효율적으로 관리할 수 있는 도구입니다.   개발자가 쉽게 유니티 프로젝트에 구글시트를 도입할 수 있도록 최대한 쉽게할 수 있게 만들어졌습니다.

### 게임 데이터를 [실시간으로 쉽게 수정하며 테스트](/unitygooglesheets/how-to-use/live-load.md)할 수 있습니다.

{% embed url="<https://www.youtube.com/watch?v=vOyQPVKDyGY&ab_channel=HamsterCheeseAllergy>" %}

&#x20;구글 스프레드시트에서 바꾼 값을 게임을 다시 빌드하지 않고도 구글 시트의 데이터를 Load 하거나 Save 할 수 있습니다. 스프레드시트 내 수정사항을 게임에 즉시 적용할 수 있으므로 게임 디자인 타임을 크게단축시킬 수 있는 편리한 도구입니다.&#x20;

&#x20; 이 기능은 에디터모드,  플레이 모드, 빌드된 런타임에서 모두 동작합니다. 단, API 횟수/시간제한이 있으므로 게임을 개발하는 동안만 사용해야 합니다. (사실상개발 하면서는 크게 신경쓰지 않아도 됨)

### &#x20;[Custom Class/Enum](/unitygooglesheets/and/custom-type.md)를 시트에서 사용할 수 있습니다!

{% embed url="<https://www.youtube.com/watch?v=Ax5m_dYso2o&ab_channel=HamsterCheeseAllergy>" %}

&#x20;`int`나 `float`, `string`, `array`같은 기본 자료형뿐만 아니라 `vector3` `quaternion` `custom class` 등 텍스트로 `직렬화/역직렬화`만 가능하다면 <mark style="color:yellow;">어떤</mark> <mark style="color:yellow;"></mark><mark style="color:yellow;">**데이터든 구글시트에 저장하실 수 있습니다.**</mark>&#x20;

이 기능은 조금 더 복잡한 데이터를 처리하고 싶은 개발자들을 위해 제공되는 고급기능이므로 선택적으로 사용하시면 됩니다.\
\
**아래 두 문서를 참고해보세요.**

[Use CustomType](/unitygooglesheets/and/custom-type.md)&#x20;

[Use EnumType](/unitygooglesheets/and/advanced-enum.md)

### [**Google Drive GUI**](/unitygooglesheets/getting-start/google-drive.md) **를 제공합니다!**

{% embed url="<https://www.youtube.com/watch?v=I_VMxmGgWlM&ab_channel=LifeDev>" %}

&#x20;편의/접근성을 위해 만들어진 기능으로 윈도우 폴더 탐색기와 비슷한 느낌으로 여러분의 구글드라이브 폴더를 유니티에서 탐색하실 수 있습니다. 유니티에서 구글시트에 즉시 엑세스 가능하므로 작업 효율성이 오릅니다.

### [**코드 제네레이터**](/unitygooglesheets/how-to-use/spreeadhseet-rules.md)**를 제공합니다!**&#x20;

{% embed url="<https://www.youtube.com/watch?v=-BfqFaQF53s&ab_channel=LifeDev>" %}

&#x20;프로그래밍에 익숙하지 않다면 이런 기능이 생소하실 수 있습니다. 쉽게 말해, 여러분들이 작성한 구글시트를 쉽게 불러올 수 있는 코드를 자동으로 생성해주는 기능입니다. 이 기능을 통해 그저 데이터를 읽는 코드를 호출하기만 하면 됩니다!

### 이런식으로 활용해보세요!

* [샘플1](https://drive.google.com/drive/folders/1fanZLAqJEvy366vw3dOHQ4o9rhqcz-vI)
* [샘플2](https://drive.google.com/drive/folders/1cpXkEkEslwWg6n1PhetKS5TpfqxDnyRk)
* [샘플3](https://drive.google.com/drive/folders/1YzddFFTLBFh-XhTXqBeDy1CyhQWgmpk1?usp=sharing)

### <mark style="color:yellow;">모든 플랫폼</mark>에서 사용 가능합니다.

WebGL, Linux, Windows, Android(Il2cpp/AOT), iOS, Xbox,Ps4와 같은 모든 플랫폼을 지원합니다.

## 요구사항

* 유니티 <mark style="color:purple;"><mark style="color:red;">**2018.3**<mark style="color:red;"></mark> 이상의 버전이 필요합니다. \
  유니티 <mark style="color:yellow;">**2023**</mark> 최신 버전까지 정상 작동 테스트 되었습니다.&#x20;


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://shlifedev.gitbook.io/unitygooglesheets/master.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.