تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

البدء

Go SDK

ثبّت Go SDK وشغّل طلب Google Search بأنواع محددة. ثم جرّب بيانات YouTube بالعميل نفسه.

  1. 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]
  2. التوثيق

    وقّعْ، يُحقّقُ بريدكَ الإلكتروني ويُخلقُ 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
  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. تحقق من النتيجة

    ابحث عن 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 إذن. يعيد نتائج الأخبار من أجل سؤالك.

يستعاض عن نداء البحث في main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

ما يدعمه 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 وقبل الإلغاء؛ قد يكون الطلب الأول قد بدأ بالفعل.