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

Référence canonique : https://flashdata.dev/fr/docs/guides/flashdata-go
Vérifié le 2026-11-04 par FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Code source et référence du SDK
- [Obtenir une clé API](https://flashdata.dev/app/api-keys) — Créer une clé dans la console

<a id="application"></a>

## Effectuez votre première requête en Go

Installez le SDK, définissez votre clé API et exécutez l’exemple ci-dessous.

- [Référence des méthodes du SDK Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="install"></a>

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

#### Nouveau projet

##### Installer

```bash
mkdir flashdata-demo
cd flashdata-demo
go mod init example.com/flashdata-demo
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


#### Module existant

##### Installer

```bash
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


- [Installer Go](https://go.dev/doc/install)
- [Version du SDK](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

<a id="authentication"></a>

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

#### Bash

##### Saisie masquée de la clé · Bash

```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 7

##### Saisie masquée de la clé · PowerShell

```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
```


- [S’inscrire](https://flashdata.dev/signup)
- [Créer une clé API](https://flashdata.dev/app/api-keys)
- [Consulter les crédits](https://flashdata.dev/app/billing)
- [Authentification des agents](https://flashdata.dev/auth.md)

<a id="query"></a>

### 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

```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

```bash
go run .
```


<a id="result"></a>

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

| Champ | Signification |
| --- | --- |
| 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. |

#### Exemple de sortie

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```


<a id="common-tasks"></a>

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

### Google News

Nécessite la permission google_news. Renvoie les résultats d’actualités correspondant à votre recherche.

#### Remplacer l’appel de recherche dans main.go

```go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})
```


### Métadonnées YouTube

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.

#### Remplacer l’appel de recherche dans main.go

```go
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
    VideoID: "dQw4w9WgXcQ",
})
```


### Transcription YouTube

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.

#### Remplacer l’appel de recherche dans main.go

```go
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
    VideoID: "dQw4w9WgXcQ",
    Params: &flashdata.YouTubeTranscriptParams{
        Language: flashdata.Ptr("en"),
        Auto: flashdata.Ptr(true),
    },
})
```


- [Tous les paramètres des sources](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

<a id="features"></a>

## Fonctionnalités du SDK Go

| Utilisation | Points d’entrée du SDK |
| --- | --- |
| 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. |

- [Exemple complet de téléchargement en Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Configurer le stockage des téléchargements](https://flashdata.dev/fr/docs/guides/youtube-download-guide/reference.md)
- [Formats de réponse en Go](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

<a id="types"></a>

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

- [Enregistrer et décoder des résultats typés](https://flashdata.dev/fr/docs/guides/sdk-operations/reference.md#save)

<a id="next"></a>

## Étapes suivantes

- [Vérifier le compte et enregistrer les résultats](https://flashdata.dev/fr/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/fr/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/fr/docs/guides/youtube-download-guide/reference.md)
- [Référence des méthodes du SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="recover"></a>

## Si une étape échoue

| Problème | Solution |
| --- | --- |
| 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. |

- [Historique des requêtes](https://flashdata.dev/app/jobs)
- [Facturation](https://flashdata.dev/app/billing)
