Google Spreadsheets и PHP

1. Подготовка электронной таблицы для программного доступа
2. Чтение данных из электронной таблицы с помощью PHP
3. Начальная загрузка Google API Authentication
4. Получение реальных данных
5. Вставка, обновление и удаление из электронной таблицы с помощью PHP
6. Обновление ячеек
7. Обновление строк
8. Удаление строк
9. Вставка строк
10. Поиск проблемы

Вам когда-нибудь нужно было извлечь некоторые данные из таблицы Google? В прошлом я по умолчанию использовал экспорт данных и их прямую загрузку в приложение, но оказалось, что их не очень сложно читать напрямую из таблиц Google с помощью API-интерфейса Google Drive.

В этом руководстве мы будем читать, записывать, обновлять и удалять данные из таблицы Google с помощью всего лишь нескольких строк PHP.

В последнее время я провел много времени, работая с группами активистов в сфере технологий, и часто людям, которые хотят работать с данными, является контактная информация законодателей. Давайте возьмем эту таблицу с контактная информация для всех законодателей Соединенных Штатов , Сделайте копию этой таблицы в своем аккаунте, и мы готовы к работе.

Подготовка электронной таблицы для программного доступа

По умолчанию новая электронная таблица недоступна через API Google. Нам нужно будет перейти к вашей консоли API Google, создать новый проект и настроить его для предоставления данных ваших таблиц.

1. Перейти к Консоль API Google ,
2. Создать новый проект.
3. Нажмите Включить API . Найдите и включите Google Drive API.
4. Создайте учетные данные для веб-сервера для доступа к данным приложения .
5. Назовите учетную запись службы и предоставьте ей роль редактора проекта .
6. Загрузите файл JSON.
7. Скопируйте файл JSON в каталог вашего приложения и переименуйте его в client_secret. JSON

Теперь у нас есть большой кусок информации для аутентификации, включая то, что Google называет client_email, который уникально представляет эту учетную запись службы OAuth. Получите значение client_email из вашего client_secret. json, и возвращайся к своей таблице. Нажмите кнопку « Поделиться» в правом верхнем углу и вставьте значение client_email в поле, чтобы предоставить ему права на редактирование. Хит отправить. Это оно!

Чтение данных из электронной таблицы с помощью PHP

Давайте начнем строить!

Мы не будем писать здесь какой-либо специфичный для фреймворка код; если у вас установлен и загружен Composer, вы готовы следовать за ним.

Хотите попробовать это с ванильным PHP? Создайте файл PHP в каталоге вашего проекта для хранения этого кода и в начале файла сразу после
<? PHP поставить эту строку:

требуется __DIR__. '/Vendor/autoload.php';

Теперь создайте файл в вашем проекте с именем composer. json и поместите в него пустой объект JSON:

Если вы хотите проверить свой код, просто запустите php yourfilename. Php. Вы готовы начать кодирование!

Начальная загрузка Google API Authentication

Во-первых, требовать наши пакеты; мы будем использовать Google / apiclient библиотека для аутентификации и asimlqt / PHP-Google-таблицы-клиент библиотека для доступа к электронным таблицам:

composer требуется google / apiclient: «^ 2.0» composer требуется asimlqt / php-google-spreadsheet-client: «3.0. *»

Затем, где-нибудь в процессе загрузки (в рамках, я бы поместил его в загрузочный файл или в сервис-провайдера, но сейчас вы можете просто поместить его в начало файла), вы захотите инициализировать клиент с помощью токен, который мы сгенерируем с помощью библиотеки google / apiclient:

putenv ('GOOGLE_APPLICATION_CREDENTIALS ='. __DIR__. '/client_secret.json'); $ client = new Google_Client; $ Client-> useApplicationDefaultCredentials (); $ client-> setApplicationName («Что-то делать с моими представителями»); $ Client-> setScopes ([ 'https://www.googleapis.com/auth/drive','https://spreadsheets.google.com/feeds']); if ($ client-> isAccessTokenExpired ()) {$ client-> refreshTokenWithAssertion (); } $ accessToken = $ client-> fetchAccessTokenWithAssertion () ["access_token"]; ServiceRequestFactory :: setInstance (новый DefaultServiceRequest ($ accessToken));

Я знаю, что это немного сложно, но вы должны сделать это только один раз, и тогда все ваши запросы в вашем приложении будут просто правильно аутентифицироваться. Вы узнаете, что приложение подключается правильно, если действия в следующем разделе работают без ошибок.

Получение реальных данных

Далее, давайте создадим маршрут, который вы можете посетить в своем браузере, и начните получать реальные данные. Если вы тестируете это на ванильном PHP, просто добавьте это внизу файла, над которым вы работаете.

Все наши звонки начнутся с получения электронной таблицы, а оттуда - рабочего листа с нашими данными.

// Получить нашу электронную таблицу $ spreadsheet = (new Google \ Spreadsheet \ SpreadsheetService) -> getSpreadsheetFeed () -> getByTitle ('Copy of Legislators 2017'); // Получить первый лист (вкладка) $ worksheets = $ spreadsheet-> getWorksheetFeed () -> getEntries (); $ worksheet = $ worksheets [0];

Чтобы показать, что этот рабочий лист работает , давайте переберем каждую запись и выведем ее:

$ listFeed = $ worksheet-> getListFeed (); / ** @var ListEntry * / foreach ($ listFeed-> getEntries () как $ entry) {$ представитель = $ entry-> getValues ​​(); }

Мы работаем с объектом ListFeed, который представляет собой «список» строк, и каждая строка внутри этого списка возвращается как объект ListEntry.

Когда мы распечатаем их, мы увидим наш вывод со значением каждой ячейки, прикрепленной к строке заголовка для каждого столбца. Массив будет выглядеть примерно так:

{'фамилия': "Браун", "имя": "Шеррод", "день рождения": "9.11.1952", "пол": "М", ...}

Обратите внимание, что этот SDK использует Google Spreadsheet API v3, основанный на XML; Одним из недостатков формата является то, что он удаляет все подчеркивания из имен столбцов, превращая last_name в lastname, а first_name в firstname. Если вы хотите обойти это, вы можете просто разобраться с этим, как есть, использовать одну из немногих сравнительно непроверенных библиотек Google Spreadsheets v4 или сопоставить свои записи вручную, используя объект CellFeed, как определено ниже.

Вместо этого мы могли бы получить объект CellFeed, который позволяет нам получать каждую строку в качестве необработанных записей без сопоставления с заголовком:

$ cellFeed = $ worksheet-> getCellFeed (); $ row = $ cellFeed-> toArray ()); [["last_name", "first_name", "birthday", "пол", ...], ["Brown", "Sherrod", "9/19/1952", "M", ...],. ..]

Мы также можем использовать объект CellFeed для получения одной ячейки по индексам столбцов / строк:

$ cellFeed = $ worksheet-> getCellFeed (); / ** @var CellEntry * / $ topLeftCornerCell = $ cellFeed-> getCell (1, 1); echo $ topLeftCornerCell-> content; // "Фамилия"

Наконец, мы также можем просто экспортировать весь лист в формате CSV:

return $ worksheet-> getCsv ();

Вставка, обновление и удаление из электронной таблицы с помощью PHP

До сих пор мы читали только из таблицы. Но мы также можем обновить и удалить строки или ячейки, которые мы извлекаем, или даже вставить наши собственные ячейки или таблицы.

Обновление ячеек

Во-первых, давайте возьмем одну из тех ячеек, которые мы получили, и обновим ее:

$ cellFeed = $ worksheet-> getCellFeed (); / ** @var CellEntry * / $ firstEntryLastName = $ cellFeed-> getCell (2, 1); $ FirstEntryLastName-> обновление ( 'Doe');

Обновление строк

Мы также можем обновить всю строку, указав имена столбцов:

$ listFeed = $ worksheet-> getListFeed (); / ** @var ListEntry * / foreach ($ listFeed-> getEntries () как $ entry) {if ($ entry-> getValues ​​() ['lastname'] === 'Brown') {// Взять запись и обновить только свойство `lastname` $ entry-> update (array_merge ($ entry-> getValues ​​(), ['lastname' => 'Doe'])); перерыв; }}

Удаление строк

Давайте удалим полную строку:

$ listFeed = $ worksheet-> getListFeed (); foreach ($ listFeed-> getEntries () как $ entry) {if ($ entry-> getValues ​​() ['twitter'] === 'SenatorCarper') {$ entry-> delete (); перерыв; }}

Пакет Spreadsheets, который мы используем, нацелен на получение полных списков, а не на извлечение отдельных элементов из списка, поэтому нам нужно использовать и разбивать foreach. Если бы мы использовали конвейер коллекций, такой как коллекции Laravel, это было бы немного чище:

collect ($ worksheet-> getListFeed () -> getEntries ()) -> first (функция ($ entry) {return $ entry-> getValues ​​() ['twitter'] === 'SenatorCarper';}) -> delete ();

Вставка строк

Мы также можем добавить свои собственные строки на лист. Нам нужно захватить объект ListFeed и запустить на нем вставку.

$ listFeed = $ worksheet-> getListFeed (); $ listFeed-> insert (['lastname' => 'Stauffer', 'firstname' => "Matt", // ...]);

Поиск проблемы

Если вы видите эту ошибку при вставке или обновлении:

Пустые строки не могут быть записаны; используйте вместо этого удалить.

Вероятно, потому что вы не определили один из столбцов. Даже если вы устанавливаете пустое значение, вы все равно должны предоставить его.

Теперь, когда вы знаете, как читать, вставлять, обновлять и удалять записи из вашей электронной таблицы Google, у вас есть полнофункциональный слой базы данных, который легко раскручивается, и встроенный слой пользовательского интерфейса для не-технических людей, чтобы просматривать и администрировать свои данные.

Спасибо Greg Baugues за идею и оригинальный пост по использованию Google Spreadsheets и Python ,

-----

Мэтт Штауффер - автор книги О'Рейли Laravel: работает и работает и партнер и технический директор в Затянуть Co , Вы можете найти его в Твиттере на @stauffermatt ,

Похожие

Комментарии