# 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.

Canonical referans: https://flashdata.dev/tr/docs/guides/flashdata-go
İnceleme: 2026-11-04 Tarafından FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — Kaynak ve SDK referans
- [API anahtarı alın](https://flashdata.dev/app/api-keys) — Konsolda bir anahtar oluşturun

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

## İlk Go isteğinizi yapın

SDK'u yükleyin, API anahtarını ayarlayın ve aşağıdaki örneği çalıştır.

- [Go SDK metot başvurusu](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### Yüklemek için SDK

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

#### Yeni Proje Yeni Proje

##### Yükle

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


#### Varing modülü

##### Yükle

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


- [Yükleme yükleme Go](https://go.dev/doc/install)
- [SDK sürüm](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

### 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.

#### Bash

##### Gizli anahtar · 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

##### Gizli anahtar · 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
```


- [Kaydol](https://flashdata.dev/signup)
- [Bir API anahtarı oluşturun](https://flashdata.dev/app/api-keys)
- [Check kredi](https://flashdata.dev/app/billing)
- [Agent kimlik doğrulama](https://flashdata.dev/auth.md)

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

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

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

```bash
go run .
```


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

### 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.

| Field | Anlam Anlamı |
| --- | --- |
| 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. |

#### Örnek çıktı

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

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

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

#### Arama çağrısı main.go

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


### YouTube metadata

youtube_metadata izni gerektirir. Başlık, kanal ve süresi gibi video ayrıntıları döndürür; videoyu indirmez.

#### Arama çağrısı main.go

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


### YouTube transcript

youtube_transcript izni gerektirir. Otomatik parçalar dahil olmak üzere mevcut bir İngilizce transkript talep eder. Bu takip mevcut olduğunda metin ve zaman notları döndürür.

#### Arama çağrısı main.go

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


- [Tüm kaynak parametreleri](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## Go SDK ne destekliyor

| Kullanım | SDK giriş noktaları |
| --- | --- |
| 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. |

- [Tamam Go indirme örneği](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [Configure download storage](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md)
- [Go yanıt formatları](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## 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.

- [Save and decode typed results](https://flashdata.dev/tr/docs/guides/sdk-operations/reference.md#save)

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

## Sonraki adımlar

- [Hesap kontrolleri kontrol eder ve sonuçları kurtarın](https://flashdata.dev/tr/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/tr/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/tr/docs/guides/youtube-download-guide/reference.md)
- [SDK yöntemi referans](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

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

| Problem Sorun Problem Problem Problem | Fix Fix |
| --- | --- |
| 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. |

- [Tarih İstek Tarihi](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
