# Go SDK khởi chạy nhanh

Cài đặt Go SDK rồi chạy một kiểu Google Search yêu cầu. Vậy hãy thử dữ liệu YouTube với cùng một khách hàng.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/flashdata-go
Xem lại: 2026-11-04 by FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Nguồn và tham khảo SDK
- [Lấy khóa API](https://flashdata.dev/app/api-keys) — Tạo một phím trong bàn điều khiển

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

## Tạo yêu cầu Go đầu tiên

Cài SDK, thiết lập khóa API và chạy ví dụ bên dưới.

- [Tham chiếu phương thức Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### Cài đặt SDK

Yêu cầu Go 1.25+. Chọn một dự án mới hoặc cài đặt trong thư mục chứa thiết bị đã có go.mod.

#### Dự án mới

##### Cài đặt

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


#### Mô- đun tồn tại

##### Cài đặt

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


- [Cài đặt Go](https://go.dev/doc/install)
- [SDK thả](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

### Xác thực

Đăng ký, kiểm tra email của bạn và tạo ra một API phím với Google Search cho phép, hoặc sử dụng lại một phím được ủy quyền.

Đặt FLASHDATA_API_KEY Bên dưới, hoặc giữ giá trị đã được môi trường cung cấp. Ví dụ đọc rõ ràng; các tập tin .env chưa được nạp.

#### Bash

##### Phím ẩn nhắc điều · 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

##### Phím ẩn nhắc điều · 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
```


- [Đăng ký](https://flashdata.dev/signup)
- [Tạo ra một API Khóa](https://flashdata.dev/app/api-keys)
- [Kiểm tra tín dụng](https://flashdata.dev/app/billing)
- [Xác thực tác nhân](https://flashdata.dev/auth.md)

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

### Chạy tìm kiếm

Lưu cái này vào main.go bên cạnh go.modSau đó chạy nó trong cùng một thiết bị cuối. Nó gửi một tìm kiếm lên đến năm kết quả và in các JSON Trả lời đi.

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

#### Chạy

```bash
go run .
```


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

### Kiểm tra kết quả

Tìm status: done in ra JSON. Dùng tên cũ, URLs và chia sẻ trong đơn hoặc tác nhân của bạn. Một danh sách hữu cơ rỗng cũng là một kết quả hợp lệ.

| Tìm kiếm | Nghĩa là |
| --- | --- |
| status | đã hoàn thành việc tìm kiếm. |
| results[].organic[] | Kết quả tìm kiếm với tiêu đề, liên kết và trường phân mảnh. |
| usage.credits | Các tín dụng được sử dụng bởi yêu cầu này. 5 kết quả là 1 tìm kiếm, không phải 5 yêu cầu. |

#### Đầu ra Ví dụ

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

## Thử một nguồn dữ liệu khác

Vào main.go, thay thế chỉ kết quả, sai: = client.Google.Search(...) Gọi với một trong những cuộc gọi này. Giữ khách, ngữ cảnh, kiểm tra lỗi và JSON kết xuất, rồi chạy lại chạy. Mỗi người chạy một yêu cầu mới.

### Tin tức Google

Yêu cầu sự cho phép của google_news. Kết quả báo cáo kết quả cho yêu cầu của anh.

#### Thay thế cuộc gọi tìm kiếm trong main.go

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


### YouTube Siêu dữ liệu

Yêu cầu sự cho phép của youtube_metadata. Trả lại những chi tiết như tiêu đề, kênh và khoảng thời gian; nó không tải video về.

#### Thay thế cuộc gọi tìm kiếm trong main.go

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


### Bản ghi YouTube

Yêu cầu sự cho phép của youtube_transcript. Yêu cầu bản sao tiếng Anh đã có, bao gồm cả dấu vết tự động. Trở lại nhãn thời gian khi có thể.

#### Thay thế cuộc gọi tìm kiếm trong main.go

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


- [Mọi tham số nguồn](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## Cái quái gì... Go SDK Hỗ trợ

| Dùng | SDK điểm nhập |
| --- | --- |
| Google | Tìm kiếm, tin tức, hình ảnh, mua sắm, videos và Places. Dùng Google.Pages cho những kết quả đã qua. |
| YouTube | Tìm kiếm, siêu dữ liệu, Transcript, Điều khiển, Kênh và gợi ý cung cấp dữ liệu video có cấu trúc. |
| YouTube.Download | Gửi một công việc chuyển phát âm thanh hay video đến kho lưu trữ đám mây của bạn. Yêu cầu youtube_download Cho phép và cấu hình lưu trữ; hãy dùng ví dụ đầy đủ bên dưới. |
| Jobs / Bulk | Phục tùng với một Async Trợ giúp, lưu công việc IDsau đó sử dụng Jobs.Wait và Jobs.Result. Bulk xử lý bộ dữ liệu lớn hơn và việc làm có thể tái sử dụng. |
| Account | Đọc danh tính, số dư, giá trị, giới hạn và sử dụng trước khi làm việc vô trách nhiệm. Hãy tái sử dụng cùng một khách hàng và chìa khóa được ủy quyền. |
| WithFormat | Yêu cầu JSONVăn bản thường hoặc Markdown với các tùy chọn định dạng rõ ràng. Markdown Định dạng thu thập dữ liệu cho tác nhân của bạn; mô hình ứng dụng cung cấp cuộc gọi hoặc tóm tắt. |

- [Hoàn tất Go tải về ví dụ](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Cấu hình kho lưu tải về](https://flashdata.dev/vi/docs/guides/youtube-download-guide/reference.md)
- [Go Định dạng trả lời](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Kiểu Go

Google Search Input mô tả truy vấn. Tham số tùy chọn dùng con trỏ, chẳng hạn flashdata.Ptr(int64(Trong năm64)5)). Kết quả chứa mã nguồn JSON; sử dụng DecodeResults [Google find Traveload] khi bạn cần gõ trường.

- [Lưu và giải mã kết quả](https://flashdata.dev/vi/docs/guides/sdk-operations/reference.md#save)

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

## Bước kế

- [Kiểm tra tài khoản và lưu kết quả](https://flashdata.dev/vi/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/vi/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/vi/docs/guides/youtube-download-guide/reference.md)
- [SDK tham chiếu phương thức](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Nếu một bước không thành công

| Vấn đề | Sửa |
| --- | --- |
| Gói hoặc chạy thời gian thiếu | Kiểm tra phiên bản và chạy đi vào thư mục chứa go.mod. |
| 401 / FLASHDATA_API_KEY | Đặt một phím hợp lệ trong thiết bị cuối nơi bạn chạy ví dụ. |
| 403 | Bật Google Search Vì cái này API Chìa khóa. |
| 402 | Kiểm tra Billing hoặc tuyên bố một vụ thử nghiệm tác nhân kiệt sức. |
| 429 | Chờ Retry-After, sau đó giảm tốc độ yêu cầu. |
| Lỗi quá giờ hoặc máy chủ | Kiểm tra History trước khi phục hồi, có lẽ yêu cầu đầu tiên đã chạy rồi. |

- [Yêu cầu lịch sử](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
