Работа с Google API из PHP: установка, аутентификация, вызов методов

Как авторизовать приложение без участия пользователя с помощью сервисного аккаунта?

Сервисный аккаунт (Service Account) позволяет выполнять запросы от имени приложения без участия реального пользователя. Это идеально подходит для серверных сценариев (фоновые задачи, миграция данных). Для работы необходимо создать сервисный аккаунт в Google Cloud, скачать JSON-файл с ключом и предоставить доступ аккаунту к нужному ресурсу (например, дать email сервисного аккаунта права редактора на таблицу).

<?php
require_once 'vendor/autoload.php';
$client = new Google_Client();
$client->setAuthConfig('service-account-key.json');
$client->setScopes([Google_Service_Sheets::SPREADSHEETS]);

$service = new Google_Service_Sheets($client);
$spreadsheetId = '1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVT-FpVY';
$range = 'Лист1!A1:B2';
$response = $service->spreadsheets_values->get($spreadsheetId, $range);
$values = $response->getValues();
print_r($values);

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

Как получить доступ к публичным данным Google без аутентификации, используя API-ключ?

Для некоторых Google API (например, Custom Search, YouTube Data API v3, Google Maps) можно использовать простой API-ключ, если данные являются общедоступными. Ключ создается в Google Cloud Console и передается в запросе через параметр key.

<?php
$apiKey = 'AIzaSy...';
$searchQuery = urlencode('PHP integration');
$cx = 'YOUR_CX'; // ID пользовательского поиска
$url = "https://www.googleapis.com/customsearch/v1?q=$searchQuery&cx=$cx&key=$apiKey";
$response = file_get_contents($url);
$data = json_decode($response, true);
foreach ($data['items'] as $item) {
    echo $item['title'] . "\n";
}

Пояснение: Запрос выполняется напрямую через HTTP. Не требуется OAuth и управление токенами. Подходит для чте-ния публичных данных, но не для записи или доступа к личным данным пользователей.

Как выполнять запросы к Google API вручную через cURL, отказавшись от библиотеки?

Если Springphp приложение должно оставаться легковесным или по каким-то причинам не может использовать официальную библиотеку, можно самостоятельно формировать HTTP-запросы. Этот вариант требует реализации OAuth 2.0 “с нуля”: получить код авторизации, обменять его на токен, обновлять токен. Приведем пример получения токена через cURL:

<?php
$clientId = '...';
$clientSecret = '...';
$authCode = '...'; // получен от пользователя

$ch = curl_init('https://oauth2.googleapis.com/token');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'code' => $authCode,
    'client_id' => $clientId,
    'client_secret' => $clientSecret,
    'redirect_uri' => 'urn:ietf:wg:oauth:2.0:oob',
    'grant_type' => 'authorization_code',
]));
$result = curl_exec($ch);
curl_close($ch);
$tokenData = json_decode($result, true);
echo 'Access token: ' . $tokenData['access_token'];

Затем с этим токеном можно делать запрос к API, добавляя заголовок Authorization: Bearer ....