gl बनाम hl बनाम location: Google Search API Locale सेटिंग्स
Senior Web Scraping Engineer
संक्षेप:
- gl, hl, और location अलग-अलग खोज इनपुट का वर्णन करते हैं। देश, भाषा और खोज‑उत्पत्ति को अलग रखें।
- सात सफल देश‑अनुरोध लौटाए गए डेटा को दिखाते हैं। वे शहर‑स्तरीय शुद्धता प्रतिशत स्थापित नहीं करते।
- एक उपयोगी लोकलाइज़ेशन परीक्षण में एक बार में केवल एक ही चर बदला जाता है। आउटपुट की तुलना करने से पहले क्वेरी और अन्य सेटिंग्स को स्थिर रखें।
- अनुरोधित सेटिंग्स को देखे गए प्रमाण के साथ ही रखें। किसी स्थान को तब तक अप्रमाणित चिह्नित करें जब तक किसी स्वतंत्र जाँच से उसका समर्थन न हो जाए।
भूमिका: देश कोड केवल खोज का एक हिस्सा है
खोज परिणाम केवल कीवर्ड पर निर्भर नहीं करते। देश‑पसंद, भाषा‑सेटिंग और स्थानीय उत्पत्ति, सभी संदर्भ देते हैं, और ये अलग‑अलग प्रभाव उत्पन्न कर सकते हैं।
यह गाइड gl बनाम hl बनाम location को Scrapeless Google Search API के लिए समझाता है। यह सात‑देशों की अनुरोध मैट्रिक्स और स्थानीय व्यवहार को स्वतंत्र रूप से जाँचने की एक विधि दिखाता है। यह किसी भी नॉन‑एम्प्टी प्रतिक्रिया को इस बात के सबूत की तरह नहीं लेता कि कोई विशेष शहर सटीक रूप से प्रदर्शित हुआ था।
स्वीकार्य नियंत्रकों के लिए Google Search पैरामीटर अनुबंध संदर्भ है। जैसे‑जैसे आप input के अंदर इन नियंत्रकों को बदलते हैं, एक्टर अनुरोध वर्कफ़्लो वैसा ही रहता है।
प्रत्येक पैरामीटर क्या नियंत्रित करता है
gl पैरामीटर खोज‑देश चुनता है, hl खोज‑भाषा चुनता है, और location अनुरोधित खोज‑उत्पत्ति को निर्दिष्ट करता है। इन इनपुट्स को किसी कलेक्शन रिकॉर्ड में अलग‑अलग संग्रहित किया जाना चाहिए।
| Parameter | Example | What Not to Infer |
|---|---|---|
gl |
us |
हर परिणाम किसी US संगठन से ही संबंधित होगा |
hl |
en |
हर गंतव्य पृष्ठ अंग्रेज़ी ही होगा |
location |
Austin, Texas, United States |
हर लोकल परिणाम स्वतंत्र रूप से जियोकोड किया गया है |
google_domain |
google.com |
केवल डोमेन नाम ही शहर‑शुद्धता स्थापित करता है |
किसी असंबंधित लोकेल लाइब्रेरी के माध्यम से लेबल्स को अपने‑आप ट्रांसलेट करने के बजाय API के स्वीकृत मानों का उपयोग करें। उदाहरण के लिए, मौजूदा संदर्भ यूनाइटेड किंगडम के लिए uk का उपयोग करता है। कोई सामान्य भाषा या क्षेत्र मानक और किसी विशेष API के स्वीकृत मान हमेशा एक‑से नहीं होते।
language-tag standard समझाता है कि भाषा‑पहचान में कई सबटैग शामिल हो सकते हैं, लेकिन यह hl द्वारा स्वीकृत मानों का विस्तार नहीं करता। इसी तरह, Unicode locale conventions किसी सेवा के पैरामीटर अनुबंध को बदले बिना लोकेल डेटा का वर्णन करने में मदद करते हैं।
देश‑प्राथमिकता को भाषा‑प्रतिबंध से अलग रखें
खोज‑भाषा इनपुट को यह गारंटी मानकर नहीं चलना चाहिए कि हर परिणाम‑दस्तावेज वही भाषा प्रयोग करेगा। भाषा‑सेटिंग, दस्तावेज‑भाषा पर प्रतिबंध, और किसी विशेष भाषा में लिखी गई क्वेरी – ये अलग‑अलग नियंत्रक हैं।
Google, भाषा खोज परिणामों को कैसे प्रभावित करती है, को एक से अधिक संकेतों के रूप में वर्णित करता है। अपने प्रयोग में, क्वेरी‑भाषा के साथ‑साथ hl भी रिकॉर्ड करें। अंग्रेज़ी में लिखी क्वेरी और जापानी में अनूदित वही क्वेरी, अन्य इनपुट समान होने पर भी, दो अलग‑अलग प्रयोग हैं।
देश और शहर बदलते समय क्वेरी का अनुवाद करने से बचें। यदि परिणाम अलग हों, तो आप नहीं जान पाएँगे कि किस जानबूझकर बदले गए इनपुट ने अंतर में योगदान दिया। पहले एक ही चर को अलग करें; फिर वह पूर्ण कॉन्फ़िगरेशन जाँचें जिसकी आपके अनुप्रयोग को आवश्यकता है।
सात देशों की उपलब्धता का उदाहरण
coffee के लिए सात अनुरोध, सभी hl=en का उपयोग करते हुए, ने नॉन‑एम्प्टी ऑर्गेनिक ऐरे लौटाए जब gl को निम्न देशों में बदला गया। प्रत्येक HTTP 200 के साथ पूर्ण हुआ।
| Country | gl | hl | Returned Organic Records |
|---|---|---|---|
| United States | us | en | 8 |
| United Kingdom | uk | en | 9 |
| Germany | de | en | 9 |
| France | fr | en | 10 |
| Japan | jp | en | 10 |
| Canada | ca | en | 9 |
| Australia | au | en | 9 |
ये गिनतियाँ दर्शाती हैं कि उन कॉन्फ़िगर किए गए अनुरोधों के लिए डेटा लौटाया गया था। ये देश‑शुद्धता, भाषा‑शुद्धता, या शहर‑शुद्धता को नहीं मापतीं। अनुरोधों में location में कोई शहर शामिल नहीं था, और लौटाए गए गंतव्यों को किसी स्वतंत्र भौगोलिक ग्राउंड‑ट्रुथ से नहीं जोड़ा गया था।
विभिन्न गणनाएँ यह भी साबित नहीं करतीं कि भूगोल ने अंतर पैदा किए। प्रत्येक कॉल एक अलग खोज स्नैपशॉट है। किसी कारणात्मक या शुद्धता के दावे से पहले एक नियंत्रित अध्ययन के लिए दोहराए गए अवलोकन और पहले से परिभाषित माप आवश्यक होते हैं।
Scrapeless के साथ स्क्रैपिंग शुरू करें
Scrapeless के साथ अपने वेब स्क्रैपिंग और ऑटोमेशन वर्कफ़्लो को पावरअप करें!
आज ही साइन अप करें और पाएँ $5 का फ्री क्रेडिट — कोई क्रेडिट कार्ड आवश्यक नहीं।अभी अपना फ्री क्रेडिट Scrapeless Dashboard में क्लेम करें।
एक पुनरुत्पाद्य देश मैट्रिक्स सहेजें
निम्न कार्यक्रम हर देश के लिए सटीक इनपुट और पूरी प्रतिक्रिया को सुरक्षित रखता है और स्थान सत्यापन को स्पष्ट रूप से अपूर्ण के रूप में लेबल करता है। यह एक सफल नेटवर्क अनुरोध को असमर्थित शुद्धता स्कोर में बदलने से बचाता है।
पूर्वापेक्षाएँ हैं Python, Requests, और पर्यावरण में SCRAPELESS_API_KEY। Requests को python -m pip install requests से इंस्टॉल करें, प्रोग्राम को country_matrix.py के रूप में सहेजें, और python country_matrix.py चलाएँ। प्रत्येक रन country-runs के अंतर्गत एक अलग डायरेक्टरी बनाता है।
हेल्पर लंबित कार्यों को प्रलेखित परिणाम वर्कफ़्लो के माध्यम से संभालता है। लूप अनुक्रमिक है, इसलिए उदाहरण किसी खाते-विशिष्ट समकालिकता सीमा को मान कर नहीं चलता।
python
import json
import os
import time
from pathlib import Path
from urllib.parse import quote
import requests
BASE = "https://api.scrapeless.com/api/v1/scraper"
def google_search(query):
headers = {"x-api-token": os.environ["SCRAPELESS_API_KEY"]}
response = requests.post(
BASE + "/request", headers=headers,
json={"actor": "scraper.google.search", "input": query},
timeout=(10, 60), allow_redirects=False,
)
task_id = None
for poll in range(11):
response.raise_for_status()
if response.status_code not in (200, 201):
raise RuntimeError(f"Unexpected HTTP status: {response.status_code}")
data = response.json()
if not isinstance(data, dict):
raise ValueError("Expected a JSON object")
if response.status_code == 200:
return data
if task_id is None:
task_id = data.get("taskId")
if not isinstance(task_id, str) or not task_id:
raise ValueError("Pending response has no taskId")
if poll == 10:
raise TimeoutError(f"Task still pending; retain taskId={task_id}")
time.sleep(2)
response = requests.get(
BASE + "/result/" + quote(task_id, safe=""),
headers=headers, timeout=(10, 30), allow_redirects=False,
)
def organic_rows(data):
rows = data.get("organic_results")
if not isinstance(rows, list):
raise ValueError("organic_results is missing or is not an array")
if not all(isinstance(row, dict) for row in rows):
raise ValueError("organic_results contains a non-object item")
return rows
if __name__ == "__main__":
from datetime import datetime, timezone
run_dir = Path("country-runs") / datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%S%fZ")
run_dir.mkdir(parents=True)
summary = []
for country in ("us", "uk", "de", "fr", "jp", "ca", "au"):
query = {"q": "coffee", "gl": country, "hl": "en"}
data = google_search(query)
(run_dir / f"{country}.json").write_text(json.dumps({"input": query, "response": data}, ensure_ascii=False, indent=2), encoding="utf-8")
rows = organic_rows(data)
summary.append({"gl": country, "hl": "en", "rows": len(rows), "location_verified": False})
(run_dir / "summary.json").write_text(json.dumps(summary, indent=2), encoding="utf-8")
print(json.dumps(summary))
कोड location_verified को false ही छोड़ता है, भले ही डेटा वापस आ जाए। वह फ़ील्ड एक एप्लिकेशन निर्णय है, न कि API प्रतिक्रिया में मौजूद होने का दावा किया गया फ़ील्ड। इसे तभी बदलें जब आप अपनी परिभाषित स्वतंत्र सत्यापन प्रक्रिया पूरी कर लें।
किसी शहर को स्वतंत्र रूप से सत्यापित करें
किसी शहर का सत्यापन अनुरोधित स्रोत स्थान की तुलना लौटाए गए पृष्ठ में स्थान-संबंधी प्रमाण और एक स्वतंत्र बेसलाइन से करना चाहिए। केवल गैर-रिक्त ऑर्गेनिक परिणाम इस मेल की स्थापना नहीं करते।
किसी सार्वजनिक क्वेरी से शुरू करें जिसमें स्थानीय इरादा हो, जैसे coffee shops। q, gl, hl, खोज मोड, और अन्य फ़िल्टर स्थिर रखें। पूरी तरह निर्दिष्ट ऑस्टिन लोकेशन के साथ एक अनुरोध चलाएँ और पूरी तरह निर्दिष्ट सिएटल लोकेशन के साथ दूसरा। API की एंडपॉइंट गाइडेंस शहर-स्तरीय लोकेशन की अनुशंसा करती है और location तथा uule को परस्पर अनन्य मानती है।
इन दो शहर नामों के लिए तैयारी संबंधी अनुरोधों ने प्रत्येक में नौ ऑर्गेनिक रिकॉर्ड लौटाए। यह कॉन्फ़िगर किए गए इनपुट के लिए डेटा उपलब्धता की पुष्टि करता है। यह स्थापित नहीं करता कि दिखाई देने वाला सर्च लोकेशन या हर परिणाम इच्छित शहर से मेल खाता था।
बड़ा नमूना एकत्र करने से पहले, अपना वैलिडेशन शीट परिभाषित करें। उपयोगी कॉलम में शामिल हैं: अनुरोधित शहर, दिखाई देने वाला स्थान-संबंधी प्रमाण, जहाँ उपलब्ध हो वहाँ नमूना स्थानीय-व्यवसाय पते, स्वतंत्र बेसलाइन विधि, अवलोकन समय, और समीक्षक का परिणाम। जब उपलब्ध हो, संबद्ध metadata.rawUrl को सहेजें ताकि पृष्ठ का निरीक्षण किया जा सके।
दस्तावेज़ित सेटिंग्स के साथ मैनुअल बेसलाइन या एक स्वतंत्र विश्वसनीय माप का उपयोग करें। समीक्षक को केवल कंट्री-कोड डोमेन से स्थान निष्कर्षित करने के बजाय प्रमाण की जाँच करनी चाहिए। कोई राष्ट्रीय प्रकाशक स्थानीय खोज में दिख सकता है, और कोई स्थानीय व्यवसाय सामान्य डोमेन का उपयोग कर सकता है।
परिणामों को पुष्टि‑कृत, विरोधाभासी, या अपर्याप्त प्रमाण के रूप में चिह्नित करें। अनिश्चित अवलोकनों को पास श्रेणी में ठूँसने की कोशिश न करें। किसी सटीकता प्रतिशत को प्रकाशित करने के लिए, परिणाम देखने से पहले हर बार हर (denominator) और निर्णय‑नियम परिभाषित करें।
चल रही तुलनाओं को तुलनीय रखें
किसी लोकलाइज़ेशन डेटासेट के लिए स्थिर इनपुट और दिखाई देने वाला संग्रहण संदर्भ ज़रूरी है। अनुरोधित सेटिंग्स को सहेजें, भले ही प्रतिक्रिया अपना मेटाडेटा शामिल करे; ये दोनों रिकॉर्ड अलग सवालों के जवाब देते हैं।
क्वेरी को ठीक वैसे ही दर्ज करें जैसी वह है, अनुरोधित देश और भाषा, कोई भी लोकेशन स्ट्रिंग, खोज मोड, संग्रहण समय, और प्रतिक्रिया परिणाम। केवल‑देश बेसलाइन को शहर‑विशिष्ट प्रयोगों से अलग रखें। डेस्कटॉप वेब‑सर्च परिणाम की तुलना लोकल‑मोड परिणाम से ऐसे न करें मानो केवल शहर बदला हो।
प्रोडक्शन वर्कफ़्लो के लिए तय करें कि जब स्थान‑प्रमाण अनुपस्थित हो तो क्या होना चाहिए। ऐसी ऑब्ज़र्वेशन को समीक्षा के लिए रोके रखना, उसे सत्यापित शहर स्नैपशॉट के रूप में प्रस्तुत करने से अधिक जानकारीपूर्ण है। दोहराए गए अवलोकनों और स्वतंत्र जाँचों के लिए अलग‑अलग बजट बनाने के लिए मौजूदा मूल्य निर्धारण का उपयोग करें।
निष्कर्ष: वही स्थान सत्यापित करें जिसका आप दावा करते हैं
देश, भाषा, और शहर इनपुट खोज संग्रह को अधिक सोचा‑समझा बनाते हैं, लेकिन सबसे मज़बूत स्थान‑दावा को प्रमाण से मेल खाना चाहिए। एक छोटे कॉन्फ़िगरेशन मैट्रिक्स से शुरू करें, प्रतिक्रियाओं को सुरक्षित रखें, और शहर‑स्तरीय रिपोर्टिंग बनाने से पहले इच्छित भूगोल को सत्यापित करें।
Google Search API उत्पाद पेज सेवा का परिचय देता है; पैरामीटर कॉन्ट्रैक्ट इम्प्लिमेंटेशन को नियंत्रित करता है। सफल response को अंत नहीं, बल्कि वैलिडेशन की शुरुआत की तरह ट्रीट करें।
अपना सर्च डेटा वर्कफ़्लो बनाएँ
हमारे समुदाय में सर्च डेटा के साथ काम कर रहे डेवलपर्स से जुड़ें: Discord · Telegram.
एक Scrapeless अकाउंट बनाएं और बड़ी कलेक्शन शेड्यूल करने से पहले इस ट्यूटोरियल को एक छोटे क्वेरी सेट पर लागू करें।
FAQ
प्रश्न: क्या gl और hl एक-दूसरे की जगह इस्तेमाल किए जा सकते हैं?
नहीं। gl सर्च कंट्री चुनता है और hl सर्च लैंग्वेज चुनता है। इन्हें अलग-अलग स्टोर और टेस्ट करें।
प्रश्न: क्या hl=en हर परिणाम को सिर्फ अंग्रेज़ी तक सीमित कर देता है?
इसे हर result document के बारे में गारंटी की तरह ट्रीट न करें। सर्च-भाषा सेटिंग्स और डॉक्यूमेंट-भाषा प्रतिबंध अलग कॉन्सेप्ट हैं।
प्रश्न: क्या location और uule दोनों साथ में दिए जा सकते हैं?
नहीं। मौजूदा पैरामीटर कॉन्ट्रैक्ट इन्हें एक-दूसरे के विकल्प के रूप में रखता है। अपने कॉन्फ़िगरेशन के अनुरूप जो समर्थित कंट्रोल हो, उसे चुनें।
प्रश्न: क्या सात nonempty country responses सात देशों की accuracy साबित करते हैं?
नहीं। वे सात रिक्वेस्टेड कॉन्फ़िगरेशनों के लिए लौटाया गया डेटा दिखाते हैं। accuracy के लिए independently जाँचा गया लोकेशन एविडेंस चाहिए।
प्रश्न: क्या सिर्फ country-code डोमेन से local relevance साबित हो जाती है?
नहीं। सिर्फ डोमेन नेमिंग से न तो पेज की जियोग्राफी स्थापित होती है, न SERP द्वारा दर्शाए गए origin की।
प्रश्न: क्या उदाहरण के लिए ब्राउज़र या AI एजेंट ज़रूरी है?
नहीं। यह Python और HTTP API का उपयोग करता है। स्वतंत्र विज़ुअल वैलिडेशन में ब्राउज़र शामिल हो सकता है, लेकिन वह एक अलग वेरिफिकेशन स्टेप है।
स्क्रैपलेस में, हम केवल सार्वजनिक रूप से उपलब्ध डेटा का उपयोग करते हैं, जबकि लागू कानूनों, विनियमों और वेबसाइट गोपनीयता नीतियों का सख्ती से अनुपालन करते हैं। इस ब्लॉग में सामग्री केवल प्रदर्शन उद्देश्यों के लिए है और इसमें कोई अवैध या उल्लंघन करने वाली गतिविधियों को शामिल नहीं किया गया है। हम इस ब्लॉग या तृतीय-पक्ष लिंक से जानकारी के उपयोग के लिए सभी देयता को कोई गारंटी नहीं देते हैं और सभी देयता का खुलासा करते हैं। किसी भी स्क्रैपिंग गतिविधियों में संलग्न होने से पहले, अपने कानूनी सलाहकार से परामर्श करें और लक्ष्य वेबसाइट की सेवा की शर्तों की समीक्षा करें या आवश्यक अनुमतियाँ प्राप्त करें।



