Langkau ke kandungan
MS
Dapatkan kunci API
Semak dokumentasi

Mula di sini

Mula pantas Go SDK

Instal Go SDK dan jalankan permintaan Google Search yang diketik. Kemudian, coba data YouTube dengan klien yang sama.

  1. Pasang SDK

    Kemudi membutuhkan Go 1.25+. Pilih proyek baru atau install di direktori yang berisi go.mod yang telah ada.

    Pasang
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. Autentifikasi

    Daftarkan, periksa email Anda dan buat kunci API dengan izin Google Search, atau gunakan kembali kunci yang berwenang.

    Tetapkan FLASHDATA_API_KEY di bawah ini, atau jaga nilai yang sudah diberikan oleh lingkungan Anda. Contoh yang 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 carian

    Simpan ini sebagai main.go di samping go.mod, kemudian jalankan di terminal yang sama. Ini mengirim 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. Semak hasil

    Cari status: done dalam cetakan JSON. Anda menggunakan gelar yang dikembalikan, URLs dan snippet dalam aplikasi atau agen Anda. Daftar organik kosong juga merupakan hasil yang valid.

    Contoh output
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    Selesai berarti pencarian selesai.
    results[].organic[]
    Hasil pencarian histories dengan title, link dan snippet fields.
    usage.credits
    Kredit kredit yang digunakan oleh permintaan ini. Hasil kelima adalah satu pencarian, bukan lima permintaan.

Coba sumber data lain

Di main.go, hanya mengganti hasil, kesalahan := client.Google.Search(...) panggilan dengan salah satu panggilan ini. Tetap menjaga klien, konteks, pemeriksaan kesalahan dan output JSON, kemudian jalankan lari . lagi. Setiap larian mengajukan satu permintaan baru.

Perlu izin google_news. Ajukan kembali hasil berita untuk pertanyaan Anda.

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

Apa yang didukung Go SDK

Google
\"Zoby Search, News, Images, Shopping, Video dan Tempat\". Use Google.Pages untuk hasil yang dipinta.
YouTube
Aerophine, Metadata, Transcript, Captions, Channel dan Saran menyediakan data video terstruktur.
YouTube.Download
Kirimkan pekerjaan pengiriman audio atau video ke penyimpanan awan Anda. Kemudia memerlukan izin dan konfigurasi penyimpanan youtube_download; gunakan contoh lengkap di bawah ini.
Jobs / Bulk
Serah dengan pembantu Async, simpan pekerjaan ID, kemudian gunakan Jobs.Wait dan Jobs.Result. Bulk menangani set data yang lebih besar dan pekerjaan yang dapat disambung.
Account
Bacalah identitas, keseimbangan, harga, batas dan penggunaan sebelum pekerjaan yang tidak diinginkan. Anda menggunakan kembali klien yang sama dan kunci yang sah.
WithFormat
Permintaan JSON, teks biasa atau Markdown dengan pilihan format eksplisit. Markdown Format nutfah diambil data untuk agen Anda; aplikasi Anda memasok panggilan model atau jumlah.

Jenis Go

googleSearchInput menjelaskan pertanyaannya. Parameter pilihan yang menggunakan penunjuk, seperti flashdata.Ptr(int64(5)). Hasil Hasil TOW berisi sumber JSON; gunakan DecodeResults[GoogleSearchPayload] ketika Anda membutuhkan medan yang diketik.

Langkah - langkah selanjutnya

Jika langkah gagal

Paket atau runtime hilang
Periksa versi go dan jalankan pergi masuk ke dalam direktori yang berisi go.mod.
401 / FLASHDATA_API_KEY
Tetapkan kunci valid di terminal di mana Anda menjalankan contoh.
403
Hidupkan Google Search untuk kunci API ini.
402
Cek Billing untuk kredit yang tersedia, atau klaim pengadilan agen yang kelelahan.
429
Wait untuk Retry-After, kemudian mengurangi permintaan Anda.
Kehabisan atau server error
Periksa History sebelum resending; permintaan pertama mungkin sudah berjalan.