E-tablo oluşturma ve yönetme

Bu belgede, Google E-Tablolar API'si kullanılarak Google E-Tablolar'da e-tabloların nasıl oluşturulacağı ve yönetileceği açıklanmaktadır.

E-tablo oluştur

E-Tablolar'da dosya oluşturmak için parametre içermeyen spreadsheets kaynağında create yöntemini kullanın.

Dosyayı oluşturduğunuzda yöntem bir spreadsheets kaynağı döndürür. Döndürülen kaynakta spreadsheetId, properties, sheets listesi ve spreadsheetUrl bulunur.

Aşağıdaki kod örneğinde, belirtilen başlığa sahip boş bir e-tablonun nasıl oluşturulacağı gösterilmektedir.

Apps Komut Dosyası

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

Java

sheets/snippets/src/main/java/Create.java
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
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
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
<?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
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
spreadsheet = {
  properties: {
    title: 'Sales Report'
  }
}
spreadsheet = service.create_spreadsheet(spreadsheet,
                                         fields: 'spreadsheetId')
puts "Spreadsheet ID: #{spreadsheet.spreadsheet_id}"

Google Drive klasörlerinde e-tabloları düzenleme

Oluşturulan e-tablo, varsayılan olarak kullanıcının Google Drive'daki kök klasörüne kaydedilir.

Bir e-tabloyu belirli bir Drive klasörüne kaydetmek istiyorsanız aşağıdaki yöntemleri kullanın:

Her iki alternatif için de çağrıyı yetkilendirmek üzere uygun Drive API kapsamlarını eklemeniz gerekir.

Uygulamanız bir hizmet hesabı kullanıyorsa oluşturulan e-tablonun sahibi hizmet hesabıdır. Bu dosya daha sonra hizmet hesabının özel Drive depolama alanında yer alır. Dosyalar açıkça paylaşılmadığı sürece diğer Drive depolama alanlarında görünmez. Daha fazla bilgi için Dosya sahipliği başlıklı makaleyi inceleyin.

Ortak Drive klasöründe dosya taşımak veya oluşturmak için Ortak Drive desteğini uygulama başlıklı makaleyi inceleyin.

Google E-Tablolar'daki hücre ve satır sınırları hakkında daha fazla bilgi edinmek için Google Drive'da depolayabileceğiniz dosyalar başlıklı makaleyi inceleyin.

E-tablo alma

E-tablo almak için spreadsheetId yol parametresiyle birlikte spreadsheets kaynağında get yöntemini kullanın.

Yöntem, dosyayı spreadsheets kaynağının bir örneği olarak döndürür. Varsayılan olarak, e-tablodaki veriler döndürülmez. Döndürülen kaynak, e-tablo özelliklerinin (başlık, yerel ayar ve saat dilimi gibi) yanı sıra biçimlendirme ve korumalı aralıklar gibi bazı ayrıntılı sayfa bilgilerini de içeren e-tablonun yapısını ve meta verilerini içerir.

spreadsheets kaynağına veri eklemek için şu iki yöntemi kullanın:

  • fields Sistem parametresini ayarlayarak seçtiğiniz alanları listeleyen bir alan maskesi belirtin.

  • includeGridData boolean sorgu parametresini true olarak ayarlayın. Alan maskesi ayarlanırsa includeGridData parametresi yoksayılır.

Büyük e-tablolarla çalışırken yalnızca ihtiyacınız olan belirli e-tablo alanlarını sorgulamanızı öneririz. get yöntemi, e-tabloyla ilişkili tüm verileri döndürür. Bu nedenle, büyük e-tablolar için genel sorgular yavaş olabilir. Örneğin, bir hücreden 100 sayısını okumak için kullanılan spreadsheets.get, hücre değerini meta verilerle (ör. yazı tipi adı, boyutu vb.) birlikte döndürür. Bu da ayrıştırılması yavaş olan büyük JSON yükleriyle sonuçlanır. Buna karşılık, values.get için benzer bir çağrı yalnızca belirli hücre değerini döndürür ve bu da çok daha hafif ve hızlı bir yanıtla sonuçlanır.

spreadsheets.values kaynağı hakkında daha fazla bilgi edinmek için (spreadsheets.values.get ve spreadsheets.values.batchGet dahil) aşağıdaki belgeleri inceleyin:

E-tabloları listeleme

Sheets API, kimliği doğrulanmış kullanıcıların e-tablolarını listelemek için bir yöntem sunmaz.

E-tabloların listesini almak için Drive API'nin list yöntemini files kaynağında kullanabilir ve application/vnd.google-apps.spreadsheet değerini mimeType olarak belirtebilirsiniz:

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 kısmını, API'ye erişim izni veren erişim jetonuyla değiştirin.

Bir kullanıcının e-tablolarını listelemek için files.list yöntemini kullanmak kısıtlanmış bir Drive API kapsamı gerektirir.

Deneyebileceğiniz bazı sonraki adımlar: