الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

يمكن دمج وظيفة البحث في الوقت الحقيقي داخل التطبيق لتمكين المستخدمين من الحصول على أحدث المعلومات. توفر واجهة برمجة التطبيقات SERP من Ace Data Cloud بيانات منظمة لبحث Google، وتدعم أنواع بحث متعددة مثل الويب، الصور، الأخبار، وغيرها.

​
الخدمات المعنية

  • بحث Google: POST https://api.acedata.cloud/serp/google

​
الحل التقني

​
المتطلبات المسبقة

  1. التسجيل في Ace Data Cloud
  2. الحصول على رمز API Token
  3. تثبيت Python 3.7+ ومكتبة requests

​
خطوات التنفيذ

​
الخطوة 1: تكوين معلمات البحث

تعيين المعلمات مثل query، type، language، country وغيرها.

​
الخطوة 2: استدعاء واجهة البحث

استخدام POST /serp/google لإرسال طلب البحث.

​
الخطوة 3: تحليل نتائج البحث

معالجة البيانات المنظمة المستلمة، واستخراج العنوان، الرابط، الملخص، وغيرها من المعلومات.

​
مثال على الكود

فيما يلي مثال كامل باستخدام Google Search بلغة Python: 
import requests

API_TOKEN = "YOUR_API_TOKEN"

def call_serp():
    response = requests.post(
        "https://api.acedata.cloud/serp/google",
        headers={
            "Authorization": f"Bearer {API_TOKEN}",
            "Content-Type": "application/json",
        },
        json={
    "query": "artificial intelligence latest news",
    "type": "search",
    "number": 10,
    "language": "en",
    "country": "US"
},
    )
    return response.json()

result = call_serp()
print(result)

​
أفضل الممارسات

  • إعادة المحاولة عند الخطأ: تطبيق التراجع الأسي لإعادة المحاولة عند أخطاء 429 (تحديد المعدل) و 5xx
  • المعالجة غير المتزامنة: استخدام callback_url لاستقبال النتائج بشكل غير متزامن للمهام التي تستغرق وقتًا طويلاً (توليد الصور/الفيديو)
  • التحكم في التكلفة: مراقبة الاستخدام والتكاليف عبر لوحة تحكم Ace Data Cloud
  • أمان الرمز المميز: تخزين API Token في متغيرات البيئة وعدم تضمينه مباشرة في الكود

​
روابط ذات صلة