Načítáme a zapisujeme data do Tabulek Google pomocí PHP. Krok za krokem

Skript, který načte v PHP data z Tabulek Google není o moc složitější než kterékoli zpracování dat z CSV nebo jiného lokálního souboru. Potřebujete jen tu správnou knihovnu v Composeru. Jedna otravná záležitost vás ale nemine. Je jí vytvoření servisního účtu v Google Cloud Consoli.

Image

Jak získat přístupové údaje pro Google Sheets API

Pokud jste v ní ještě nikdy nebyli, tak vězte, že Google Cloud Console je rozhraní, pomocí kterého si vytváříte přístupové údaje pro aplikace a skripty, které nějakým způsobem automatizují práci s aplikacemi Google. Typicky sem zavítáte pro vygenerování klíčů k využívání mapového portálu na svém webu. Ale výjimkou není ani propojení na dokumenty a tabulky.

1. Přihlaste se svým Google účtem do Google Cloud Console. Vytvořte nový projekt nebo si rozklepněte již existující.
2. Přejděte do části Enabled API and services a klepněte na stejnojmenné tlačítko pro přidání nového API. Vyhledejte Google Sheets API a přidejte jej do svého projektu.
3. Poté přejděte do nově přidaného API ve svém projektu a přepněte se na položku Credentials. Vytvořte nový Service Account. V části s oprávněním mu přidejte Basic > Editor, má-li do tabulky i zapisovat, nebo jenom Basic > Viewer, pokud budete data z tabulky jen číst.
4. Po vytvoření servisního účtu se přepněte na položku Keys a z nabídky vyberte Add key > Create new key.
5. V průvodci zvolte typ klíče JSON a pokračujte jeho vytvořením. Google vám následně nabídne soubor ke stažení. Získaný JSON si překopírujte do svého projektu.

Nově vytvořenému servisnímu účtu je potřeba přidělit oprávnění do konkrétní Google Tabulky. Otevřete si ji, klikněte na Sdílení a přidejte sdílení pro mailovou adresu servisního účtu. Najdete ji v Google Cloud Consoli i ve staženém JSON souboru.

Image

Jak načítat data z tabulky Google pomocí PHP

To nejsložitější máte za sebou a teď už zbývá dát dohromady jenom PHP skript, který bude data z Tabulky Google zpracovávat.

1. Nejprve si do svého projektu příkazem composer require google/apiclient:^2.0 přidejte knihovnu pro práci s API Google.
2. Vytvořte připojení do cloudových služeb Google a připojte přihlašovací klíč ze souboru JSON, který jste vygenerovali v předchozím postupu.
3. Vytvořte novou službu a otevřete konkrétní dokument/tabulku specifikovanou pomocí jejího ID. To snadno vykopírujete z prohlížeče. Koukněte na její URL a vezměte si řetězec nacházející se mezi /d/ a /edit.
4. Specifikujte rozsah dat, která chcete načítat. V mém případě jsou to sloupečky A až G, přičemž nemám omezen počet řádků.
5. Nakonec získáte jednotlivé řádky coby hodnoty dat v tabulce a můžete se pustit do jejich procházení. V příkladu mám smyčku, která projde řádky, podívá se, jestli ve sloupci G je řetězcová hodnota FALSE a pokud ano, zobrazí obsah řádku. Následně nastavím hodnotu na řetězec TRUE a data zapíšu zpět do tabulky.

<?php

require "vendor/autoload.php";

// Připojení k Google API
$client = new \Google_Client();
$client->setApplicationName("Google Sheets API PHP");
$client->setScopes([\Google_Service_Sheets::SPREADSHEETS]);

// Načtení pověření z JSON souboru
$client->setAuthConfig("vas-klic.json");

$service = new \Google_Service_Sheets($client);

// ID tabulky (z URL Google Sheets)
$spreadsheetId = "id-vasi-tabulky";

// Rozsah dat (např. A1:G, tedy všechny řádky a sloupce A až G)
$range = "List 1!A1:G";

// Načtení dat z tabulky
$response = $service->spreadsheets_values->get($spreadsheetId, $range);
$values = $response->getValues();

if (empty($values)) {
    echo "Žádná data nenalezena.\n";
} else {
    foreach ($values as $rowIndex => $row) {
        if (isset($row[6]) && $row[6] == "FALSE") {
            echo implode(", ", $row) . "\n";

            $updatedRange = "List 1!G" . ($rowIndex + 1);
            // +1 kvůli tomu, že indexace začíná na 0
            $body = new \Google_Service_Sheets_ValueRange([
                'values' => [["TRUE"]]
            ]);

            // Aktualizuj tabulku
            $params = ['valueInputOption' => 'RAW'];
            $service->spreadsheets_values->update($spreadsheetId, $updatedRange, $body, $params);
        }
    }
}

Tip: vyhodnocení TRUE a FALSE mě dosti potrápilo. Dostal jsem za úkol zpracovat tabulku, kde je ve sloupečku prázdné nebo zaškrtnuté zatrhovátko. Zobrazení hodnoty mi ukazovalo TRUE nebo FALSE, ale podmínka na něj nereagovala. Až klasická záchrana programátora var_dump($row); mi ukázala, že tento boolean je v tabulce ve skutečnosti uložen jako řetězec. Mimochodem, ukládání zpět jako TRUE nezachová v dokumentu zatrhovátko, ale s tím se dá žít.