# Mula pantas

Jalankan carian Google pertama anda dan dapatkan hasil berstruktur untuk aplikasi atau ejen AI anda.

Referensi boonical: https://flashdata.dev/ms/docs/guides/quickstart
Diulas: 2026-11-04 oleh FlashData

<a id="agent"></a>

## Mulakan dengan ejen AI anda

Berikan prom ini kepada ejen yang mempunyai akses terminal. Ejen akan menyediakan FlashData dan menjalankan satu carian.

### Prom persediaan dan tugas pertama

```text
Baca https://flashdata.dev/auth.md dan ikuti arahan persediaan FlashData untuk persekitaran ini. Gunakan semula akses sedia ada; jika tiada, mulakan satu percubaan sahaja jika layak. Cari "battery recycling research" di Google dengan maksimum lima hasil. Kembalikan tajuk sumber, URL dan kredit yang benar-benar digunakan. Simpan bukti kelayakan dalam storan yang dilindungi, bukan dalam sembang. Jika akses disekat, nyatakan langkah seterusnya dan jangan buat percubaan baharu.
```

- [Persediaan MCP](https://flashdata.dev/ms/docs/integrations/mcp-clients/reference.md)
- [Kemahiran ejen](https://flashdata.dev/ms/docs/guides/agent-skill/reference.md)

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

## Buat panggilan API pertama anda

Mahu menulis kod sendiri? Ikuti tiga langkah ini dalam terminal.


<a id="api-key"></a>

### Dapatkan kunci API

Cipta akaun, sahkan e-mel anda dan cipta kunci dengan kebenaran Google Search. Gunakan semula kunci sedia ada jika anda sudah memilikinya.

Jalankan dalam terminal dan tampal kunci apabila diminta; input akan disembunyikan. Langkau jika FLASHDATA_API_KEY sudah ditetapkan.

#### Bash

##### Tetapkan kunci anda

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

##### Tetapkan kunci anda

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


- [Cipta akaun](https://flashdata.dev/signup)
- [Buka API Keys](https://flashdata.dev/app/api-keys)

<a id="request"></a>

### Jalankan carian

Pilih bahasa pengaturcaraan dan jalankan contoh dalam terminal yang sama. Setiap pelaksanaan menghantar satu carian.

#### Python

Python 3.10+ · Simpan contoh sebagai quickstart.py.

##### Pasang

```bash
python -m pip install "flashdata==1.1.0"
```

##### quickstart.py

```python
import json
import os
from flashdata import FlashData

with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
    response = client.google.search("battery recycling research", num=5)
    if response["status"] != "done":
        raise RuntimeError(response)
    print(json.dumps(response, indent=2))
```

##### Jalankan

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · Mulakan dalam folder kosong dan simpan quickstart.mts.

##### Sediakan

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mts

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Jalankan

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · Mulakan dalam folder kosong dan simpan quickstart.mjs.

##### Sediakan

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```

##### quickstart.mjs

```javascript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.search({
  query: 'battery recycling research', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(JSON.stringify(response, null, 2));
```

##### Jalankan

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · Mulakan dalam folder kosong dan simpan main.go. Langkau go mod init dalam modul sedia ada.

##### Sediakan

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

##### 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)
    }
}
```

##### Jalankan

```bash
go run .
```


#### HTTP API

SDK tidak diperlukan. Jalankan arahan Bash / cURL 7.76+ atau arahan PowerShell 7.

##### Bash / cURL

```bash
curl --fail-with-body --silent --show-error \
  --request POST https://data.flashdata.dev/v1/queries/realtime \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
```

##### PowerShell 7

```powershell
$flashdataRequest = '{"source":"google_search","query":"battery recycling research","params":{"num":5}}'
$flashdataResult = Invoke-RestMethod -Method Post -Uri 'https://data.flashdata.dev/v1/queries/realtime' -Headers @{ 'X-API-Key' = $env:FLASHDATA_API_KEY } -ContentType 'application/json' -Body $flashdataRequest
$flashdataResult | ConvertTo-Json -Depth 20
```


- [Semak hasil di bawah](https://flashdata.dev/ms/docs/guides/quickstart/reference.md#result)

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

### Semak hasil

Respons yang berjaya mempunyai status: done. Sumber berada dalam results[].organic dan kredit yang digunakan dalam usage.credits.

#### Contoh respons (diringkaskan)

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

- [Perbaik carian anda](https://flashdata.dev/ms/docs/guides/google-search-guide/reference.md)
- [Cuba YouTube Data](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md)
- [Persediaan API dan penyelesaian masalah](https://flashdata.dev/ms/docs/guides/http-quickstart/reference.md)

<a id="console"></a>

## Cuba konsol

1. Cipta akaun atau log masuk. Lengkapkan pengesahan e-mel dan sebarang persediaan akaun yang dipaparkan dalam konsol.
2. Buka Google Search, pilih sumber Google Search dan mod Realtime, kemudian masukkan battery recycling research. Kembangkan Additional parameters dan tetapkan Page size (num) kepada 5.
3. Semak permintaan yang dipaparkan dan kredit yang tersedia, kemudian jalankan carian sekali.
4. Semak respons dan penggunaan. Buka sumber yang dikembalikan untuk menyemak kandungannya sebelum memetik maklumat di luar petikannya.

- [Cipta akaun](https://flashdata.dev/signup)
- [Buka Google Search](https://flashdata.dev/app/google-search)

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

## Teruskan daripada hasil pertama anda

- [Cari dengan penapis](https://flashdata.dev/ms/docs/guides/google-search-guide/reference.md)
- [Teroka data YouTube](https://flashdata.dev/ms/docs/guides/youtube-data-guide/reference.md)
- [Tambah carian pada aplikasi](https://flashdata.dev/ms/docs/guides/search-in-an-app/reference.md)

<a id="troubleshooting"></a>

## Jika permintaan pertama gagal

| Apa yang dipaparkan | Tindakan |
| --- | --- |
| FLASHDATA_API_KEY tiada | Tetapkan kunci dalam terminal atau runtime yang sama dengan contoh. Petikan kod ini tidak memuatkan fail .env. |
| 401 / 403 | Pastikan kunci atau sambungan aktif dan mempunyai kebenaran google_search. |
| 402 | Semak kredit yang tersedia dalam Billing. Pautkan percubaan sedia ada kepada akaun jika anda memerlukan akses pemilik. |
| 429 | Ikuti Retry-After. Kekalkan identiti dan bukti pendaftaran yang sama; jangan cipta percubaan lain. |
| Tamat masa atau status penyerahan tidak diketahui | Semak pelaksanaan sedia ada sebelum mencuba lagi. Pengguna CLI perlu mengekalkan profil dan ID pelaksanaan yang sama; pengguna SDK/API perlu menyimpan ID tugas atau permintaan yang diterima. |

