تصفح الوثائق
البدء
ثبّت Go SDK وشغّل طلب Google Search بأنواع محددة. ثم جرّب بيانات YouTube بالعميل نفسه.
Install the SDK
Requires 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]التوثيق
وقّعْ، يُحقّقُ بريدكَ الإلكتروني ويُخلقُ API مفتاح Google Search إذن، أو إعادة استخدام مفتاح مأذون به.
المجموعة FLASHDATA_API_KEY تحت، أو الحفاظ على القيمة التي تم توفيرها بالفعل من قبل البيئة الخاصة بك. ويقرأ هذا المثال صراحة؛ ولا تُحمَّل الملفات التي تُملأ.
مفتاح مخفي: 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 .تحقق من النتيجة
ابحث عن status: done in the printed JSON. استعملوا ألقاب العودة 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، يستعاض عن النتيجة فقط، er := 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- البحث، الأخبار، الصور، التسوق، الفيديو والأماكن. الاستخدام Google.Pages من أجل النتائج الممهدة
YouTube- ويوفر البحث، والبيانات الوصفية، والنسخ، والقواني، والاقتراحات بيانات مصورة.
YouTube.Download- قم بتوصيل وظيفة تسجيل صوتي أو فيديو لتخزينك السحابي (ب) اشتراطات الأذن والتخزين من طراز youtube_download؛ استخدام المثال الكامل أدناه.
Jobs / Bulk- أرسل باستخدام دالة Async مساعدة، واحفظ معرّف المهمة، ثم استخدم Jobs.Wait وJobs.Result. يعالج Bulk مجموعات البيانات الأكبر والمهام القابلة للاستئناف.
Account- اقرأ الهوية والتوازن والتسعير والحدود والعرف قبل العمل غير المعدل. إعادة استخدام نفس العميل والمفتاح المأذون به.
WithFormat- اطلب JSON أو نصًا عاديًا أو Markdown بخيارات تنسيق صريحة. ينسّق Markdown البيانات المسترجعة لوكيلك؛ ويتولى تطبيقك استدعاءات النموذج أو الملخصات.
Go
GoogleSearchInput describes the query. (ز) مؤشرات استخدام البارامترات الاختيارية، مثل flashdata.Ptr(int64(5)). وتتضمن النتائج المصدر JSON؛ واستخدام DecodeResults [GoogleSearchPayload] عندما تحتاج إلى حقول مطبوعة.
الخطوات التالية
إذا فشلت خطوة
- الحزمة أو الإجازات المفقودة
- تحقق من النسخة و اذهب وادخل الدليل المحتوي go.mod.
- 401 / FLASHDATA_API_KEY
- ضع مفتاحاً صالحاً في المحطة حيث تدير المثال
- 403
- Enable Google Search for this API key.
- 402
- تحقق من شركة Billing فيما يتعلق بالائتمانات المتاحة، أو تدّعي تجربة عميل مستنفد.
- 429
- انتظر Retry-Afterثم خفض معدل طلبك.
- الوقت أو خطأ الخادم
- تحقق History وقبل الإلغاء؛ قد يكون الطلب الأول قد بدأ بالفعل.