Обзор документации
Начало работы
Установите Go SDK и запустите типизированный запрос Google Search. Затем попробуйте YouTube с тем же клиентом.
Установите SDK
Требуется Go 1.25+. Выберите новый проект или установите в каталог, содержащий существующий go.mod.
Установитьmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Установитьgo get github.com/flashdatadev/[email protected]аутентифицировать
Зарегистрируйтесь, проверьте свою электронную почту и создайте ключ API с разрешения Google Search или повторно используйте авторизованный ключ.
Установите FLASHDATA_API_KEY ниже или сохраните значение, уже предоставленное вашей средой. В примере он читается явно; файлы .env не загружаются.
Скрытая подсказка ключа · Bash# Bash: paste the key into a hidden prompt, not into this command. read -r -s -p "FlashData API key: " FLASHDATA_API_KEY printf '\n' export FLASHDATA_API_KEYСкрытая подсказка ключа · PowerShell# PowerShell 7: paste the key into a hidden prompt. $flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString $env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password Remove-Variable flashdataSecureKeyВыполните поиск
Сохраните это как main.go рядом с go.mod, а затем запустите его в том же терминале. Он отправляет один поиск до пяти результатов и печатает ответ JSON.
main.gopackage main import ( "context" "encoding/json" "log" "os" "time" flashdata "github.com/flashdatadev/flashdata-go" ) func main() { key := os.Getenv("FLASHDATA_API_KEY") if key == "" { log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.") } client, err := flashdata.New(flashdata.Options{APIKey: key}) if err != nil { log.Fatal(err) } ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute) defer cancel() result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{ Query: "battery recycling research", Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))}, }) if err != nil { // Do not automatically resubmit an uncertain paid request. log.Fatal(err) } if err := json.NewEncoder(os.Stdout).Encode(result); err != nil { log.Fatal(err) } if result.Status != "done" { log.Fatalf("Search did not complete: %s", result.Status) } }Запуститьgo run .Проверьте результат
Ищите status: done в распечатанном JSON. Используйте возвращенные заголовки, URLs и фрагменты в вашем приложении или агенте. Пустой органический список также является действительным результатом.
Примерный выход{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- Выполненный означает завершенный поиск.
results[].organic[]- Результаты поиска с заголовками, ссылками и сниппетами.
usage.credits- Кредиты, использованные по данному запросу. Пять результатов — это один поиск, а не пять запросов.
Попробуйте другой источник данных
В main.go заменить только результат, err := client.Google.Search(...) вызов с одним из этих вызовов. Сохраняйте клиент, контекст, проверку ошибок и выход JSON, а затем снова запускайте и запускайте. Каждый из них подает новый запрос.
Требуется разрешение google_news. Возвращает результаты новостей для вашего запроса.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Требуется разрешение youtube_metadata. Возвращает видео детали, такие как название, канал и продолжительность; он не загружает видео.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Требуется разрешение youtube_transcript. Запрашивается существующая английская расшифровка, включая автоматические дорожки. Возвращает текст и временные метки, когда этот трек доступен.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})Что поддерживает Go SDK
Google- Поиск, новости, изображения, покупки, видео и места. Используйте Google.Pages для получения результатов.
YouTube- Поиск, метаданные, транскрипт, подписи, канал и предложения предоставляют структурированные видеоданные.
YouTube.Download- Отправьте работу по доставке аудио или видео в ваше облачное хранилище. Требуется разрешение youtube_download и конфигурация хранилища; используйте полный пример ниже.
Jobs / Bulk- Отправьте с помощью Async помощник, сохранить работу ID, затем использовать Jobs.Wait и Jobs.Result. Bulk обрабатывает большие наборы данных и рабочие места.
Account- Прочтите информацию об идентичности, балансе, ценах, ограничениях и использовании до начала работы без присмотра. Повторное использование одного и того же клиентского и авторизованного ключа.
WithFormat- Запросить JSON, простой текст или Markdown с явными вариантами формата. Форматы Markdown извлекают данные для вашего агента; ваше приложение предоставляет вызовы или резюме модели.
Типы Go
GoogleSearchInput описывает запрос. Дополнительные параметры используют указатели, такие как flashdata.Ptr(int64(5)). Результаты содержат источник JSON; используйте DecodeResults [GoogleSearchPayload], когда вам нужны набранные поля.
Следующие шаги
Если шаг не удался
- Отсутствует пакет или время выполнения
- Проверьте версию Go и запустите Go, чтобы получить в каталоге, содержащем go.mod.
- 401 / FLASHDATA_API_KEY
- Установите действительный ключ в терминале, где вы запускаете пример.
- 403
- Включите Google Search для этого ключа API.
- 402
- Проверить Billing на наличие кредитов или потребовать исчерпанного агента.
- 429
- Подождите Retry-After, а затем уменьшите скорость запроса.
- Тайм-аут или ошибка сервера
- Проверьте History перед отправкой; первый запрос, возможно, уже запущен.