# Go SDK awalan cepat

Pasang Go SDK dan menjalankan diketik Google Search permintaan. Kemudian coba YouTube data dengan klien yang sama.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/flashdata-go
Diulang: 2026-11-04 oleh FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Referensi Sumber dan SDK
- [Dapatkan API key](https://flashdata.dev/app/api-keys) — Membuat kunci pada konsol

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

## Buat permintaan Go pertamamu

Pasang kunci SDK, atur kunci API anda dan jalankan contoh di bawah ini.

- [Referensi metode Go SDK](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### Pasang SDK

Membutuhkan Go 1.25 +. Pilih projek baru atau install di direktori yang memuat go.mod yang telah ada.

#### Proyek baru

##### Instal

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


#### Modul yang telah ada

##### Instal

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


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

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

### Otentikasi

Mendaftar, memverifikasi email Anda dan membuat kunci API dengan izin Google Search, atau gunakan kembali kunci yang berwenang.

Atur FLASHDATA_API_KEY di bawah ini, atau simpan nilai yang sudah disediakan oleh lingkungan Anda. Contoh membacanya secara eksplisit; berkas .env tidak dimuat.

#### Bash

##### Prompt kunci tersembunyi 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

##### Prompt kunci tersembunyi 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
```


- [Daftar](https://flashdata.dev/signup)
- [Buat kunci API](https://flashdata.dev/app/api-keys)
- [Periksa kredit](https://flashdata.dev/app/billing)
- [Otentikasi agen](https://flashdata.dev/auth.md)

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

### Jalankan pencarian

Simpan ini sebagai main.go di samping go.mod, kemudian jalankan di terminal yang sama. Mengirimkan satu pencarian sampai lima hasil dan mencetak respon 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)
    }
}
```

#### Jalankan

```bash
go run .
```


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

### Periksa hasil

Cari status: done dalam cetak JSON. Gunakan judul yang dikembalikan, URLs dan snippet pada aplikasi atau agen Anda. Daftar organik kosong juga merupakan hasil yang valid.

| Ruas | Artinya |
| --- | --- |
| status | dilakukan berarti pencarian selesai. |
| results[].organic[] | Hasil pencarian dengan judul, ruas taut, dan snippet. |
| usage.credits | Kredit yang digunakan oleh permintaan ini. Lima hasil adalah satu pencarian, bukan lima permintaan. |

#### Contoh keluaran

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

## Coba sumber data lain

Dalam main.go, ganti hanya hasilnya, err: = client.Google.Search (...) panggil dengan salah satu panggilan ini. Jaga klien, konteks, pemeriksaan kesalahan dan keluaran JSON, kemudian jalankan go run. lagi. Masing-masing berlari mengajukan satu permintaan baru.

### Berita Google

Butuh izin google_news. Mengembalikan hasil berita untuk permintaan Anda.

#### Ganti panggilan pencarian dalam main.go

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


### YouTube metadata

Butuh izin youtube_metadata. Mengembalikan rincian video seperti judul, saluran, dan durasi; itu tidak mengunduh video.

#### Ganti panggilan pencarian dalam main.go

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


### YouTube transkrip

Butuh izin youtube_transcript. Meminta transkrip bahasa Inggris yang sudah ada, termasuk trek otomatis. Mengembalikan teks dan penanda waktu ketika trek yang tersedia.

#### Ganti panggilan pencarian dalam main.go

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


- [Semua parameter sumber](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## Apa yang Go SDK dukungan

| Gunakan | SDK titik masukan |
| --- | --- |
| Google | Cari, Berita, Gambar, Belanja, Video dan Tempat. Gunakan Google.Pages untuk hasil paginasi. |
| YouTube | Cari, Metadata, Transkrip, Kapsi, Saluran dan Saran menyediakan data video terstruktur. |
| YouTube.Download | Kirim audio atau video pengiriman ke penyimpanan awan Anda. Butuh ijin youtube_download dan konfigurasi penyimpanan; gunakan contoh lengkap di bawah ini. |
| Jobs / Bulk | Kirim bantuan Async, simpan tugas ID, lalu gunakan Jobs.Wait dan Jobs.Result. Bulk menangani dataset yang lebih besar dan pekerjaan yang dapat diresume. |
| Account | Baca identitas, keseimbangan, harga, batas-batas dan penggunaan sebelum pekerjaan tanpa pengawasan. Gunakan kembali klien yang sama dan kunci yang berwenang. |
| WithFormat | Permintaan JSON, teks biasa atau Markdown dengan opsi format eksplisit. Format Markdown diambil data untuk agen Anda; aplikasi Anda menyediakan panggilan model atau rangkuman. |

- [Contoh unduh Go lengkap](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Konfigurasikan penyimpanan unduh](https://flashdata.dev/id/docs/guides/youtube-download-guide/reference.md)
- [Go format respon](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Tipe Go

GoogleeSearchInput menjelaskan permintaan tersebut. Parameter opsional menggunakan penunjuk, seperti flashdata.Ptr (int64 (5)). Hasil berisi sumber JSON; gunakan DecodeResults [GoogleSearchpayload] ketika Anda membutuhkan field diketik.

- [Simpan dan pecahkan kode hasil yang diketik](https://flashdata.dev/id/docs/guides/sdk-operations/reference.md#save)

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

## Langkah selanjutnya

- [Pemeriksaan akun dan hasil yang disimpan](https://flashdata.dev/id/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/id/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/id/docs/guides/youtube-download-guide/reference.md)
- [SDK referensi metode](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## Jika satu langkah gagal

| Masalah | Perbaiki |
| --- | --- |
| Paket atau waktu jalan hilang | Periksa versi pergi dan jalankan pergi mendapatkan dalam direktori berisi go.mod. |
| 401 / FLASHDATA_API_KEY | Atur kunci yang valid di terminal di mana Anda menjalankan contoh. |
| 403 | Aktifkan Google Search untuk kunci API ini. |
| 402 | Periksa Billing untuk kredit yang tersedia, atau klaim kelelahan agen pengadilan. |
| 429 | Tunggu Retry-After, kemudian kurangi tingkat permintaan Anda. |
| Tenggat waktu atau galat server | Periksa History sebelum mengirim ulang; permintaan pertama mungkin sudah dijalankan. |

- [Meminta riwayat](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
