Интеграция PHP с Google Docs: создание и управление документами

Создание документа с форматированием: заголовки, жирный текст, списки

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

// Подготовка запросов
$requests = [
    // 1. Вставка заголовка (Heading 1)
    new Google\Service\Docs\Request([
        'insertText' => [
            'location' => ['index' => 1],
            'text' => 'Мой заголовок\n'
        ]
    ]),
    // 2. Применение стиля к заголовку
    new Google\Service\Docs\Request([
        'updateParagraphStyle' => [
            'range' => [
                'startIndex' => 1,
                'endIndex' => 15  // длина "Мой заголовок\n"
            ],
            'paragraphStyle' => [
                'namedStyleType' => 'HEADING_1'
            ],
            'fields' => 'namedStyleType'
        ]
    ]),
    // 3. Вставка параграфа с жирным текстом
    new Google\Service\Docs\Request([
        'insertText' => [
            'location' => ['index' => 15],
            'text' => 'Этот текст будет жирным.\n'
        ]
    ]),
    // 4. Применение форматирования (жирный) к только что вставленному тексту
    new Google\Service\Docs\Request([
        'updateTextStyle' => [
            'range' => [
                'startIndex' => 15,
                'endIndex' => 40
            ],
            'textStyle' => [
                'bold' => true
            ],
            'fields' => 'bold'
        ]
    ]),
    // 5. Маркированный список
    new Google\Service\Docs\Request([
        'createParagraphBullets' => [
            'range' => [
                'startIndex' => 40,
                'endIndex' => 60
            ],
            'bulletPreset' => 'BULLET_DISC_CIRCLE_SQUARE'
        ]
    ])
];

$batchUpdate = new Google\Service\Docs\BatchUpdateDocumentRequest([
    'requests' => $requests
]);
$result = $service->documents->batchUpdate($documentId, $batchUpdate);
echo 'Форматирование применено.';
// Результат: в документе появится заголовок, жирный текст и маркированный список.

// Выходные данные: JSON-объект с результатами batchUpdate (например, изменения в документе).

Как вставить изображение в Google Docs из PHP?

Для вставки изображения необходимо предварительно загрузить его на Google Drive, получить ссылку, а затем использовать запрос insertInlineImage.

// Предположим, что файл изображения уже загружен на Drive и известен fileId
$imageFileId = '1imageFileId';

// Получаем ссылку на контент изображения
$imageUrl = 'https://drive.google.com/uc?id=' . $imageFileId;

$requests = [
    new Google\Service\Docs\Request([
        'insertInlineImage' => [
            'location' => [
                'index' => 1
            ],
            'uri' => $imageUrl,
            'objectSize' => [
                'height' => [
                    'magnitude' => 300,
                    'unit' => 'PT'
                ],
                'width' => [
                    'magnitude' => 400,
                    'unit' => 'PT'
                ]
            ]
        ]
    ])
];

$batchUpdate = new Google\Service\Docs\BatchUpdateDocumentRequest([
    'requests' => $requests
]);
$service->documents->batchUpdate($documentId, $batchUpdate);
echo 'Изображение вставлено.';

Массовое обновление нескольких документов – итерация по списку

Часто требуется применить одинаковые изменения (например, добавить колонтитул) к десяткам документов. Пример перебора документов в папке.

// Получить список всех документов из определённой папки Google Drive
$folderId = '1folderId';
$optParams = [
    'q' => "'$folderId' in parents and mimeType='application/vnd.google-apps.document'",
    'fields' => 'files(id, name)'
];
$files = $driveService->files->listFiles($optParams);

foreach ($files->getFiles() as $file) {
    $docId = $file->getId();
    $docName = $file->getName();
    
    // Создаём запрос на добавление нижнего колонтитула с номером страницы
    $requests = [
        new Google\Service\Docs\Request([
            'createFooter' => [
                'type' => 'DEFAULT'
            ]
        ]),
        new Google\Service\Docs\Request([
            'insertText' => [
                'location' => [
                    'segmentId' => 'ftr1',
                    'index' => 1
                ],
                'text' => 'Страница '
            ]
        ]),
        new Google\Service\Docs\Request([
            'insertPageNumber' => [
                'location' => [
                    'segmentId' => 'ftr1',
                    'index' => 9
                ]
            ]
        ])
    ];
    
    $batchUpdate = new Google\Service\Docs\BatchUpdateDocumentRequest([
        'requests' => $requests
    ]);
    try {
        $service->documents->batchUpdate($docId, $batchUpdate);
        echo "Документ $docName обновлён.\n";
    } catch (Exception $e) {
        echo "Ошибка обновления $docName: " . $e->getMessage() . "\n";
    }
}
// Результат: у всех документов в папке появится нижний колонтитул с номером страницы.

Экспорт документа в PDF и отправка по email

Совмещение Drive API для экспорта и стандартной почтовой функции PHP.

function exportAndEmail($fileId, $toEmail) {
    global $driveService;
    
    // Экспорт в PDF
    $response = $driveService->files->export($fileId, 'application/pdf', [
        'alt' => 'media'
    ]);
    $pdfContent = $response->getBody()->getContents();
    
    // Временное сохранение
    $tempFile = tempnam(sys_get_temp_dir(), 'doc');
    file_put_contents($tempFile, $pdfContent);
    
    // Отправка письма с вложением
    $subject = 'Документ в формате PDF';
    $message = 'Во вложении экспортированный документ Google Docs.';
    $headers = 'From: no-reply@example.com';
    $attachedFile = chunk_split(base64_encode($pdfContent));
    $boundary = md5(time());
    
    $headers .= "\r\nMIME-Version: 1.0\r\n";
    $headers .= "Content-Type: multipart/mixed; boundary=\"$boundary\"\r\n";
    
    $body = "--$boundary\r\n";
    $body .= "Content-Type: text/plain; charset=UTF-8\r\n";
    $body .= "$message\r\n";
    $body .= "--$boundary\r\n";
    $body .= "Content-Type: application/pdf; name=\"document.pdf\"\r\n";
    $body .= "Content-Transfer-Encoding: base64\r\n";
    $body .= "Content-Disposition: attachment\r\n";
    $body .= "$attachedFile\r\n";
    $body .= "--$boundary--";
    
    if (mail($toEmail, $subject, $body, $headers)) {
        echo "Письмо отправлено на $toEmail";
    } else {
        echo "Ошибка отправки письма.";
    }
    
    unlink($tempFile);
}

exportAndEmail('1docId', 'user@example.com');