सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

शुरू करें

Go SDK Quickstart

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

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

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

    इंस्टॉल करें
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. प्रमाणीकरण

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

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

    छिपे हुए कुंजी संकेत 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. खोज चलाएँ

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

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

    उदाहरण
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    किया गया मतलब है खोज पूरा हो गया।
    results[].organic[]
    शीर्षक, लिंक और स्निपेट फ़ील्ड के साथ परिणाम खोजें।
    usage.credits
    इस अनुरोध के अनुसार क्रेडिट्स का उपयोग किया जाता है। पांच परिणाम एक खोज हैं, पांच अनुरोध नहीं है।

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

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

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

main.go में खोज कॉल बदलें
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

क्या Go 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 प्रकार

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

अगला कदम

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

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