Об этом проекте

Этот репозиторий предоставляет автоматически сгенерированные клиентские библиотеки Go для API Google, созданные на основе JSON-файлов описания Google Discovery Service. Каждый API представлен отдельным импортируемым пакетом, поэтому можно подключить только необходимое, например google.golang.org/api/tasks/v1 или google.golang.org/api/urlshortener/v1, а затем создать сервис с помощью NewService(ctx). Ключевые характеристики: - Сгенерированный код: библиотеки создаются генератором на основе документов Discovery, поэтому между выпусками могут появляться критические изменения; генератор и его вывод считаются бета-версией. - Статус поддержки: официально поддерживаются Google, но библиотеки описаны как завершённые и находящиеся в режиме сопровождения, то есть критические ошибки и проблемы безопасности устраняются, а новые функции не добавляются. - Облачные API: для сервисов Google Cloud Platform, таких как Datastore или Pub/Sub, README направляет пользователей к отдельным Cloud Client Libraries for Go. Авторизация: - По умолчанию сервисы используют Google Application Default Credentials, что позволяет приложениям работать во многих средах без явной конфигурации. - JSON-файлы ключей можно передавать через option.WithAuthCredentialsFile с явным типом учётных данных (например, ServiceAccount), либо JSON-учётные данные напрямую через option.WithAuthCredentialsJSON. - Более старые функции option.WithCredentialsFile и option.WithCredentialsJSON устарели из-за потенциального риска безопасности. - Для более тонкого контроля можно передать oauth2.TokenSource из golang.org/x/oauth2 с помощью option.WithTokenSource. Документация и примеры: - Упоминаются руководство Getting Started и каталог examples для более длинных учебных материалов и примеров использования. - Документация по пакетам доступна на pkg.go.dev, а поддержка сообщества направляется в список рассылки golang-nuts. Это набор SDK для разработчиков, а не приложение для конечных пользователей; его ценность в том, что он даёт программам на Go типизированный доступ к широкому спектру API Google с единообразными шаблонами аутентификации.