Переглянути документацію
Початок роботи
Встановіть 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 beside 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.mod.
- 401 / FLASHDATA_API_KEY
- Встановіть ключ в терміналі, де ви запустіть приклад.
- 403
- Увімкнути Google Search для цього ключа API.
- 402
- Перевірте Billing для доступних кредитів, або вимагати вичерпне випробування агента.
- 429
- Зачекайте Retry-After, потім знижуйте курс запиту.
- Терміни або помилка сервера
- Перевірити History перед перезапуском; перший запит вже може запуститися.