# เริ่มต้นใช้ Go SDK

ติดตั้ง Go SDK และประมวลผลแบบพิมพ์ Google Search ขอล่ะ งั้นลอง YouTube ข้อมูลที่มีลูกค้าคนเดียวกัน

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

- [GitHub](https://github.com/flashdatadev/flashdata-go) — ต้นฉบับและ SDK อ้างอิง
- [รับคีย์ API](https://flashdata.dev/app/api-keys) — สร้างกุญแจในคอนโซล

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

## ให้เป็นครั้งแรกของคุณ Go ร้องขอ

ติดตั้ง SDK. ตั้ง API กุญแจและดําเนินการตัวอย่างด้านล่าง

- [เอกสารอ้างอิงเมธอด Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### ติดตั้ง SDK

ต้องการ Go 1.25+. เลือกโครงการใหม่ หรือติดตั้งในไดเรกทอรีที่มี go.mod อยู่

#### โครงการใหม่

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

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


#### โมดูลที่มีอยู่

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

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


- [ติดตั้ง Go](https://go.dev/doc/install)
- [SDK ออก](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

### การตรวจสอบสิทธิ์

เซ็นกํากับแล้วตรวจสอบอีเมลของคุณและสร้าง API กุญแจพร้อม Google Search อนุญาตหรือใช้กุญแจที่ได้รับอนุญาตอีกครั้ง

ตั้งค่า FLASHDATA_API_KEY ข้าง ล่าง นี้ หรือ รักษา คุณค่า ที่ คุณ มี อยู่ แล้ว โดย สิ่ง แวด ล้อม ของ คุณ. ตัวอย่างการอ่านมันโดยตรง; แฟ้ม.env ยังไม่ได้โหลด

#### Bash

##### แจ้งเตือนปุ่มซ่อน as 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

##### แจ้งเตือนปุ่มซ่อน as 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
```


- [สมัครใช้งาน](https://flashdata.dev/signup)
- [สร้างรายการ API กุญแจ](https://flashdata.dev/app/api-keys)
- [เช็คเครดิต](https://flashdata.dev/app/billing)
- [การตรวจสอบสิทธิ์ของเจ้าหน้าที่](https://flashdata.dev/auth.md)

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

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

บันทึกนี้เป็น main.go ข้าง go.modแล้วเอาไปใช้ในอาคารเดียวกัน มันส่งหนึ่งการค้นหาถึงห้าผล และพิมพ์การตอบสนอง 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)
    }
}
```

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

```bash
go run .
```


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

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

ค้นหา status: done ในการพิมพ์ JSON. ใช้ชื่อเล่นที่คืนมา URLs และชิ้นส่วนในใบสมัครหรือตัวแทนของคุณ รายการออร์แกนิคว่างเปล่านี้ยังเป็นผลลัพธ์ที่ใช้ได้

| ช่องข้อมูล | หมายความว่า |
| --- | --- |
| status | เสร็จสิ้นแล้ว หมายถึงการค้นหาเสร็จสมบูรณ์ |
| 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
  }
}
```


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

## ลองแหล่งข้อมูลอื่น

ใน main.goต้องการจะแทนที่ผลลัพธ์เท่านั้น ให้ผิดพลาด:= client.Google.Search(...) โทรหาด้วยสายหนึ่ง เก็บไคลเอนต์, บริบท, การตรวจสอบข้อผิดพลาดและ JSON ส่งออกแล้วให้ประมวลผลอีกครั้ง แต่ละการทํางานส่งหนึ่งการร้องขอใหม่

### Google ข่าว

ต้องการ google_news อนุญาต ตอบกลับผลการค้นหาของคุณ

#### แทนที่การเรียกค้นหาใน main.go

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


### YouTube ข้อมูลกํากับภาพ

ต้องการ youtube_metadata อนุญาต คืนรายละเอียดวิดีโอ เช่น ชื่อเรื่อง, ช่อง และระยะเวลา; มันไม่ได้ดาวน์โหลดวิดีโอ

#### แทนที่การเรียกค้นหาใน main.go

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


### YouTube เอกสาร

ต้องการ youtube_transcript อนุญาต ต้องการสําเนาภาษาอังกฤษที่มีอยู่ รวมทั้งแทร็กเสียงอัตโนมัติ คืนค่าข้อความและเวลากําหนด เมื่อมีเพลงนี้อยู่

#### แทนที่การเรียกค้นหาใน main.go

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


- [พารามิเตอร์ต่าง ๆ ทั้งหมด](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## อะไรกันนี่ Go SDK สนับสนุน

| ใช้ | SDK ตําแหน่งของช่อง |
| --- | --- |
| Google | สืบค้น, ข่าว, ภาพ, ร้านค้า, วิดีโอ และสถานที่ต่างๆ ใช้ Google.Pages สําหรับผลการดัดแปลง |
| YouTube | สืบค้น, ข้อมูลกํากับภาพ, ทรานสคริปต์, คําบรรยาย, ช่องและคําแนะนําจัดทําข้อมูลวิดีโอแบบโครงสร้าง |
| YouTube.Download | ส่งงานส่งเสียงหรือวิดีโอไปยังที่เก็บเมฆของคุณ ต้องการ youtube_download อนุญาตให้ใช้และบันทึกค่าต่าง ๆ โดยใช้ตัวอย่างที่สมบูรณ์ด้านล่างนี้ |
| Jobs / Bulk | ส่งข้อมูลด้วย Async ผู้ช่วย, บันทึกงาน IDแล้วใช้ Jobs.Wait ถึง Jobs.Result. Bulk จัดการกับชุดข้อมูลขนาดใหญ่และงานที่ใช้งานได้อีกครั้ง |
| Account | อ่านอัตลักษณ์ ดุลยภาพ ค่านิยม ข้อจํากัด และการใช้งาน ก่อนงานไม่มีกําหนด ใช้ลูกความเดียวกันและกุญแจที่ได้รับอนุญาต |
| WithFormat | ต้องการ JSONข้อความธรรมดาหรือ Markdown ด้วยตัวเลือกการจัดรูปแบบ Markdown รูปแบบการรับข้อมูลจากตัวแทนของคุณ; การแจ้งรุ่นของโปรแกรมหรือผลรวม |

- [เสร็จสมบูรณ์ Go ตัวอย่างการดาวน์โหลด](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [ปรับแต่งคลังเก็บการดาวน์โหลด](https://flashdata.dev/th/docs/guides/youtube-download-guide/reference.md)
- [Go รูปแบบการตอบกลับ](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Go ชนิด

Google สืบค้น Input อธิบายคําค้น พารามิเตอร์ทางเลือก ใช้ตัวชี้ เช่น flashdata.Ptr(inT64)5)). ผลลัพธ์มีแหล่ง JSONสืบค้นเมื่อคุณต้องการช่องข้อมูลที่พิมพ์แล้ว

- [บันทึกและถอดรหัสผลลัพธ์ที่พิมพ์แล้ว](https://flashdata.dev/th/docs/guides/sdk-operations/reference.md#save)

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

## ถัดไป

- [การตรวจสอบบัญชีผู้ใช้และบันทึกผล](https://flashdata.dev/th/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/th/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/th/docs/guides/youtube-download-guide/reference.md)
- [SDK การอ้างอิงแบบใด](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## ถ้าขั้นตอนล้มเหลว

| ปัญหา | แก้ไข |
| --- | --- |
| แพกเกจหรือไม่พบเวลาทํางาน | Check Go version แล้วเรียกในไดเรกทอรีที่มี go.mod |
| 401 / FLASHDATA_API_KEY | ตั้งค่ากุญแจที่ถูกต้องในเทอร์มินัลที่คุณเรียกใช้งานตัวอย่าง |
| 403 | เปิด Google Search สําหรับสิ่งนี้ API กุญแจ |
| 402 | ตรวจสอบเครดิตที่ใช้ได้ใน Billing หรือผูกสิทธิ์ทดลองใช้ของเอเจนต์ที่หมดเครดิตแล้วกับบัญชี |
| 429 | รอ Retry-After แล้วลดอัตราการร้องขอของคุณ |
| หมดเวลาหรือเซิร์ฟเวอร์ผิดพลาด | ตรวจสอบ History ก่อนจะทําการแก้ไขการร้องขอแรกอาจจะทํางานอยู่แล้ว |

- [ต้องการประวัติ](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
