Aller au contenu
FR
Obtenir une clé API
Parcourir la documentation

Premiers pas

Démarrage avec le SDK Go

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.

  1. 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.

    Installer
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. 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_KEY
  3. Lancez 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.go
    package 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écuter
    go run .
  4. 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.

Remplacer l’appel de recherche dans main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

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.