الانتقال إلى المحتوى الرئيسي
Google SERP (Search Engine Results Page) هي صفحة النتائج التي يراها المستخدمون بعد إدخال استعلام في محرك بحث Google. وهي تعرض نتائج البحث العضوية، والإعلانات، والمقتطفات المميزة، والرسم البياني المعرفي، بالإضافة إلى أنواع متعددة من المحتوى مثل الصور ومقاطع الفيديو، وتهدف إلى تزويد المستخدمين بالمعلومات الأكثر صلة. ستقدم هذه المقالة بالتفصيل Google SERP API، التي يمكنها توفير نتائج إدخال الاستعلامات في محرك بحث Google، كما أن محتوى النتائج يتضمن أيضًا العديد من الأنواع، مثل المقتطفات المميزة والرسم البياني المعرفي والصور وغيرها من النتائج المتنوعة. سيقدم هذا المستند دليل تكامل Google SERP API.

عملية التقديم

لاستخدام Google SERP API، انتقل أولًا إلى وحدة تحكم Ace Data Cloud للحصول على API Token الخاص بك، واحتفظ به للاستخدام لاحقًا. إذا لم تكن قد سجلت الدخول أو أنشأت حسابًا بعد، فسيتم توجيهك تلقائيًا إلى صفحة تسجيل الدخول لدعوتك إلى التسجيل وتسجيل الدخول، وبعد الإكمال ستعود تلقائيًا إلى الصفحة الحالية. يمكن لـ API Token واحد استدعاء جميع خدمات المنصة، ولا حاجة للتقديم بشكل منفصل لكل خدمة. سيُمنحك رصيد مجاني عند أول تقديم، ويمكنك التجربة مجانًا؛ وعندما لا يكون الرصيد كافيًا، يمكنك شحن الرصيد العام من وحدة التحكم.
📘 الوثائق الكاملة: Google SERP API →

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

أدخل الكلمات المفتاحية ونوع مورد البحث للحصول على النتائج: استخدم query لتمرير الكلمات المفتاحية، واستخدم type لاختيار أنواع البحث مثل صفحات الويب والصور والأخبار؛ لا تتطلب هذه الواجهة تمرير model. على سبيل المثال، للبحث عن: معلومات حول “apple inc”، يمكننا بعد ذلك ملء المحتوى المقابل في الواجهة، كما هو موضح في الصورة:

يمكنك رؤية أننا قمنا هنا بتعيين Request Headers، بما في ذلك:
  • accept: نوع تنسيق نتائج الاستجابة الذي تريد استقباله، وهنا يتم تعبئته بـ application/json، أي تنسيق JSON.
  • authorization: المفتاح لاستدعاء API، ويمكن اختياره مباشرة من القائمة المنسدلة بعد التقديم.
كما تم تعيين Request Body، بما في ذلك:
  • type: نوع مورد البحث، ويدعم حاليًا ستة أنواع فقط، والقيمة الافتراضية هي search.
  • query: الكلمات المفتاحية للبحث.
  • country: الدولة التي توجد فيها نتائج البحث المخصصة، والقيمة الافتراضية هي الولايات المتحدة (US).
  • language: لغة نتائج البحث المخصصة، والقيمة الافتراضية هي الإنجليزية (en).
  • range: النطاق الزمني لنتائج البحث المخصصة، والقيمة الافتراضية هي دون قيود.
  • number: حجم صفحة الترقيم لنتائج البحث المخصصة، والقيمة الافتراضية هي 10.
  • page: رقم صفحة الترقيم لنتائج البحث المخصصة، والقيمة الافتراضية هي 1.
بعد الاختيار، يمكن ملاحظة أنه تم أيضًا إنشاء الكود المقابل على الجانب الأيمن، كما هو موضح في الصورة:

انقر على زر «Try» لإجراء الاختبار، كما هو موضح في الصورة أعلاه، وهنا حصلنا على النتائج التالية:
تتضمن النتيجة المعادة عدة حقول، ويُعرَّف كلٌّ منها كما يلي:
  • knowledge_graph، الرسم البياني المعرفي لنتائج البحث.
  • organic، المعلومات التفصيلية لنتائج البحث.
  • people_also_ask، الأسئلة المرتبطة بكلمات البحث.
  • related_searches، عمليات البحث ذات الصلة بكلمات البحث.
يمكن ملاحظة أن النتائج المعادة هنا تحتوي على حقل organic، وهو يتضمن بشكل أساسي نتائج كلمات البحث. بالإضافة إلى ذلك، إذا أردت إنشاء كود التكامل المقابل، يمكنك نسخه مباشرةً لإنشائه، ومثال على كود CURL كما يلي:
كود التكامل بلغة Python كما يلي:

تخصيص نوع البحث

إذا خصصت نوع موارد البحث، فيمكننا تعديل المعلمة type، والتي تتضمن موارد البحث العادية search، وموارد الصور images، وموارد الأخبار news، وموارد الخرائط maps، وموارد المناطق places، وموارد الفيديو videos، وستستخدم هذه المقالة موارد الفيديو videos كمثال توضيحي. فيما يلي سنعرض العمليات المحددة. أولاً، اضبط المعلمة type على videos، ومرّر المعلمة query بشكل طبيعي، كما هو موضح في الشكل:

الكود المقابل كما يلي:
يمكن الحصول على الاستجابة التالية:
تحتوي النتائج المُعادة على عدة حقول، ويُعرَّف كل منها كما يلي:
  • news، قائمة بمعلومات الفيديوهات في نتائج البحث.
يمكن ملاحظة أن النتائج المُعادة هنا تحتوي على حقل videos، وهو يتضمن بشكل أساسي نتائج كلمات البحث.

تخصيص الدولة التي توجد فيها موارد البحث

تدعم هذه الواجهة أيضًا تحديد الدولة التي توجد فيها نتائج البحث، ويمكننا إضافة المعلمة country لتحديد الدولة، وتكون المعلمة المُدخلة هي الاختصار الخاص بالدولة، مثل cn (الصين)، وus (الولايات المتحدة)، وستُستخدم الصين كمثال أدناه، وفيما يلي المعلومات التفصيلية:

تأثير الإخراج كما يلي:
يمكن ملاحظة أن النتائج هي نتائج بحث في دولة الصين، والمحتوى المحدد مشابه لما ورد أعلاه.

لغة نتائج البحث المخصصة

يمكننا أيضًا تخصيص لغة نتائج البحث، وهنا نضيف حقل language إضافيًا، وتكون قيمته zh-cn، حيث يشير إلى لغة الصينية المبسطة، كما يدعم لغات أخرى، ولكن يجب إدخال اختصار اللغة، مثل en (English) وfr (French) وzh-cn (Chinese(Simplified)) وغيرها من اللغات، كما هو موضح في الشكل:

الكود المقابل كما يلي:
نتيجة التشغيل كما يلي:
يمكن ملاحظة أن النتائج المعروضة هنا كلها باللغة الصينية المبسطة، ومحتوى النتائج مشابه لما سبق.

تخصيص النطاق الزمني لنتائج البحث

يمكن لهذه المقالة أيضًا تخصيص النطاق الزمني لنتائج البحث، بما في ذلك خمسة أنواع، وهي qdr:h (الساعة الماضية)، وqdr:d (اليوم الماضي)، وqdr:w (الأسبوع الماضي)، وqdr:m (الشهر الماضي)، والافتراضي غير محدود. يمكننا تمرير النطاق الزمني المقابل عبر range، على سبيل المثال، هنا يتم تعيينه إلى qdr:d، وهذا يعني البحث عن نتائج اليوم الماضي، لذا يكون الإدخال كما يلي:

الكود المقابل كما يلي:
نتيجة التشغيل كما يلي:
كما يمكن ملاحظة، فقد نجحنا في الحصول على نتائج البحث لليوم الماضي، ومحتوى النتائج مشابه لما ورد أعلاه.

تخصيص ترقيم صفحات نتائج البحث

تدعم واجهة برمجة التطبيقات هذه أيضًا العرض المرقّم لنتائج البحث المخصصة، حيث يشير number وpage إلى حجم الصفحة وعدد الصفحات للترقيم. ستقوم هذه المقالة بتعيين 20 نتيجة بحث في الصفحة الواحدة لعرض الترقيم، والمعلومات المحددة كما هو موضح في الشكل:

ملاحظة: عندما تتجاوز النتائج في كل صفحة 10 نتائج، ستتضاعف النقاط المخصومة.
الكود كما يلي:
نتيجة التشغيل كما يلي:
يمكن ملاحظة أنه هنا عرض نتائج البحث على صفحات، حيث تعرض الصفحة الواحدة 20 نتيجة، ومحتوى النتائج مشابه لما ورد أعلاه.