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

Google Search / Python

Google Search API: البلد واللغة وترقيم الصفحات باستخدام Python

استخدم gl وhl وlocation لطلب نتائج Google المحلية، والتنقل بين الصفحات بأمان، وحفظ إعدادات البحث المُعادة باستخدام Python.

FlashData · منشورة

نتائج البحث المحلية في جميع أنحاء العالم مع عدد من صفحات النتائج

استعلام Google جزء فقط من طلب البحث. قد يحتاج من يبحث عن لندن ومن يبحث عن سنغافورة إلى نتائج مختلفة للكلمات نفسها. يوضح هذا الدليل طلب بلد ولغة واجهة ومدينة، ثم جمع عدد قليل من صفحات النتائج دون عدّ الروابط المكررة مرتين.

ستبنيون نصاً من طراز Python 3 يوفر كل من النتائج وعمليات البحث التي أعادتها شركة API. إذا كنت تقدم طلبك الأول، تبدأ Google نتائج البحث إلى CSV.

ما هو اللمع، والهليل، ومراقبة الموقع

  • gl هو الرمز القطري ذو البعثتين، مثل gb, us أو sg.

  • hl يختار لغة الوصل بينية من طراز Google، مثل en أو de. وليس ضماناً بأن تكون كل صفحة مُعادة مكتوبة بهذه اللغة.

  • location طلب موقع بحث استخدام اسم المدينة الواضح، مثل London, England, United Kingdom, عندما يهم السياق المحلي

استخدم هذه البارامترات معاً عندما تريد تشكيلة بحث واضحة والموقع هو طلب لمصدر البحث، وليس ضماناً للنتائج المتطابقة لغير شخص بعينه. ويمكن أن يؤثر هذا الرد على نوع البحث، والاستفسارات، والتوقيت، والبيانات المتاحة. Inspect results[0].searchParameters وبدلا من افتراض أن الخدمة تطبق كل قيمة دون تغيير.

جهزوا API الميزانية الأساسية والطلب

خلق مفتاح API وتأكد من أن الحساب متوفر تخزين المفتاح في بيئتك، ليس في مراقبة المصدر أو بروزر JavaScript. ولا تستخدم المدونة سوى مكتبة قياسية من طراز Python.

bash
export FLASHDATA_API_KEY='your-api-key'
export SEARCH_QUERY='coworking spaces'
export SEARCH_COUNTRY='gb'
export SEARCH_LANGUAGE='en'
export SEARCH_LOCATION='London, England, United Kingdom'
export SEARCH_MAX_PAGES='3'

num 3 - طلبات مقدمة من شركة 1–100 page تقبل 1–100. يمكن أن تكون العدّات العائدة أصغر من العدد المطلوب. كل صفحة هي طلب منفصل قابل للتعديل. وهذا المثال يطلب ما يصل إلى ثلاث صفحات، ويتوقف على صفحة فارغة، ولا يعيد النظر تلقائياً في التقارير الفاشلة.

جمع النتائج المحلية والحفاظ على سياقها

احفظ هذا localized-search.py. يسجل الصفحة المطلوبة جنبا إلى جنب مع كل نتيجة، ويحتفظ الأصلية position إذا أُعيد واحد، ويُزيل فقط تكراراً دقيقاً URLs. إنه لا يحسب عمداً ترتيباً عالمياً (page - 1) × num: العدّ المُعاد يمكن أن يتباين.

python
import json
import os
from pathlib import Path
from urllib.error import HTTPError
from urllib.request import Request, urlopen

key = os.environ["FLASHDATA_API_KEY"]
max_pages = int(os.getenv("SEARCH_MAX_PAGES", "3"))
if not 1 <= max_pages <= 100:
    raise ValueError("SEARCH_MAX_PAGES must be between 1 and 100")

query = os.getenv("SEARCH_QUERY", "coworking spaces")
settings = {
    "gl": os.getenv("SEARCH_COUNTRY", "gb"),
    "hl": os.getenv("SEARCH_LANGUAGE", "en"),
    "location": os.getenv("SEARCH_LOCATION", "London, England, United Kingdom"),
    "num": 10,
}
rows, pages, seen = [], [], set()
for page in range(1, max_pages + 1):
    payload = {"source": "google_search", "query": query,
               "params": {**settings, "page": page}}
    request = Request(
        "https://data.flashdata.dev/v1/queries/realtime",
        data=json.dumps(payload).encode(), method="POST",
        headers={"Content-Type": "application/json", "X-API-Key": key},
    )
    try:
        with urlopen(request, timeout=60) as response:
            body = json.load(response)
    except HTTPError as error:
        raise RuntimeError(f"Search failed: HTTP {error.code}. Check the request and account before resubmitting.") from error
    if body.get("error") or body.get("status") != "done":
        raise RuntimeError("Search did not complete. Check Request History before resubmitting.")
    if not isinstance(body.get("results"), list) or not body["results"]:
        raise RuntimeError("Expected a search result object")
    result = body["results"][0]
    organic = result.get("organic", [])
    pages.append({"requestedPage": page, "requestedParams": payload["params"],
                  "reportedParams": result.get("searchParameters"),
                  "returnedCount": len(organic), "usage": body.get("usage")})
    for item in organic:
        link = item.get("link")
        if link and link not in seen:
            seen.add(link)
            rows.append({"requestedPage": page, **item})
    if not organic:
        break

Path("localized-results.json").write_text(
    json.dumps({"query": query, "pages": pages, "organic": rows}, indent=2),
    encoding="utf-8",
)
print(f"Saved {len(rows)} unique URLs from {len(pages)} pages")
bash
python3 localized-search.py

قراءة الناتج قبل مقارنة الأسواق

ملف JSON يحتوي على pages الدخول لكل طلب مكتمل organic مجموعة من الروابط الفريدة. استمر requestedParams و reportedParams مع بياناتك. وينبغي أن يظل الحقل الغائب غائباً أو null؛ ولا يصنّع بلداً أو قيمة موقعية للرد الذي لم يبلغ عنه.

(ب) مقارنة سوقين، والاحتفاظ بالاستفسار، وطلب تخصيص ميزانية للصفحة، وتغيير البلد واللغة والموقع عمداً. وقت جمع السجلات في طلبك إذا كنت بحاجة إلى مقارنات تاريخية. وتختلف مجموعات النتائج هي ملاحظات من تلك الطلبات، وليس دليلاً على حدوث تغيير دائم في الرتبة.

لماذا صفحة تحتوي على نتائج أقل؟

ويمكن أن تشمل نتائج البحث سمات غنية ووصلات عضوية، وقد يعود المصدر إلى المواد العضوية أقل مما هو مطلوب. عدّ المجموعة المُعادّة. والصفحة العضوية الفارغة هي حالة توقف معقولة لهذا النص الصغير؛ وهي لا تثبت أن Google ليس لديها صفحات أخرى ذات صلة.

بالنسبة لأخطاء 401/403، تحقق من مفتاح API والإذن. وفيما يتعلق بالأخطاء الائتمانية أو الحد الأقصى للأسعار، حل مسألة الحساب أو سعر الطلب أولا. ولا يثبت انقطاع الشبكة أن طلب دفع لم يُنفذ قط؛ ويفتش الطلب History قبل تقديمه مرة أخرى.

تابعوا Google Search API, دليل الأسينك والدفعة, أو لمحة عامة عن منتجات Google Search.