[📜일지] 차원 도서관(가제) 개발 일지 [2차]

[퍼플(director8024)]

[개발 일지 #2] 구글 시트 API 연동, 유니티 ScriptableObject화 (1)

코드 이해하는데 시간이 조금 걸려서 간격이 길어졌습니다.

*글자 수 제한에 걸려서 글을 2개로 나누어 올렸습니다.

구글 시트 API연돌을 하기 위해서 

GCP콘솔 에 접속해야 됩니다. 

링크 : Google Cloud Console

구글 클라우드 콘솔에 들어가서 API를 활성화해야 되는데 

메인화면에서 

빠른 액세스 버튼을 찾아서 눌러주면 아래 사진과 같은 창이 나타납니다.

먼저 프로젝트를 생성 버튼을 눌러 프로젝트를 생성해줍니다.  

그 다음으로 좌측에 API 및 서비스 탭에 라이브러리로 이동한 뒤, Google Sheets API를 검색하여 사용 버튼을 눌러주면 됩니다.

사용 버튼을 누른 뒤에 API 및 서비스 > 사용자 인증 정보로 이동합니다.

상단의 사용자 인증 정보 만들기를 클릭하고 API키를 선택하고 나오는 문자열을 메모장에 복사해두면 됩니다. 

다음은 구글 시트 위쪽의 URL을 보시면

             여기 빈 공백 부분                    

위 링크 사진의 공백 부분이 이 시트의 고유 ID(Spreadsheet ID)입니다.

이를 복사하고 

시트의 공유 버튼을 눌러 링크가 있는 모든 사용자가 볼 수 있음(뷰어)로 변경해줍니다. 

using UnityEngine;

using UnityEditor;

using System.Net.Http;

using System.Threading.Tasks;

using System.IO;

public class GoogleSheetImporter : EditorWindow

{

    private const string SHEET_ID = "이부분 시트 ID로 교체하세요"; //

    private const string API_KEY = "이부분 API 키로 교체하세요";

   

    // 가져올 시트들의 이름을 배열로 관리합니다. (엑셀 하단의 시트명과 정확히 일치해야 함)

    private static readonly string[] sheetNames = new string[]

    {

        "Nodes",

        "SelectNodes",

        "Localization_Dialogue",

        "Localization_UI",

        "Localization_Record",

        "EventList"

    };

    [MenuItem("Data/Import All Google Sheets")]

    public static async void ImportAllSheets()

    {

        Debug.Log("다중 구글 시트 데이터 다운로드 시작...");

        using (HttpClient client = new HttpClient())

        {

            // 배열에 등록된 시트 개수만큼 반복문을 실행합니다.

            foreach (string sheetName in sheetNames)

            {

                // A1:Z1000은 넉넉하게 잡은 범위입니다. 필요에 따라 늘리거나 줄이십시오.

                string url = $"https://sheets.googleapis.com/v4/spreadsheets/{SHEET_ID}/values/{sheetName}!A1:Z1000?key={API_KEY}";

               

                try

                {

                    HttpResponseMessage response = await client.GetAsync(url);

                   

                    if (response.IsSuccessStatusCode)

                    {

                        string jsonResponse = await response.Content.ReadAsStringAsync();

                       

                        // 시트 이름으로 각각의 JSON 파일을 생성합니다.

                        string savePath = Application.dataPath + $"/Resources/Data/{sheetName}.json";

                       

                        Directory.CreateDirectory(Path.GetDirectoryName(savePath));

                        File.WriteAllText(savePath, jsonResponse);

                        Debug.Log($"[{sheetName}] 데이터 로드 및 저장 성공!");

                    }

                    else

                    {

                        Debug.LogError($"[{sheetName}] 다운로드 실패. 상태 코드: {response.StatusCode}. 시트 이름이나 범위를 확인하세요.");

                    }

                }

                catch (HttpRequestException e)

                {

                    Debug.LogError($"[{sheetName}] 네트워크 요청 에러: {e.Message}");

                }

            }

           

            // 모든 다운로드가 끝난 후 에디터를 한 번만 새로고침합니다.

            AssetDatabase.Refresh();

            Debug.Log("모든 시트 다운로드 및 갱신 완료!");

        }

    }

}

SHEET_ID

API_KEY

다음 변수들에 복사해 두었던 아이디와 키를 입력해주면 되고.

sheetNames  에는 불러올 시트 이름을 적어주시면 됩니다. 

이 스크립트는 빌드 파일에 포함되면 안 되므로, 반드시 유니티 프로젝트 패널에서 Editor라는 이름의 폴더를 생성한 뒤 그 안에 스크립트를 생성해야 합니다.

해당 스크립트를 저장하게 되면

위의 파이프라인을 구축하면 유니티 에디터 상단의 Data -> Import Google Sheet 버튼을 누르는 것 만으로 시트 데이터가 로컬 JSON 파일로 즉시 저장됩니다.

해당 과정으로 이제 시트 데이터를 불러오기 위해서 귀찮은 과정을 대폭 줄였습니다.

*다음 내용은 다음 글에

[엔록(whale0407)]