# เริ่มต้นอย่างรวดเร็ว

เรียกใช้การค้นหา Google ครั้งแรกและรับผลลัพธ์แบบมีโครงสร้างสำหรับแอปหรือเอเจนต์ AI ของคุณ

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/quickstart
Recorder: 2026-11-04 โดย FlashData

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

## เริ่มต้นด้วยเอเจนต์ AI

ส่งพรอมป์ต์นี้ให้เอเจนต์ที่ใช้เทอร์มินัลได้ เอเจนต์จะตั้งค่า FlashData และค้นหาหนึ่งครั้ง

### พรอมป์ต์สำหรับตั้งค่าและงานแรก

```text
อ่าน https://flashdata.dev/auth.md และทำตามคำแนะนำการตั้งค่า FlashData สำหรับสภาพแวดล้อมนี้ ใช้สิทธิ์เข้าถึงที่มีอยู่ซ้ำ หากยังไม่มี ให้เริ่มทดลองใช้เพียงครั้งเดียวเมื่อมีคุณสมบัติตรงตามเงื่อนไข ค้นหา "battery recycling research" บน Google โดยขอผลลัพธ์ไม่เกินห้ารายการ ส่งกลับชื่อแหล่งข้อมูล URL และเครดิตที่ใช้จริง เก็บข้อมูลรับรองในที่จัดเก็บที่ได้รับการป้องกัน ไม่ใส่ไว้ในแชต หากเข้าถึงไม่ได้ ให้แจ้งขั้นตอนถัดไปแทนการสร้างการทดลองใช้ใหม่
```

- [ตั้งค่า MCP](https://flashdata.dev/th/docs/integrations/mcp-clients/reference.md)
- [ทักษะเอเจนต์](https://flashdata.dev/th/docs/guides/agent-skill/reference.md)

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

## เรียก API ครั้งแรก

ต้องการเขียนโค้ดเองหรือไม่? ทำตามสามขั้นตอนนี้ในเทอร์มินัล


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

### รับคีย์ API

สร้างบัญชี ยืนยันอีเมล และสร้างคีย์ที่มีสิทธิ์ Google Search หากมีคีย์ที่เหมาะสมอยู่แล้วให้ใช้คีย์เดิม

รันในเทอร์มินัลแล้ววางคีย์เมื่อระบบขอ โดยข้อความที่ป้อนจะถูกซ่อน ข้ามขั้นตอนนี้หากตั้งค่า FLASHDATA_API_KEY แล้ว

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

##### ตั้งค่าคีย์

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


- [สร้างบัญชี](https://flashdata.dev/signup)
- [เปิด API Keys](https://flashdata.dev/app/api-keys)

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

### เรียกใช้การค้นหา

เลือกภาษาและรันตัวอย่างในเทอร์มินัลเดิม การรันแต่ละครั้งจะส่งการค้นหาหนึ่งครั้ง

#### Python

Python 3.10+ · บันทึกตัวอย่างเป็น quickstart.py

##### ติดตั้ง

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

##### เรียกใช้

```bash
python quickstart.py
```


#### TypeScript

Node.js 22.18+ · เริ่มในโฟลเดอร์ว่างและบันทึก quickstart.mts

##### ตั้งค่า

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

##### เรียกใช้

```bash
node quickstart.mts
```


#### JavaScript

Node.js 22+ · เริ่มในโฟลเดอร์ว่างและบันทึก quickstart.mjs

##### ตั้งค่า

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

##### เรียกใช้

```bash
node quickstart.mjs
```


#### Go

Go 1.25+ · เริ่มในโฟลเดอร์ว่างและบันทึก main.go ข้าม go mod init หากมีโมดูลอยู่แล้ว

##### ตั้งค่า

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

##### เรียกใช้

```bash
go run .
```


#### HTTP API

ไม่ต้องใช้ SDK เรียกใช้คำสั่ง Bash / cURL 7.76+ หรือคำสั่ง 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
```


- [ตรวจสอบผลลัพธ์ด้านล่าง](https://flashdata.dev/th/docs/guides/quickstart/reference.md#result)

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

### ตรวจสอบผลลัพธ์

คำตอบที่สำเร็จมี status: done แหล่งข้อมูลอยู่ใน results[].organic และเครดิตที่คิดค่าบริการอยู่ใน usage.credits

#### ตัวอย่างการตอบกลับ (ย่อ)

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

- [ปรับปรุงการค้นหา](https://flashdata.dev/th/docs/guides/google-search-guide/reference.md)
- [ลองใช้ YouTube Data](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md)
- [ตั้งค่า API และแก้ปัญหา](https://flashdata.dev/th/docs/guides/http-quickstart/reference.md)

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

## ลองใช้คอนโซล

1. สร้างบัญชีหรือเข้าสู่ระบบ ยืนยันอีเมลและทำตามขั้นตอนตั้งค่าบัญชีที่แสดงในคอนโซล
2. เปิด Google Search เลือกแหล่งข้อมูล Google Search และโหมด Realtime แล้วป้อน battery recycling research ขยาย Additional parameters และตั้งค่า Page size (num) เป็น 5
3. ตรวจสอบคำขอที่แสดงและเครดิตที่มี แล้วค้นหาหนึ่งครั้ง
4. ตรวจสอบคำตอบและการใช้งาน เปิดแหล่งข้อมูลที่ได้รับเพื่อตรวจสอบเนื้อหาก่อนอ้างอิงข้อมูลที่เกินกว่าข้อความตัวอย่าง

- [สร้างบัญชี](https://flashdata.dev/signup)
- [เปิด Google Search](https://flashdata.dev/app/google-search)

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

## ต่อยอดจากผลลัพธ์แรก

- [ค้นหาด้วยตัวกรอง](https://flashdata.dev/th/docs/guides/google-search-guide/reference.md)
- [สำรวจข้อมูล YouTube](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md)
- [เพิ่มการค้นหาในแอป](https://flashdata.dev/th/docs/guides/search-in-an-app/reference.md)

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

## หากคำขอแรกไม่สำเร็จ

| สิ่งที่พบ | วิธีแก้ไข |
| --- | --- |
| ไม่ได้ตั้งค่า FLASHDATA_API_KEY | ตั้งค่าคีย์ในเทอร์มินัลหรือรันไทม์เดียวกับตัวอย่าง ตัวอย่างเหล่านี้ไม่อ่านไฟล์ .env |
| 401 / 403 | ตรวจสอบว่าคีย์หรือการเชื่อมต่อยังใช้งานอยู่และมีสิทธิ์ google_search |
| 402 | ตรวจสอบเครดิตที่ใช้ได้ใน Billing หากต้องการสิทธิ์ของเจ้าของบัญชี ให้เชื่อมโยงการทดลองใช้เดิมกับบัญชี |
| 429 | ปฏิบัติตาม Retry-After ใช้ตัวตนและหลักฐานการลงทะเบียนเดิม อย่าสร้างการทดลองใช้อีกบัญชี |
| หมดเวลาหรือไม่ทราบสถานะการส่ง | ตรวจสอบการรันเดิมก่อนลองอีกครั้ง ผู้ใช้ CLI ต้องเก็บโปรไฟล์และ ID การรันเดิม ส่วนผู้ใช้ SDK/API ต้องบันทึก ID งานหรือคำขอที่ได้รับ |

