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

البدء

البدء السريع

نفّذ أول بحث في Google واحصل على نتائج منظّمة لتطبيقك أو وكيل الذكاء الاصطناعي.

ابدأ باستخدام وكيل الذكاء الاصطناعي

أرسل هذا الموجّه إلى وكيل يستطيع استخدام الطرفية. سيُعدّ FlashData وينفّذ عملية بحث واحدة.

نفّذ أول استدعاء API

هل تفضّل كتابة الكود بنفسك؟ اتبع هذه الخطوات الثلاث في الطرفية.

  1. احصل على مفتاح API

    أنشئ حسابًا وأكّد بريدك الإلكتروني، ثم أنشئ مفتاحًا بصلاحية Google Search. أعد استخدام مفتاحك إن كان لديك واحد بالفعل.

    شغّل الأمر في الطرفية والصق المفتاح عند مطالبة الإدخال المخفي. تجاوز هذه الخطوة إذا كان FLASHDATA_API_KEY مضبوطًا بالفعل.

    اضبط المفتاح
    # 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
  2. نفّذ بحثًا

    اختر لغة برمجة وشغّل المثال في الطرفية نفسها. كل تشغيل يرسل عملية بحث واحدة.

    Python 3.10+ · احفظ المثال باسم quickstart.py.

    تثبيت
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    import os
    from flashdata import FlashData
    
    with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        print(json.dumps(response, indent=2))
    تشغيل
    python quickstart.py
  3. تحقق من النتيجة

    تتضمن الاستجابة الناجحة status: done. توجد المصادر في results[].organic والأرصدة المستخدمة في usage.credits.

    مثال استجابة مختصر
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

جرّب لوحة التحكم

  1. اصنعي حساباً أو اوقعي فيه التحقق الكامل من البريد الإلكتروني وأي شكل من أشكال الحساب المبينة في مجموعة الوصلات.
  2. افتح Google Search، واختر مصدر Google Search ووضع Realtime، ثم أدخل battery recycling research. وسّع Additional parameters واضبط Page size (num) على 5.
  3. تحقق من الطلب المُعرض و الائتمانات المتاحة، ثمّ يُدير البحث مرة واحدة.
  4. فحص الرد والإستخدام. فتح مصدر عائد للتحقق من محتوياته قبل الاستشهاد بأكثر من مقتطفه.

تابع بعد النتيجة الأولى

إذا فشل الطلب الأول

لم يتم ضبط FLASHDATA_API_KEY
اضبط المفتاح في الطرفية أو بيئة التشغيل التي تستخدمها للمثال. هذه الأمثلة لا تقرأ ملفات .env.
401 / 403
تحقق من أن المفتاح أو الاتصال نشط ولديه صلاحية google_search.
402
تحقق من الأرصدة المتاحة في Billing. اربط التجربة الحالية بالحساب إذا احتجت إلى صلاحيات المالك.
429
التزم بقيمة Retry-After. احتفظ بالهوية وإثبات التسجيل نفسيهما؛ لا تنشئ تجربة أخرى.
انتهت المهلة أو تعذّر تحديد حالة الإرسال
افحص التشغيل الموجود قبل إعادة المحاولة. على مستخدمي CLI الاحتفاظ بالملف الشخصي ومعرّف التشغيل نفسيهما؛ وعلى مستخدمي SDK/API حفظ معرّف المهمة أو الطلب المُعاد.