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

مقدمة

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

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

  • امتلاك حساب في Ace Data Cloud والحصول على رمز API Token
  • بيئة بايثون 3.7 أو أعلى
  • تثبيت مكتبة requests: pip install requests

الاستخدام الأساسي

نقطة النهاية الرئيسية لاستدعاء Google Search API هي:
POST https://api.acedata.cloud/serp/google
مثال كامل على كود بايثون:
import requests

url = "https://api.acedata.cloud/serp/google"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "query": "artificial intelligence latest news",
    "type": "search",
    "number": 10,
    "language": "en",
    "country": "US"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
يرجى استبدال YOUR_API_TOKEN بالرمز الفعلي الذي حصلت عليه من منصة Ace Data Cloud.

معالجة الاستجابة

بعد استدعاء ناجح، تعيد API بيانات بصيغة JSON. يُنصح بفحص رمز حالة HTTP:
if response.status_code == 200:
    result = response.json()
    print("تم الاستدعاء بنجاح:", result)
else:
    print(f"فشل الاستدعاء، رمز الحالة: {response.status_code}")
    print(response.text)

الاستخدام المتقدم

بالنسبة للواجهات التي تدعم المهام غير المتزامنة، يمكن الحصول على النتائج عبر عنوان URL للرد الراجع (callback):
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# سيتم دفع النتائج إلى خادمك عبر عنوان URL للرد الراجع

معالجة الأخطاء

رموز الأخطاء الشائعة:
رمز الحالةالوصف
401فشل التوثيق، يرجى التحقق من API Token
403رصيد غير كافٍ أو لا تملك صلاحية الوصول
429تجاوز معدل الطلبات المسموح به
500خطأ داخلي في الخادم

الخطوة التالية