Parcourir la documentation
Premiers pas
Installez le SDK Go et exécutez une requête Google Search typée. Essayez ensuite les données YouTube avec le même client.
Installez le SDK
Nécessite Go 1.25+. Créez un projet ou installez le SDK dans le dossier contenant votre fichier go.mod existant.
Installermkdir flashdata-demo cd flashdata-demo go mod init example.com/flashdata-demo go get github.com/flashdatadev/[email protected]Installergo get github.com/flashdatadev/[email protected]Authentifiez-vous
Inscrivez-vous, vérifiez votre adresse e-mail et créez une clé API autorisant Google Search, ou réutilisez une clé autorisée.
Définissez FLASHDATA_API_KEY ci-dessous ou conservez la valeur déjà fournie par votre environnement. L’exemple lit explicitement cette variable ; il ne charge pas les fichiers .env.
Saisie masquée de la clé · 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_KEYSaisie masquée de la clé · 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 flashdataSecureKeyLancez une recherche
Enregistrez ce code dans main.go, à côté de go.mod, puis exécutez-le dans le même terminal. Il soumet une recherche demandant jusqu’à cinq résultats et affiche la réponse 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) } }Exécutergo run .Vérifiez le résultat
Vérifiez status: done dans le JSON affiché. Utilisez les titres, URL et extraits renvoyés dans votre application ou votre agent. Une liste organic vide constitue aussi un résultat valide.
Exemple de sortie{ "status": "done", "results": [ { "organic": [ { "title": "Battery recycling research", "link": "https://example.org/recycling", "snippet": "An example search excerpt." } ] } ], "usage": { "credits": 0.02 } }status- done indique que la recherche est terminée.
results[].organic[]- Résultats de recherche avec les champs title, link et snippet.
usage.credits- Crédits consommés par cette requête. Cinq résultats correspondent à une recherche, pas à cinq requêtes.
Essayez une autre source de données
Dans main.go, remplacez uniquement l’appel result, err := client.Google.Search(...) par l’un des appels suivants. Conservez le client, le contexte, les vérifications d’erreur et la sortie JSON, puis relancez go run . Chaque exécution soumet une nouvelle requête.
Nécessite la permission google_news. Renvoie les résultats d’actualités correspondant à votre recherche.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})Nécessite la permission youtube_metadata. Renvoie notamment le titre, la chaîne et la durée de la vidéo, sans la télécharger.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})Nécessite la permission youtube_transcript. Demande une transcription anglaise existante, y compris parmi les pistes automatiques. Renvoie le texte et les horodatages si cette piste est disponible.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})Fonctionnalités du SDK Go
Google- Search, News, Images, Shopping, Videos et Places. Utilisez Google.Pages pour les résultats paginés.
YouTube- Search, Metadata, Transcript, Captions, Channel et Suggestions fournissent des données vidéo structurées.
YouTube.Download- Soumettez une tâche de livraison audio ou vidéo dans votre stockage cloud. La permission youtube_download et une configuration de stockage sont nécessaires ; utilisez l’exemple complet ci-dessous.
Jobs / Bulk- Soumettez la requête avec une méthode Async, enregistrez l’identifiant de tâche, puis utilisez Jobs.Wait et Jobs.Result. Bulk gère les jeux de données plus volumineux et les tâches pouvant être reprises.
Account- Consultez l’identité, le solde, les tarifs, les limites et la consommation avant une exécution sans intervention. Réutilisez le même client et la clé autorisée.
WithFormat- Demandez du JSON, du texte brut ou du Markdown avec les options de format explicites. Markdown met les données récupérées en forme pour votre agent ; votre application fournit les appels au modèle et les résumés.
Types Go
GoogleSearchInput décrit la requête. Les paramètres facultatifs utilisent des pointeurs, par exemple flashdata.Ptr(int64(5)). Results contient le JSON de la source ; utilisez DecodeResults[GoogleSearchPayload] pour obtenir des champs typés.
Étapes suivantes
Si une étape échoue
- Paquet ou environnement d’exécution manquant
- Vérifiez go version et exécutez go get dans le dossier contenant go.mod.
- 401 / FLASHDATA_API_KEY
- Définissez une clé valide dans le terminal qui exécute l’exemple.
- 403
- Autorisez Google Search pour cette clé API.
- 402
- Consultez les crédits disponibles dans la facturation ou rattachez à votre compte un essai d’agent épuisé.
- 429
- Respectez le délai Retry-After, puis réduisez la fréquence de vos requêtes.
- Délai dépassé ou erreur serveur
- Consultez l’historique avant de renvoyer la requête ; la première peut avoir déjà été exécutée.