Lewati ke isi
ID
Dapatkan kunci API
Jelajahi dokumentasi

Mulai

Go SDK awalan cepat

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

  1. Pasang SDK

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

    Instal
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. 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.

    Prompt kunci tersembunyi 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
  3. 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
    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
    go run .
  4. 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.

    Contoh keluaran
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    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.

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.

Butuh izin google_news. Mengembalikan hasil berita untuk permintaan Anda.

Ganti panggilan pencarian dalam main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Apa yang Go SDK dukungan

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.

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.

Langkah selanjutnya

Jika satu langkah gagal

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.