दस्तावेज़ देखें
शुरू करें
Go SDK स्थापित करें और एक टाइप Google Search अनुरोध चलायें। फिर उसी क्लाइंट के साथ YouTube डेटा को आज़माएं।
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]इंस्टॉल करेंgo get github.com/flashdatadev/[email protected]प्रमाणीकरण
साइन अप करें, अपने ईमेल को सत्यापित करें और 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छिपे हुए कुंजी संकेत 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खोज चलाएँ
इसे सहेजें main.go बगल में go.modफिर इसे उसी टर्मिनल में चलाएं। यह एक खोज को पांच परिणाम तक भेजता है और JSON प्रतिक्रिया को प्रिंट करता है।
main.gopackage 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 .परिणाम जाँचें
मुद्रित 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 अनुमति की आवश्यकता है। अपने प्रश्नों के लिए समाचार परिणाम वापस लौटें।
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})youtube_metadata अनुमति की आवश्यकता है। वीडियो विवरण जैसे कि शीर्षक, चैनल और अवधि; यह वीडियो डाउनलोड नहीं करता है।
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})youtube_transcript अनुमति की आवश्यकता है। एक मौजूदा अंग्रेजी ट्रांसक्रिप्ट का अनुरोध करता है, जिसमें स्वचालित ट्रैक शामिल हैं। उस ट्रैक उपलब्ध होने पर टेक्स्ट और टाइमस्टैम्प लौटाएं।
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})क्या 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 की जाँच करें; पहला अनुरोध पहले से ही चल सकता है।