# Go SDK Quickstart

Go SDK स्थापित करें और एक टाइप Google Search अनुरोध चलायें। फिर उसी क्लाइंट के साथ YouTube डेटा को आज़माएं।

कैनोनिकल संदर्भ: https://flashdata.dev/hi/docs/guides/flashdata-go
समीक्षित: 2026-11-04 द्वारा FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — स्रोत और SDK संदर्भ
- [API कुंजी लें](https://flashdata.dev/app/api-keys) — कंसोल में एक कुंजी बनाएं

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

## अपना पहला Go अनुरोध बनाएं

SDK स्थापित करें, अपनी API कुंजी सेट करें और नीचे दिए गए उदाहरण को चलाएं।

- [Go SDK मेथड संदर्भ](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

### SDK स्थापित करें

Go 1.25+ की आवश्यकता है। अपनी मौजूदा go.mod युक्त निर्देशिका में एक नई परियोजना चुनें या स्थापित करें।

#### नई परियोजना

##### इंस्टॉल करें

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


#### मौजूदा मॉड्यूल

##### इंस्टॉल करें

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


- [स्थापित करें Go](https://go.dev/doc/install)
- [SDK रिलीज़](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

### प्रमाणीकरण

साइन अप करें, अपने ईमेल को सत्यापित करें और Google Search अनुमति के साथ एक API कुंजी बनाएं, या एक अधिकृत कुंजी का पुन: उपयोग करें।

नीचे FLASHDATA_API_KEY सेट करें, या अपने पर्यावरण द्वारा पहले से ही आपूर्ति की गई मान को बनाए रखें। उदाहरण यह स्पष्ट रूप से पढ़ता है; .env फ़ाइलों को लोड नहीं किया जाता है।

#### Bash

##### छिपे हुए कुंजी संकेत 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

##### छिपे हुए कुंजी संकेत 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
```


- [खाता बनाएँ](https://flashdata.dev/signup)
- [एक API कुंजी बनाएँ](https://flashdata.dev/app/api-keys)
- [क्रेडिट जाँच करें](https://flashdata.dev/app/billing)
- [एजेंट प्रमाणीकरण](https://flashdata.dev/auth.md)

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

### खोज चलाएँ

इसे सहेजें main.go बगल में go.modफिर इसे उसी टर्मिनल में चलाएं। यह एक खोज को पांच परिणाम तक भेजता है और 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)
    }
}
```

#### चलाएँ

```bash
go run .
```


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

### परिणाम जाँचें

मुद्रित JSON में status: done के लिए देखो। अपने आवेदन या एजेंट में वापसी शीर्षक, URLs और स्निपेट्स का उपयोग करें। एक खाली कार्बनिक सूची भी एक वैध परिणाम है।

| फील्ड | अर्थ |
| --- | --- |
| status | किया गया मतलब है खोज पूरा हो गया। |
| results[].organic[] | शीर्षक, लिंक और स्निपेट फ़ील्ड के साथ परिणाम खोजें। |
| usage.credits | इस अनुरोध के अनुसार क्रेडिट्स का उपयोग किया जाता है। पांच परिणाम एक खोज हैं, पांच अनुरोध नहीं है। |

#### उदाहरण

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

## एक और डेटा स्रोत आज़माएं

main.go में, केवल परिणाम की जगह, err:= client.Google.Search(...) इन कॉलों में से एक के साथ कॉल करें। ग्राहक, संदर्भ, त्रुटि जांच और JSON आउटपुट को रखें, फिर फिर से चलाएं। प्रत्येक रन एक नया अनुरोध प्रस्तुत करता है।

### Google समाचार

google_news अनुमति की आवश्यकता है। अपने प्रश्नों के लिए समाचार परिणाम वापस लौटें।

#### main.go में खोज कॉल बदलें

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


### YouTube मेटाडाटा

youtube_metadata अनुमति की आवश्यकता है। वीडियो विवरण जैसे कि शीर्षक, चैनल और अवधि; यह वीडियो डाउनलोड नहीं करता है।

#### main.go में खोज कॉल बदलें

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


### YouTube ट्रांसक्रिप्ट

youtube_transcript अनुमति की आवश्यकता है। एक मौजूदा अंग्रेजी ट्रांसक्रिप्ट का अनुरोध करता है, जिसमें स्वचालित ट्रैक शामिल हैं। उस ट्रैक उपलब्ध होने पर टेक्स्ट और टाइमस्टैम्प लौटाएं।

#### main.go में खोज कॉल बदलें

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


- [सभी स्रोत पैरामीटर](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

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

## क्या Go SDK समर्थन करता है

| उपयोग | SDK प्रविष्टि बिंदु |
| --- | --- |
| Google | खोज, समाचार, छवियाँ, खरीदारी, वीडियो और स्थान। Pginated परिणामों के लिए Google.Pages का उपयोग करें। |
| YouTube | खोज, मेटाडाटा, ट्रांसक्रिप्ट, कैप्शन, चैनल और सुझाव संरचित वीडियो डेटा प्रदान करते हैं। |
| YouTube.Download | अपने क्लाउड स्टोरेज के लिए ऑडियो या वीडियो डिलीवरी का काम सबमिट करें। youtube_download अनुमति और भंडारण विन्यास की आवश्यकता है; नीचे पूर्ण उदाहरण का उपयोग करें। |
| Jobs / Bulk | एक Async हेल्पर के साथ जमा करें, नौकरी ID को बचाएं, फिर Jobs.Wait और Jobs.Result का उपयोग करें। Bulk बड़े डेटासेट और पुन: प्रयोज्य नौकरियों को संभालता है। |
| Account | Unattended काम से पहले पहचान, संतुलन, मूल्य निर्धारण, सीमा और उपयोग पढ़ें। उसी ग्राहक और अधिकृत कुंजी का पुन: उपयोग करें। |
| WithFormat | JSON, सादे पाठ या Markdown को स्पष्ट प्रारूप विकल्पों के साथ अनुरोध करें। Markdown प्रारूपों ने आपके एजेंट के लिए डेटा पुनर्प्राप्त किया; आपका अनुप्रयोग मॉडल कॉल या सारांश की आपूर्ति करता है। |

- [पूर्ण Go डाउनलोड उदाहरण](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [डाउनलोड संग्रहण को कॉन्फ़िगर करें](https://flashdata.dev/hi/docs/guides/youtube-download-guide/reference.md)
- [Go प्रतिक्रिया प्रारूप](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

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

## Go प्रकार

Google SearchInput क्वेरी का वर्णन करता है। वैकल्पिक पैरामीटर ऐसे flashdata.Ptr(int64(5) के रूप में पॉइंटर्स का उपयोग करते हैं। परिणाम में स्रोत JSON शामिल हैं; जब आपको टाइप फ़ील्ड की आवश्यकता होती है तो DecodeResults[GoogleSearchPayload] का उपयोग करें।

- [सेव करें और डिकोड करें टाइप किए गए परिणाम](https://flashdata.dev/hi/docs/guides/sdk-operations/reference.md#save)

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

## अगला कदम

- [लेखा जांच और सहेजे गए परिणाम](https://flashdata.dev/hi/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/hi/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/hi/docs/guides/youtube-download-guide/reference.md)
- [SDK विधि संदर्भ](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

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

## यदि कोई कदम विफल हो जाता है

| समस्या | फिक्स |
| --- | --- |
| पैकेज या रनटाइम लापता | चेक गो संस्करण और रन go.mod युक्त निर्देशिका में जाओ। |
| 401 / FLASHDATA_API_KEY | टर्मिनल में एक वैध कुंजी सेट करें जहां आप उदाहरण चलाते हैं। |
| 403 | इस API कुंजी के लिए Google Search सक्षम करें। |
| 402 | उपलब्ध क्रेडिट के लिए Billing की जाँच करें, या एक थका हुआ एजेंट परीक्षण का दावा करें। |
| 429 | Retry-After के लिए प्रतीक्षा करें, फिर अपनी अनुरोध दर को कम करें। |
| टाइमआउट या सर्वर त्रुटि | Resending से पहले History की जाँच करें; पहला अनुरोध पहले से ही चल सकता है। |

- [अनुरोध इतिहास](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
