İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Başlarken

Go SDK hızlı başlangıç

Go SDK'u yükleyin ve bir tür Google Search isteği çalıştırın. Sonra YouTube verileri aynı müşteri ile deneyin.

  1. Yüklemek için SDK

    Go 1.25+'yı gerektirir. Mevcut go.mod içeren dizininde yeni bir proje veya yükleme seçin.

    Yükle
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. Kimlik Doğrulama

    Kayıt olun, e-postanızı doğrulayın ve API anahtarını Google Search izni ile doğrulayın veya yetkili bir anahtarı yeniden kullanın.

    FLASHDATA_API_KEY aşağıda ayarlayın veya ortamınız tarafından zaten verilen değeri tut. Örnek açıkça okur; .env dosyaları yüklenemez.

    Gizli anahtar · 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. Arama çalıştırın

    Bunu main.go'un yanında go.mod olarak kaydedin, sonra aynı terminalde çalıştırın. Beş sonuç için bir arama gönderir ve JSON yanıtını yazdırır.

    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)
        }
    }
    Çalıştır
    go run .
  4. Sonucu kontrol edin

    status: done'ye basılı JSON'ye bakın. Geri kalan başlıkları kullanın, URLs ve parçaları uygulamanızda veya acentenizde kullanın. Boş organik bir liste de geçerli bir sonuçtur.

    Örnek çıktı
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    Yapılan arama tamamlandı anlamına gelir.
    results[].organic[]
    Başlık, bağlantı ve parçaları ile sonuçlar arayın.
    usage.credits
    Bu istek tarafından kullanılan krediler. Beş sonuç bir arama, beş talep değil.

Başka bir veri kaynağı deneyin

main.go'da, sadece sonucu yerine, err:= client.Google.Search(...) bu çağrılardan biriyle çağrı. Müşteriyi, bağlamı, hata kontrollerini ve JSON çıktısını tut, sonra tekrar koşmaya devam edin. Her işletme yeni bir istek gönderir.

google_news izni gerektirir. Sorunuz için haber sonuçları döndürür.

Arama çağrısı main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Go SDK ne destekliyor

Google
Arama, Haberler, Görüntüler, Alışveriş, Videolar ve Yerler. Google.Pages'u paginated sonuçlar için kullanın.
YouTube
Arama, Metadata, Transcript, Captions, Channel ve Öneriler yapılandırılmış video verileri sağlar.
YouTube.Download
Bulut depolamanıza bir ses veya video teslimat işi gönderin. youtube_download izin ve depolama yapılandırması gerektirir; aşağıdaki tam örneği kullanın.
Jobs / Bulk
Bir Async yardımcısı ile gönderin, işi ID'dan kurtarın, sonra Jobs.Wait ve Jobs.Result'u kullanın. Bulk daha büyük veri kümelerini ve yeniden kullanılabilir işleri ele alır.
Account
Kimlik, denge, fiyatlandırma, limitler ve kullanım istenmeyen çalışmadan önce. Aynı müşteriyi yeniden kullanın ve yetkili anahtar.
WithFormat
JSON, düz metin veya Markdown'yu açık format seçenekleri ile talep edin. Markdown formatları ajanınız için veri alır; uygulama malzemeleri model aramalarınız veya özetleriniz.

Go türleri

Google SearchInput sorguyu açıklar. Seçmeli parametreler flashdata.Ptr (int64 (5) gibi işaretleyicileri kullanır. Sonuçlar kaynak JSON içerir; DecodeResults[Google AramaPayload] tipi alanlara ihtiyacınız olduğunda.

Sonraki adımlar

Bir adım başarısız olursa

Paket veya runtime eksik
Check go version and run go get in the directory that go.mod.
401 / FLASHDATA_API_KEY
Örnek çalıştırdığınız terminalde geçerli bir anahtar ayarlayın.
403
Enable Google Search Bunun için API anahtar.
402
Kullanılabilir krediler için Billing bölümünü kontrol edin veya tükenmiş ajan denemesini hesaba bağlayın.
429
Retry-After için bekleyin, sonra istek oranını azaltır.
Zamanout veya sunucu hatası
History'u tekrarlamadan önce kontrol edin; ilk istek zaten çalıştırılabilir.