Przeglądaj dokumentację
Pierwsze kroki
Zainstaluj Go SDK i uruchom wpisany wniosek Google Search. Następnie spróbuj danych YouTube z tym samym klientem.
Zainstaluj SDK
Wymaga Go 1.25 +. Wybierz nowy projekt lub zainstaluj w katalogu zawierającym istniejący go.mod.
Zainstalujmkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Zainstalujgo get github.com/flashdatadev/[email protected]Uwierzytelnij
Zarejestruj się, weryfikuj swój e-mail i utwórz klucz API za zgodą Google Search lub ponownie użyj autoryzowanego klucza.
Ustaw FLASHDATA_API_KEY poniżej lub zachowaj wartość dostarczoną już przez środowisko. Przykład odczytuje go wyraźnie; pliki .env nie są wczytane.
Ukryty sygnał klawiszowy · 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_KEYUkryty sygnał klawiszowy · 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 flashdataSecureKeyWykonaj wyszukiwanie
Zapisz to jako main.go obok go.mod, a następnie uruchom go w tym samym terminalu. Wysyła jedno wyszukiwanie do pięciu wyników i drukuje odpowiedź 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) } }Uruchomgo run .Sprawdź wynik
Szukaj status: done w wydrukowanym JSON. Użyj zwróconych tytułów, URLs i snippetów w aplikacji lub agencie. Pusta lista organicznych jest również prawidłowym wynikiem.
Przykład wyjścia{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- to znaczy, że przeszukanie zakończone.
results[].organic[]- Wyniki wyszukiwania z polami tytułu, linka i snippetu.
usage.credits- Kredyty wykorzystane w niniejszym wniosku. Pięć wyników to jedno wyszukiwanie, a nie pięć wniosków.
Spróbuj innego źródła danych
W main.go zastąpić tylko wynik, err: = client.Google.Search (...) wywołanie jednym z tych wywołań. Zachowaj klienta, kontekst, sprawdzanie błędów i wyjście JSON, a następnie uruchom go uruchomić. Każda runda składa jedną nową prośbę.
Wymaga zezwolenia google_news. Zwraca wyniki wiadomości dla Twojego zapytania.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Wymaga zezwolenia youtube_metadata. Zwraca szczegóły wideo, takie jak tytuł, kanał i czas trwania; nie pobiera wideo.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Wymaga zezwolenia youtube_transcript. Prosi o istniejący angielski transkrypt, w tym automatyczne utwory. Zwraca znaczniki tekstowe i czasowe, gdy utwór jest dostępny.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})Co obsługuje Go SDK
Google- Szukaj, Aktualności, Zdjęcia, Zakupy, Filmy i Miejsca. Użyj Google.Pages do uzyskania wyników z paginami.
YouTube- Wyszukiwanie, Metadane, Transcript, Podpisy, Kanał i Sugestie dostarczają uporządkowanych danych wideo.
YouTube.Download- Prześlij zadanie dostarczania dźwięku lub obrazu do pamięci masowej w chmurze. Wymaga uprawnień youtube_download i konfiguracji pamięci masowej; użyj pełnego przykładu poniżej.
Jobs / Bulk- Prześlij za pomocą helpera Async, zapisz zadanie ID, a następnie użyj Jobs.Wait i Jobs.Result. Bulk obsługuje większe zbiory danych i wznowione zadania.
Account- Czytać tożsamość, równowagę, ceny, ograniczenia i wykorzystanie przed pracą bez opieki. Użyj ponownie tego samego klienta i autoryzowanego klucza.
WithFormat- Poproś JSON, zwykły tekst lub Markdown z opcji wyraźnego formatu. Formaty Markdown pobrane dla Twojego agenta; aplikacja dostarcza modele połączeń lub podsumowań.
Typy Go
GoogleSearchInput opisuje zapytanie. Opcjonalne parametry wykorzystują wskaźniki, takie jak flashdata.Ptr (int64 (5)). Wyniki zawierają źródło JSON; użyj DecodeResults [GoogleSearchPayload], gdy potrzebujesz pola wpisowego.
Kolejne kroki
Jeśli krok zawiedzie
- Brak opakowania lub czasu startowego
- Sprawdź go wersji i uruchom go dostać się do katalogu zawierającego go.mod.
- 401 / FLASHDATA_API_KEY
- Ustaw poprawny klucz w terminalu, w którym uruchomisz przykład.
- 403
- Włącz Google Search dla tego klawisza API.
- 402
- Sprawdź Billing dostępne kredyty, lub zażądać wyczerpanego procesu agenta.
- 429
- Poczekaj na Retry-After, a następnie zmniejsz stawkę zapotrzebowania.
- Błąd timeout lub serwera
- Zaznacz History przed zwrotem; pierwsze żądanie może być już uruchomione.