गूगल इमेजेज़ को गूगल सर्च API के साथ: एक व्यावहारिक मार्गदर्शिका

TL;DR:

• छवि-खोज खोज के लिए Google Search API का उपयोग करें tbm=isch। अनुरोध वही प्रमाणित एंडपॉइंट और scraper.google.search अभिनेता का उपयोग करता है जैसे वेब खोज में।
• एक निर्यातक डिजाइन करने से पहले छवि डेटा का निरीक्षण करें। उदाहरण में पूर्ण प्रतिक्रिया को सहेजा जाता है और इसकी संरचना को बिना किसी अविश्वसनीय छवि-नतीजे स्कीमा के मान लिए प्रिंट किया जाता है।
• खोज दृश्यता और छवि पुनः उपयोग अलग होते हैं। एक खोज परिणाम एक छवि को स्थानांतरित करने में मदद कर सकता है; स्रोत पृष्ठ और लाइसेंस उपयोग के लिए अगला कदम निर्धारित करते हैं।

एक छवि-खोज कार्यप्रणाली खोज के साथ शुरू होती है: एक क्वेरी के लिए उम्मीदवार छवियां खोजें, स्रोतों का निरीक्षण करें, और निर्णय लें कि कौन से रिकॉर्ड एक शोध डेटासेट में शामिल होते हैं। एक उपयोगी एकीकरण उस मार्ग को बनाए रखता है बजाय इसके कि फ़ाइलों को तुरंत डाउनलोड किया जाए और उन पृष्ठों को खो दिया जाए जो उन्हें समझाते हैं।

यह गाइड Scrapeless Google Search API के भीतर Google Images API परिदृश्य का उपयोग करती है। इसमें अनुरोध सेटिंग्स, एक पूर्ण Python कैप्चर स्क्रिप्ट और लौटाए गए डेटा को एक छवि कैटलॉग में बदलने से पहले आवश्यक चेक शामिल हैं। यह यह मानने का प्रयास नहीं करती कि एक वेब-नतीजा फ़ील्ड मैप छवि परिणामों का भी वर्णन करता है।

What You Can Do With Image Search Data

छवि खोज दृश्य अनुसंधान, सामग्री खोज और यह समीक्षा करने का समर्थन कर सकती है कि एक विषय सार्वजनिक स्रोतों में कैसे प्रकट होता है। उदाहरण के लिए, एक वास्तुकला शोधकर्ता एक भवन प्रकार के लिए खोज कर सकता है, संबंधित स्रोत पृष्ठों की पहचान कर सकता है, और छवियों और आस-पास के विवरणों की समीक्षा एक साथ कर सकता है।

API आपके अनुप्रयोग को निरीक्षण के लिए खोज डेटा प्रदान करता है। यह स्वचालित रूप से एक एसेट लाइब्रेरी नहीं बनाता है, हर छवि की उत्पत्ति की पुष्टि नहीं करता है, या किसी फ़ाइल को पुनः प्रकाशित करने की अनुमति नहीं देता है। ये कदम उस कार्यप्रणाली में शामिल होते हैं जिसे आप खोज के चारों ओर बनाएँगे।

प्रतिक्रिया के साथ क्वेरी और बाज़ार संदर्भ बनाए रखें। एक देश या भाषा के लिए एक दृश्य अनुसंधान सेट दूसरे से भिन्न हो सकता है। बिना इनपुट रिकॉर्ड के, बाद के समीक्षक यह तय नहीं कर सकते कि किस खोज ने एक उम्मीदवार छवि का उत्पादन किया।

Select Google Images With tbm=isch

POST https://api.scrapeless.com/api/v1/scraper/request का उपयोग करें, x-api-token के साथ प्रमाणित करें, और actor को scraper.google.search पर सेट करें। क्वेरी के बगल में tbm="isch" को input के अंदर डालें।

पैरामीटर संदर्भ इस छवि-खोज चयनकर्ता का दस्तावेज़ीकरण करता है। वही इनपुट मॉडल gl के लिए देश, hl के लिए भाषा, और स्थान नियंत्रणों को शामिल करता है। यदि आपको एक विशेष उत्पत्ति की आवश्यकता है, तो या तो location या uule चुनें।

यदि आप एक पूर्ण url का उपयोग करते हैं, तो अन्य इनपुट पैरामीटर्स को अनदेखा किया जाता है। इसमें एक अलग से आपूर्ति किया गया छवि चयनकर्ता शामिल है। एक इनपुट मोड का उपयोग करें और यह सत्यापित करें कि URL स्वयं इरादे की छवि खोज व्यक्त करता है इससे पहले कि आप इसे भेजें।

Prerequisites for the Capture Script

Python तैयार करें, requests को python3 -m pip install requests के साथ इंस्टॉल करें, और एक Scrapeless API कुंजी को SCRAPELESS_API_KEY के माध्यम से उपलब्ध करें। स्क्रिप्ट को एक स्थानीय JSON फ़ाइल लिखने की अनुमति भी चाहिए। मानक-लाइब्रेरी मॉड्यूलों को सीरियलाइजेशन, टाइमस्टैम्प और पथों को संभालने के लिए आवश्यक है।

प्रमाणित अनुरोध के लिए आपकी अपनी खाता कुंजी की आवश्यकता होती है और इस लेख के लिए एक लाइव खाते के साथ निष्पादित नहीं किया गया है। दस्तावेज़ित अनुरोध आकार की पुष्टि की गई है; एक पूर्ण छवि-प्रतिक्रिया स्कीमा यहां परिभाषित नहीं की गई है। उदाहरण को capture_google_images.py के रूप में सहेजें और कुंजी कॉन्फ़िगर होने पर python3 capture_google_images.py चलाएँ।

Requests HTTP client JSON अनुरोध भेजता है। उदाहरण कैप्चर और संरचनात्मक निरीक्षण के बाद रुक जाती है; यह लंबित कार्य के परिणामों को पुनः प्राप्त नहीं करता है या छवि फ़ाइलें डाउनलोड नहीं करता है।

Capture the Full Response in Python

क्वेरी modern library architecture एक ठोस दृश्य अनुसंधान उदाहरण प्रदान करती है। इसे अपने प्रोजेक्ट से संबंधित एक विषय में बदलें जबकि सहेजे गए रिकॉर्ड में देश, भाषा, और परिणाम-प्रकार सेटिंग्स को बनाए रखें।

import json
import os
from datetime import datetime, timezone
from pathlib import Path

import requests

search_input = {"q": "modern library architecture", "gl": "us", "hl": "en", "tbm": "isch"}
response = requests.post(
    "https://api.scrapeless.com/api/v1/scraper/request",
    headers={"x-api-token": os.environ["SCRAPELESS_API_KEY"]},
    json={"actor": "scraper.google.search", "input": search_input},
    timeout=120,
)
response.raise_for_status()
payload = response.json()
received_at = datetime.now(timezone.utc).isoformat()
run_id = datetime.now(timezone.utc).strftime("%Y%m%dT%H%M%S%fZ")
output = Path(f"google-images-{run_id}.json")
output.write_text(json.dumps({
    "input": search_input, "http_status": response.status_code,
    "received_at": received_at, "response": payload,
}, ensure_ascii=False, indent=2), encoding="utf-8")

if response.status_code == 201:
    print(f"Task pending; inspect taskId in {output}.")
elif response.status_code == 200 and isinstance(payload, dict):
    print(f"Saved {output}. Top-level response fields:")
    for key, value in payload.items():
        print(key, type(value).__name__)
        if isinstance(value, list):
            print("  items:", len(value))
            if value and isinstance(value[0], dict):
                print("  first-item keys:", sorted(value[0]))
else:
    raise ValueError(f"Unexpected response; inspect {output}.")

बाहरी input, http_status, received_at, और response कुंजियां इस एप्लिकेशन के रिकॉर्ड का निर्माण करती हैं। वे लौटाए गए API स्कीमा से अलग हैं। फ़ाइल नाम में एक क्लाइंट-जनित पहचानकर्ता शामिल है, और रसीद का समय स्थानीय मशीन पर रिकॉर्ड किया जाता है।

JSON serialization module पूर्ण नैस्टेड पेलोड को बनाए रखता है। टर्मिनल निरीक्षण शीर्ष-स्तरीय प्रकारों और किसी भी शीर्ष-स्तरीय एरे के लिए पहले-आइटम कुंजियों को सूचीबद्ध करता है। यह एक प्रारंभिक निरीक्षण सहायक है; वस्तुओं के अंदर नेस्टेड एरे में सहेजे गए JSON में अभी भी समीक्षा की आवश्यकता होती है।

Start Scraping with Scrapeless

Scrapeless के साथ अपनी वेब स्क्रैपिंग और स्वचालन कार्यप्रणाली को चालू करें!
आज साइन अप करें और $5 का मुफ़्त क्रेडिट प्राप्त करें — कोई क्रेडिट कार्ड आवश्यक नहीं है।
अब Scrapeless Dashboard में अपना मुफ्त क्रेडिट प्राप्त करें।

समतल करने से पहले छवि फ़ील्ड स्थापित करें

कैप्चर चरण जानबूझकर अनुमानित images_results फ़ील्ड का अनुक्रमण नहीं करता है। वर्तमान छवि अंत बिंदु संदर्भ में वेब-खोज मॉड्यूल के साथ एक प्रतिक्रिया उदाहरण शामिल है, इसलिए यह एक सम्पूर्ण छवि-विशिष्ट मैपिंग स्थापित नहीं करता है। अपने खाते से सफल प्रतिक्रिया का उपयोग करके उन एरे पैथ और आइटम फ़ील्ड की पुष्टि करें जिन्हें आपका एप्लिकेशन उपयोग करेगा।

पहली आइटम को हर रिकॉर्ड का प्रतिनिधित्व मानने के बजाय कई लौटाए गए आइटमों का निरीक्षण करें। ध्यान दें कि कौन से मान वैकल्पिक हैं, कौन से नेस्टेड हैं, और क्या गायब मान अनुपस्थित है या स्पष्ट रूप से नल है। अपने निर्यातक को डिज़ाइन करते समय उन भेदों को बनाए रखें।

निम्नलिखित प्रस्तावित एप्लिकेशन कॉलम हैं, जो दावा किए गए API फ़ील्ड नाम नहीं हैं:

स्रोत पृष्ठ और छवि संसाधन को अलग रखें। वे विभिन्न प्रश्नों का उत्तर देते हैं: एक समीक्षा के लिए संदर्भ प्रदान करता है, जबकि दूसरा छवि बाइट्स की पहचान कर सकता है। एक पूर्वावलोकन को पूर्ण छवि संपत्ति के लिए चुपचाप प्रतिस्थापित नहीं किया जाना चाहिए।

लंबित कार्यों और अप्रत्याशित आकारों को पहचानें

अनुरोध कार्यप्रवाह HTTP 200 को डेटा प्रतिक्रिया और HTTP 201 को taskId के साथ प्रगति में एक कार्य के रूप में परिभाषित करता है। स्क्रिप्ट दोनों को सहेजती है, फिर संरचनात्मक निरीक्षण केवल पूर्ण ऑब्जेक्ट प्रतिक्रिया पर लागू करती है।

एक लंबित कार्य को खाली छवि डेटा सेट में नहीं बदलना चाहिए। इसी प्रकार, यदि प्रतिक्रिया में अपरिचित मॉड्यूल शामिल हैं, तो निर्यातक को खाली कॉलम आविष्कार करने से पहले निरीक्षण करने के लिए प्रेरित करना चाहिए। नैदानिक रिकॉर्ड को संरक्षित करें ताकि अनुरोध और पेलोड को एक साथ समीक्षा की जा सके।

यदि आप फ़िल्टर जोड़ते हैं या खोज मूल में बदलाव करते हैं, तो संग्रह से पहले प्रतिक्रिया के एक छोटे सेट की तुलना करें। खोज प्रकार और फ़िल्टर परिवर्तनों से प्रभावित हो सकता है कि कौन से मॉड्यूल प्रकट होते हैं। इसलिए, सटीक आउटपुट पंक्तियाँ अवलोकन द्वारा स्थापित की जाती हैं, न कि ट्यूटोरियल में एक निश्चित उदाहरण तालिका द्वारा।

छवि संदर्भ और पुन: उपयोग अधिकारों की समीक्षा करें

छवि खोज सामग्री खोजने में मदद करती है, लेकिन यह उस सामग्री के लिए लाइसेंस स्थापित नहीं करती है। उम्मीदवार के स्रोत पृष्ठ का पालन करें और कॉपी, पुनर्वितरित या छवि को संशोधित करने से पहले प्रकाशक की उपयोग शर्तों की जांच करें।

Google का छवि लाइसेंस मेटाडेटा समर्थित छवि-खोज अनुभवों में लाइसेंस और अधिग्रहण जानकारी को उजागर कर सकता है। केवल खोज में उपस्थिति यह साबित नहीं करती है कि वे अनुमतियाँ मौजूद हैं। इसका छवि उपयोग-حقوق मार्गदर्शन बताता है कि स्रोत पर लाइसेंस विवरण की जांच क्यों की जानी चाहिए।

एक अनुसंधान कैटलॉग के लिए, एक अलग समीक्षा स्थिति बनाए रखें जैसे कि अप्रReviewed या अनुमति की पुष्टि की गई, जिसमें स्रोत और समीक्षा के साक्ष्य हों जिनकी आपकी टीम को आवश्यकता है। ये एप्लिकेशन निर्णय हैं, API की गारंटी नहीं। केवल इसलिए कि एक अनुरोध सफल रहा, एक छवि को पुन: उपयोग योग्य का मार्किंग करने से बचें।

खोज को एक समीक्षा योग्य कैटलॉग में विस्तारित करें

उत्तर मैपिंग की पुष्टि करने के बाद, एक छोटा निर्यात करें और इसे सहेजे गए पेलोड के साथ तुलना करें। सुनिश्चित करें कि प्रत्येक स्रोत पृष्ठ उसी उम्मीदवार से संबंधित है जैसे छवि संदर्भ और शीर्षक। फिर निर्णय लें कि आपके उपयोग के मामले के लिए डुप्लिकेट क्या होता है।

दो परिणाम एक ही छवि की ओर विभिन्न पृष्ठों के माध्यम से संकेत कर सकते हैं, या एक समान छवि के विभिन्न संस्करणों की ओर। URL डुप्लिकेशन और दृश्य समानता विभिन्न ऑपरेशन हैं। एक दस्तावेज़ नियम से शुरू करें और रूपांतरण पेश करने से पहले मूल संदर्भों को संरक्षित करें।

यदि आपका एप्लिकेशन बाद में स्रोत पृष्ठों या छवि फ़ाइलों को लाता है, तो इसे अपने स्वयं के परिणाम के साथ एक अलग चरण बनाएं। यह पृथक्करण एक उम्मीदवार को अनुसंधान रिकॉर्ड में बनाए रखने की अनुमति देता है, भले ही बाद में किए गए पुनःप्राप्ति या अनुमति समीक्षा पूरी नहीं हुई हो।

निष्कर्ष

tbm=isch का उपयोग करके छवि खोज का अनुरोध करें, प्रतिक्रिया को बनाए रखें, और निर्यातक बनाने से पहले इसके फ़ील्ड की पुष्टि करें। एक उपयोगी छवि अनुसंधान कार्यप्रवाह स्रोत संदर्भ और अनुमति समीक्षा को खोज के साथ रखता है, ताकि प्रत्येक चयनित संपत्ति का एक पता लगाने योग्य मार्ग इसके मूल तक हो।

क्या आप अपने खोज डेटा कार्यप्रवाह का निर्माण करने के लिए तैयार हैं?

हमारे समुदाय में खोज कार्यप्रवाह बनाने वाले डेवलपर्स के साथ जुड़ें: Discord · Telegram।
Google Search API दस्तावेज़ीकरण का उपयोग करके अपना पहला अनुरोध कॉन्फ़िगर करें। अपने कार्यभार की योजना बनाते समय Scrapeless मूल्य निर्धारण जांचें, और संबंधित पृष्ठभूमि के लिए Python खोज ट्यूटोरियल का उपयोग करें। इस गाइड के API उदाहरण वर्तमान अनुरोध इंटरफ़ेस का उपयोग करते हैं।

FAQ

प्रश्न: क्या Google Images इस उदाहरण में एक अलग अभिनेता है?

नहीं। इस प्रलेखित अनुरोध में scraper.google.search का उपयोग होता है और इनपुट में tbm=isch होता है।

प्रश्न: क्या कोड चित्र फ़ाइलें डाउनलोड करता है?

नहीं। यह खोज डेटा को कैप्चर करता है और इसके संरचना का निरीक्षण करता है। एक चित्र डाउनलोड करना एक अलग एप्लिकेशन चरण होगा।

प्रश्न: क्या वेब-शोध जैविक-परिणाम मैपिंग को बिना बदलाव के फिर से उपयोग किया जा सकता है?

ऐसा मानने की गलती न करें। वास्तविक चित्र-शोध डेटा का निरीक्षण करें और पहले संबंधित ऐरे पथ और आइटम फ़ील्ड की पुष्टि करें।

प्रश्न: स्थिर छवि JSON नमूना क्यों नहीं है?

वर्तमान संदर्भ उदाहरण एक संपूर्ण छवि-विशिष्ट स्कीमा स्थापित नहीं करता है। यह गाइड एक कैप्चर कार्यप्रवाह प्रदान करता है बिना वास्तविक आउटपुट के रूप में एक उचित प्रतिक्रिया प्रस्तुत किए।

प्रश्न: क्या एक लौटाई गई छवि का पुन: उपयोग करने का लाइसेंस है?

खोज उपस्थिति पुन: उपयोग के अधिकारों की स्थापना नहीं करती है। छवि का उपयोग करने से पहले स्रोत पृष्ठ और लागू लाइसेंस या अनुमति की समीक्षा करें।