Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Membuat dan mengelola spreadsheet

Dokumen ini menjelaskan cara membuat dan mengelola spreadsheet di Google Spreadsheet menggunakan Google Sheets API.

Membuat spreadsheet

Untuk membuat file di Spreadsheet, gunakan metode create pada resource spreadsheets tanpa parameter.

Saat Anda membuat file, metode ini akan menampilkan resource spreadsheets. Resource yang ditampilkan berisi spreadsheetId, properties, daftar sheets, dan spreadsheetUrl.

Contoh kode berikut menunjukkan cara membuat spreadsheet kosong dengan judul tertentu.

Apps Script

sheets/api/spreadsheet_snippets.gs

Lihat di GitHub

/**
 * 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);
  }
};

Java

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

Lihat di 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

Lihat di 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

Lihat di 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

Lihat di 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

Lihat di 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

Lihat di GitHub

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

Mengatur spreadsheet di folder Google Drive

Secara default, spreadsheet yang dibuat akan disimpan ke folder root pengguna di Google Drive.

Jika Anda ingin menyimpan spreadsheet ke folder Drive tertentu, gunakan metode berikut:

Setelah file spreadsheet dibuat, pindahkan ke folder tertentu menggunakan metode update pada files resource Google Drive API. Untuk mengetahui informasi selengkapnya, lihat Memindahkan file antar- folder.
Tambahkan spreadsheet kosong ke folder menggunakan metode create pada resourcefiles Drive API, dengan menentukan application/vnd.google-apps.spreadsheet sebagai mimeType. Untuk mengetahui informasi selengkapnya tentang cara membuat file, lihat Membuat file di folder tertentu. Untuk mengetahui informasi selengkapnya tentang jenis MIME, lihat Jenis MIME yang didukung Google Workspace dan Google Drive.

Untuk salah satu alternatif, Anda harus menambahkan cakupan Drive API yang sesuai untuk mengotorisasi panggilan.

Jika aplikasi Anda menggunakan Akun Layanan, Akun Layanan tersebut akan memiliki spreadsheet yang dibuat. File ini kemudian berada di penyimpanan Drive khusus Akun Layanan. File tidak akan muncul dalam akun penyimpanan Drive lainnya kecuali jika dibagikan secara eksplisit. Untuk mengetahui informasi selengkapnya, lihat Kepemilikan file.

Untuk memindahkan atau membuat file dalam folder drive bersama, lihat Menerapkan dukungan drive bersama.

Untuk mempelajari lebih lanjut batas sel dan baris di Google Spreadsheet, lihat File yang dapat Anda simpan di Google Drive.

Mendapatkan spreadsheet

Untuk mendapatkan spreadsheet, gunakan metode get pada resource spreadsheets dengan parameter jalur spreadsheetId.

Metode ini menampilkan file sebagai instance resource spreadsheets. Secara default, data dalam spreadsheet tidak ditampilkan. Resource yang ditampilkan berisi struktur dan metadata spreadsheet, termasuk properti spreadsheet (seperti judul, lokalitas, dan zona waktu) serta beberapa informasi sheet mendetail (seperti pemformatan dan rentang yang dilindungi).

Untuk menyertakan data dalam resource spreadsheets, gunakan dua metode berikut:

Tentukan mask kolom yang mencantumkan kolom yang dipilih dengan menetapkan fields parameter sistem.
Tetapkan parameter kueri boolean includeGridData ke true. Jika mask kolom ditetapkan, parameter includeGridData akan diabaikan.

Saat Anda menggunakan spreadsheet besar, sebaiknya buat kueri hanya untuk kolom spreadsheet tertentu yang Anda butuhkan. Metode get menampilkan semua data yang terkait dengan spreadsheet, sehingga kueri umum untuk spreadsheet besar dapat berjalan lambat. Misalnya, untuk membaca angka 100 dari sel, spreadsheets.get akan menampilkan nilai sel beserta metadata (seperti nama font, ukuran, dll.) sehingga menghasilkan payload JSON besar yang lambat diuraikan. Sebagai perbandingan, panggilan serupa ke values.get hanya menampilkan nilai sel tertentu sehingga menghasilkan respons yang jauh lebih ringan dan cepat.

Untuk mengetahui informasi selengkapnya tentang resource spreadsheets.values, termasuk spreadsheets.values.get dan spreadsheets.values.batchGet, lihat dokumen berikut:

Mencantumkan spreadsheet

Sheets API tidak menawarkan metode untuk mencantumkan spreadsheet bagi pengguna yang diautentikasi.

Untuk mengambil daftar spreadsheet, Anda dapat menggunakan metode list Drive API pada resource files, dengan menentukan application/vnd.google-apps.spreadsheet sebagai 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"

Ganti ACCESS_TOKEN dengan token akses yang memberikan akses ke API.

Penggunaan metode files.list untuk mencantumkan spreadsheet pengguna memerlukan cakupan Drive API yang dibatasi.

Berikut beberapa langkah yang dapat Anda coba:

Untuk memperbarui spreadsheet, lihat Memperbarui spreadsheet.
Untuk menggunakan smart chip, lihat Smart chips.
Untuk menggunakan metadata developer, lihat Membaca, menulis, dan menelusuri metadata.

Membuat dan mengelola spreadsheet Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Membuat spreadsheet

Apps Script

Java

JavaScript

Node.js

PHP

Python

Ruby

Mengatur spreadsheet di folder Google Drive

Mendapatkan spreadsheet

Mencantumkan spreadsheet

HTTP

cURL

Topik terkait

Membuat dan mengelola spreadsheet