스프레드시트 만들기 및 관리

이 문서에서는 Google Sheets API를 사용하여 Google Sheets에서 스프레드시트를 만들고 관리하는 방법을 설명합니다.

스프레드시트 만들기

Sheets에서 파일을 만들려면 매개변수 없이 spreadsheets 리소스 에서 create 메서드를 사용합니다.

파일을 만들면 메서드가 spreadsheets 리소스를 반환합니다. 반환된 리소스에는 spreadsheetId, properties, sheets 목록, spreadsheetUrl이 포함됩니다.

다음 코드 샘플은 지정된 제목으로 빈 스프레드시트를 만드는 방법을 보여줍니다.

Apps Script

sheets/api/spreadsheet_snippets.gs

/**
 * Creates a new sheet using the sheets advanced services
 * @param {string} title the name of the sheet to be created
 * @returns {string} the spreadsheet ID
 */
Snippets.prototype.create = (title) => {
  // This code uses the Sheets Advanced Service, but for most use cases
  // the built-in method SpreadsheetApp.create() is more appropriate.
  try {
    const sheet = Sheets.newSpreadsheet();
    sheet.properties = Sheets.newSpreadsheetProperties();
    sheet.properties.title = title;
    const spreadsheet = Sheets.Spreadsheets.create(sheet);

    return spreadsheet.spreadsheetId;
  } catch (err) {
    // TODO (developer) - Handle exception
    console.log("Failed with error %s", err.message);
  }
};

자바

sheets/snippets/src/main/java/Create.java

GitHub에서 보기

import com.google.api.client.http.HttpRequestInitializer;
import com.google.api.client.http.javanet.NetHttpTransport;
import com.google.api.client.json.gson.GsonFactory;
import com.google.api.services.sheets.v4.Sheets;
import com.google.api.services.sheets.v4.SheetsScopes;
import com.google.api.services.sheets.v4.model.Spreadsheet;
import com.google.api.services.sheets.v4.model.SpreadsheetProperties;
import com.google.auth.http.HttpCredentialsAdapter;
import com.google.auth.oauth2.GoogleCredentials;
import java.io.IOException;
import java.util.Collections;

/* Class to demonstrate the use of Spreadsheet Create API */
public class Create {
  /**
   * Create a new spreadsheet.
   *
   * @param title - the name of the sheet to be created.
   * @return newly created spreadsheet id
   * @throws IOException - if credentials file not found.
   */
  public static String createSpreadsheet(String title) throws IOException {
        /* Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
            guides on implementing OAuth2 for your application. */
    GoogleCredentials credentials = GoogleCredentials.getApplicationDefault()
        .createScoped(Collections.singleton(SheetsScopes.SPREADSHEETS));
    HttpRequestInitializer requestInitializer = new HttpCredentialsAdapter(
        credentials);

    // Create the sheets API client
    Sheets service = new Sheets.Builder(new NetHttpTransport(),
        GsonFactory.getDefaultInstance(),
        requestInitializer)
        .setApplicationName("Sheets samples")
        .build();

    // Create new spreadsheet with a title
    Spreadsheet spreadsheet = new Spreadsheet()
        .setProperties(new SpreadsheetProperties()
            .setTitle(title));
    spreadsheet = service.spreadsheets().create(spreadsheet)
        .setFields("spreadsheetId")
        .execute();
    // Prints the new spreadsheet id
    System.out.println("Spreadsheet ID: " + spreadsheet.getSpreadsheetId());
    return spreadsheet.getSpreadsheetId();
  }
}

JavaScript

sheets/snippets/sheets_create.js

GitHub에서 보기

function create(title, callback) {
  try {
    gapi.client.sheets.spreadsheets.create({
      properties: {
        title: title,
      },
    }).then((response) => {
      if (callback) callback(response);
      console.log('Spreadsheet ID: ' + response.result.spreadsheetId);
    });
  } catch (err) {
    document.getElementById('content').innerText = err.message;
    return;
  }
}

Node.js

sheets/snippets/sheets_create.js

GitHub에서 보기

import {GoogleAuth} from 'google-auth-library';
import {google} from 'googleapis';

/**
 * Creates a new Google Spreadsheet.
 * @param {string} title The title of the new spreadsheet.
 * @return {string} The ID of the created spreadsheet.
 */
async function create(title) {
  // Authenticate with Google and get an authorized client.
  const auth = new GoogleAuth({
    scopes: 'https://www.googleapis.com/auth/spreadsheets',
  });

  // Create a new Sheets API client.
  const service = google.sheets({version: 'v4', auth});

  // The resource body for creating a new spreadsheet.
  const resource = {
    properties: {
      title,
    },
  };

  // Create the new spreadsheet.
  const spreadsheet = await service.spreadsheets.create({
    resource,
    fields: 'spreadsheetId',
  });

  // Log the ID of the new spreadsheet.
  console.log(`Spreadsheet ID: ${spreadsheet.data.spreadsheetId}`);
  return spreadsheet.data.spreadsheetId;
}

PHP

sheets/snippets/src/SpreadsheetCreate.php

GitHub에서 보기

<?php
use Google\Client;
use Google\Service\Drive;
use Google\Service\Sheets\SpreadSheet;

/**
* create an empty spreadsheet
* 
*/

 function create($title)
    {   
        /* Load pre-authorized user credentials from the environment.
           TODO(developer) - See https://developers.google.com/identity for
            guides on implementing OAuth2 for your application. */
        $client = new Google\Client();
        $client->useApplicationDefaultCredentials();
        $client->addScope(Google\Service\Drive::DRIVE);
        $service = new Google_Service_Sheets($client);
        try{

            $spreadsheet = new Google_Service_Sheets_Spreadsheet([
                'properties' => [
                    'title' => $title
                    ]
                ]);
                $spreadsheet = $service->spreadsheets->create($spreadsheet, [
                    'fields' => 'spreadsheetId'
                ]);
                printf("Spreadsheet ID: %s\n", $spreadsheet->spreadsheetId);
                return $spreadsheet->spreadsheetId;
        }
        catch(Exception $e) {
            // TODO(developer) - handle error appropriately
            echo 'Message: ' .$e->getMessage();
          }
    }

Python

sheets/snippets/sheets_create.py

GitHub에서 보기

import google.auth
from googleapiclient.discovery import build
from googleapiclient.errors import HttpError


def create(title):
  """
  Creates the Sheet the user has access to.
  Load pre-authorized user credentials from the environment.
  TODO(developer) - See https://developers.google.com/identity
  for guides on implementing OAuth2 for the application.
  """
  creds, _ = google.auth.default()
  # pylint: disable=maybe-no-member
  try:
    service = build("sheets", "v4", credentials=creds)
    spreadsheet = {"properties": {"title": title}}
    spreadsheet = (
        service.spreadsheets()
        .create(body=spreadsheet, fields="spreadsheetId")
        .execute()
    )
    print(f"Spreadsheet ID: {(spreadsheet.get('spreadsheetId'))}")
    return spreadsheet.get("spreadsheetId")
  except HttpError as error:
    print(f"An error occurred: {error}")
    return error


if __name__ == "__main__":
  # Pass: title
  create("mysheet1")

Ruby

sheets/snippets/lib/spreadsheet_snippets.rb

GitHub에서 보기

spreadsheet = {
  properties: {
    title: 'Sales Report'
  }
}
spreadsheet = service.create_spreadsheet(spreadsheet,
                                         fields: 'spreadsheetId')
puts "Spreadsheet ID: #{spreadsheet.spreadsheet_id}"

Google Drive 폴더에서 스프레드시트 정리

기본적으로 생성된 스프레드시트는 Google Drive의 사용자 루트 폴더에 저장됩니다.

스프레드시트를 지정된 Drive 폴더에 저장하려면 다음 메서드를 사용하세요.

스프레드시트 파일이 생성된 후 Google Drive API의 files 리소스에서 update 메서드를 사용하여 특정 폴더로 이동합니다. 자세한 내용은 폴더 간에 파일 이동을 참고하세요.
Drive API의 files 리소스에서 create 메서드를 사용하여 폴더에 빈 스프레드시트를 추가하고 application/vnd.google-apps.spreadsheet을(를) mimeType{/7)으로 지정합니다. 파일 만들기에 관한 자세한 내용은 특정 폴더에 파일 만들기를 참고하세요. MIME 유형에 관한 자세한 내용은 Google Workspace 및 Google Drive 에서 지원되는 MIME 유형을 참고하세요.

두 가지 대안 중 하나를 사용하려면 호출을 승인하기 위해 적절한 Drive API scopes 를 추가해야 합니다.

앱에서 서비스 계정을 사용하는 경우 서비스 계정이 생성된 스프레드시트의 소유자입니다. 그러면 이 파일은 서비스 계정의 전용 Drive 스토리지에 있습니다. 파일은 명시적으로 공유되지 않는 한 다른 Drive 스토리지 계정에 표시되지 않습니다. 자세한 내용은 파일 소유권을 참고하세요.

공유 드라이브 폴더 내에서 파일을 이동하거나 만들려면 공유 드라이브 지원 구현을 참고하세요.

Google Sheets의 셀 및 행 한도에 관해 자세히 알아보려면 Google Drive에 저장할 수 있는 파일을 참고하세요.

스프레드시트 가져오기

스프레드시트를 가져오려면 get 메서드를 spreadsheets 리소스에서 spreadsheetId 경로 매개변수와 함께 사용합니다.

이 메서드는 파일을 spreadsheets 리소스의 인스턴스로 반환합니다. 기본적으로 스프레드시트 내의 데이터는 반환되지 않습니다. 반환된 리소스에는 스프레드시트 속성 (예: 제목, 언어, 시간대) 및 일부 세부 시트 정보 (예: 서식 및 보호된 범위)를 비롯한 스프레드시트의 구조와 메타데이터가 포함됩니다.

spreadsheets 리소스 내에 데이터를 포함하려면 다음 두 가지 메서드를 사용합니다.

필드 마스크를 지정하여 선택한 필드를 나열하고 fields 시스템 매개변수를 설정합니다.
불리언 includeGridData 쿼리 매개변수를 true로 설정합니다. 필드 마스크가 설정되면 includeGridData 매개변수가 무시됩니다.

대규모 스프레드시트를 사용하는 경우 필요한 특정 스프레드시트 필드만 쿼리하는 것이 좋습니다. get 메서드는 스프레드시트와 연결된 모든 데이터를 반환하므로 대규모 스프레드시트에 대한 일반적인 쿼리는 느릴 수 있습니다. 예를 들어 셀에서 숫자 100을 읽기 위해 spreadsheets.get은 셀 값과 메타데이터 (예: 글꼴 이름, 크기 등)를 반환하므로 파싱 속도가 느린 대규모 JSON 페이로드가 발생합니다. 반면 values.get에 대한 유사한 호출은 특정 셀 값만 반환하므로 훨씬 가볍고 빠른 응답이 발생합니다.

spreadsheets.values 리소스에 관한 자세한 내용은 spreadsheets.values.get 및 spreadsheets.values.batchGet을 비롯한 다음 문서를 참고하세요.

스프레드시트 나열

Sheets API는 인증된 사용자의 스프레드시트를 나열하는 메서드를 제공하지 않습니다.

스프레드시트 목록을 검색하려면 Drive API의 list 리소스에서 files 메서드를 사용하여 application/vnd.google-apps.spreadsheet으로 mimeType 지정하면 됩니다.

HTTP

GET https://www.googleapis.com/drive/v3/files?q=mimeType='application/vnd.google-apps.spreadsheet'

cURL

curl -X GET "https://www.googleapis.com/drive/v3/files?q=mimeType='application/vnd.google-apps.spreadsheet'" \
 -H "Authorization: Bearer ACCESS_TOKEN" \
 -H "Accept: application/json"

ACCESS_TOKEN을 API에 대한 액세스 권한을 부여하는 액세스 토큰으로 바꿉니다.

files.list 메서드를 사용하여 사용자의 스프레드시트를 나열하려면 제한된 Drive API 범위가 필요합니다.

그 다음으로는 아래와 같은 옵션도 고려해 볼 수 있습니다.

스프레드시트를 업데이트하려면 업데이트 스프레드시트를 참고하세요.
스마트 칩을 사용하려면 Smart chips를 참고하세요.
개발자 메타데이터를 사용하려면 메타데이터 읽기, 쓰기, 검색 을 참고하세요.

스프레드시트 만들기 및 관리 컬렉션을 사용해 정리하기 내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.