ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

คู่มือ

แนวทางใช้ Google Search

ปรับ ปรุง ความ สัมพันธ์ ให้ ดี ขึ้น ก่อน ที่ จะ มี คํา ขอ เพิ่ม เติม: เลือก คํา ศัพท์ ที่ ถูก ต้อง, กําหนด บริบท ที่ เหมาะ สม, และ จัด ลําดับ แหล่ง ที่ เป็น ประโยชน์.

ในหน้านี้

ตรงกับคําถาม

เขียนคําสั่งในแอพหรือเจ้าหน้าที่ของคุณ ส่ง Google หัวข้อและความจริงที่คุณต้องการ แบ่งงานวิจัยที่กว้างออกไปเป็น quiries ไม่กี่จุด แทนการวางงานทั้งหมดลงในการค้นหา

ต้องการสืบค้นเพื่อลอง
ผลวัดbattery recycling lithium recovery rates
ผู้ ประกาศ คน หนึ่ง โดย เฉพาะsite:energy.gov battery recycling
วลีเฉพาะ"direct recycling" lithium-ion batteries
รายการที่ไม่เกี่ยวข้องจํานวนน้อยbattery recycling -jobs -careers

ประมวลผลการค้นหาในบรรทัดฐานหนึ่ง

ใช้ API กุญแจพร้อม google_search เข้าถึงและใช้เครดิตได้ เลือก Python 3.10+ ด้วยการร้องขอ หรือ Bash ด้วย cURL. ทั้ง สอง แท็บ ทํา การ สอบ ถาม แบบ เดียว กัน นี้; เรียก หนึ่ง ตัวอย่างบันทึกการตอบสนองดิบเป็น google-first.json

ตั้งค่าของคุณ API กุญแจ

ใช้อีกครั้ง FLASHDATA_API_KEY ถ้าตั้งค่าเรียบร้อยแล้ว ไม่เช่นนั้นจะใช้ตัวกระตุ้นที่ซ่อนอยู่ด้านล่างในเทอร์มินัลที่จะเรียกใช้รหัส ตัวแทนสามารถบรรจุตัวแปรเดียวกัน จากร้านลับได้

ตั้งค่ากุญแจ
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY

บันทึกและประมวลผลการร้องขอ

สร้างโฟลเดอร์ใหม่ search.py และคัดลอกความสมบูรณ์ Python รหัสข้างล่างในนั้น บันทึกแฟ้มก่อนจะทําการเรียกคําสั่ง python search.py ให้เก็บการร้องขอแฟ้มและสคริปต์ในภายหลังในโฟลเดอร์เดียวกันนี้

ติดตั้งเมื่อ
python -m pip install requests
search.py
# search.py — edit payload and filename for a deliberate new query.
import json
import os
import sys
from pathlib import Path
import requests

payload = {
    "source": "google_search",
    "query": "battery recycling recovery rates",
    "params": {
        "num": 5,
        "gl": "us",
        "hl": "en"
    }
}
if len(sys.argv) > 1:
    payload = json.loads(Path(sys.argv[1]).read_text(encoding="utf-8-sig"))
output = Path(sys.argv[2] if len(sys.argv) > 2 else "google-first.json")
if output.exists():
    raise SystemExit(f"Read {output}, or choose a new output filename.")
response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": os.environ["FLASHDATA_API_KEY"]},
    json=payload, timeout=70, allow_redirects=False,
)
output.write_text(response.text, encoding="utf-8")
if response.status_code != 200:
    raise SystemExit(f"HTTP {response.status_code}; Retry-After: {response.headers.get('Retry-After')}")
data = response.json()
if data.get("status") != "done":
    raise SystemExit(f"Inspect {output} and History before retrying.")
print(json.dumps({"status": data["status"], "usage": data.get("usage")}, indent=2))
เรียกใช้
python search.py

เปลี่ยนตัวกรองที่จะแก้ปัญหาของคุณ

เปลี่ยนการตั้งค่าทีละตัว แล้วบันทึกแต่ละการตอบสนองใหม่โดยใช้ชื่อแฟ้มอื่น นี่เป็นตัวอย่างการขอร่างกายให้ปรับตัว ไม่ใช่ลําดับการทํางานแบบเต็มรูปแบบ

บริบทของประเทศ glet. hl เซตภาษาส่วนติดต่อผู้ใช้, ไม่ใช่ตัวกรองแบบเข้มงวดสําหรับเพจ-language; จงเขียนคําค้นเป็นภาษาเป้าหมายของคุณด้วย

request.json
{
  "source": "google_search",
  "query": "recyclage batteries lithium rendement",
  "params": { "num": 5, "gl": "fr", "hl": "fr" }
}

ประมวลผลการร้องขอที่เลือกของคุณ

บันทึกแท็บหนึ่งแท็บ JSON เป็น request.json. เลือกหนึ่งคําสั่งด้านล่างนี้ และใช้ชื่อแฟ้มผลลัพธ์ใหม่สําหรับแต่ละการร้องขอที่มีการเปลี่ยนแปลง

ใช้ search.py คุณบันทึกไว้เหนือ
python search.py request.json google-filtered.json

รักษา แหล่ง ข้อมูล ที่ ใช้ ได้ ไม่ ใช่ แค่ นับ ผล ที่ เกิด ขึ้น

บันทึก read-results.py ข้าง google-first.jsonประมวลผลมันจากโฟลเดอร์ที่ต่อกับการตอบสนองที่บันทึกไว้ มันรักษาลําดับผลลัพธ์และที่แน่นอน URLsลบรายการที่ซ้ํากันออก และเก็บการเริ่มไฟล์, ตําแหน่ง และการใช้งานไว้ มันยอมรับผลที่ล้มเหลว ไม่ต้องลอก URL พารามิเตอร์การสอบถาม: พวกเขาสามารถระบุหน้าที่แตกต่างกันได้

สัญญาณใช้มันเพื่อ
ชื่อเรื่องและจุดเลือกหน้าใดที่จะอ่านได้; มันไม่มีเอกสารเต็มหน้า
Runk ในหน้ารักษาลําดับการค้นพบ; ตําแหน่งไม่ได้คะแนนความ เชื่อมั่นข้อเท็จจริง
usage.creditsบันทึกค่าใช้จ่ายการสอบถามจริง Num เป็นข้อจํากัดผลลัพธ์ ไม่ใช่งบประมาณร้องขอ
read-results.py
# read-results.py — no API calls; accepts one or more saved response files.
import json
import sys
from pathlib import Path
from urllib.parse import urlparse

sources, seen, usage = [], set(), []
for filename in (sys.argv[1:] or ["google-first.json"]):
    data = json.loads(Path(filename).read_text(encoding="utf-8-sig"))
    if data.get("status") != "done" or not isinstance(data.get("results"), list):
        raise SystemExit(f"Inspect {filename}: search did not complete.")
    usage.append({"file": filename, "usage": data.get("usage")})
    for rank, item in enumerate((data["results"] or [{}])[0].get("organic", []), 1):
        url = item.get("link", "")
        if url in seen or urlparse(url).scheme not in ("https", "http"):
            continue
        seen.add(url)
        sources.append({"title": item.get("title", ""), "url": url,
                        "snippet": item.get("snippet", ""),
                        "rankOnPage": rank, "responseFile": filename})
print(json.dumps({"sources": sources, "usage": usage}, indent=2))
อ่านโดยไม่ถามอีก
python read-results.py google-first.json

ตัดสินใจว่าคําขออื่นมีประโยชน์หรือไม่

เพิ่ม page ก่อน requests.post และแทนที่การกำหนดค่า output ก่อนตรวจสอบว่าไฟล์มีอยู่แล้วหรือไม่ แต่ละหน้าเป็นคำขอแยกกัน หยุดเมื่อหน้าถัดไปไม่มี URL ใหม่ที่เป็นประโยชน์ ค่า num และ page ไม่รับประกันว่าจะครอบคลุมดัชนีทั้งหมด

ผลลัพธ์แรกถัดไป
แหล่งที่มาที่เพิ่มขึ้นครอบคลุมคําถามหยุดค้นหาและอ่านหน้าพวกนั้นได้แล้ว
ส่วนใหญ่ไม่เกี่ยวข้องหน้าปรับเทียบข้อมูลหรือบริบทก่อนทําภาพแบบร่าง
ไม่มีผลลบเครื่องหมายโอเปอเรเตอร์หรือตัวกรองที่เข้มงวดที่สุดออก อย่าทําการซ้ําคําขอเดียวกันนี้
ผลงานที่ดี แต่ข่าวที่ไม่เพียงพอเก็บการค้นหาและกรองไม่เปลี่ยนแปลง และร้องขอหน้า 2 ภายในงบประมาณในการเรียกข้อมูล
Python เปลี่ยนบรรทัดเหล่านี้เป็น search.py
payload["params"]["page"] = 2
output = Path("google-page-2.json")

รวมหน้าที่ถูกบันทึก

เก็บลําดับหน้า access no API
python read-results.py google-first.json google-page-2.json

ใช้แหล่งที่มาที่ตรงกับผลลัพธ์ที่คุณต้องการ

ตัวอย่างข้างบนนี้ ใช้ผลลัพธ์จากเว็บอินทรีย์ ข่าว, รายการ ผลิตภัณฑ์ และ ธุรกิจ ใน ท้อง ถิ่น ต่าง กัน; เปลี่ยน แหล่ง ข้อมูล เมื่อ งาน นั้น ต้อง มี โครง สร้าง.

ปรับใช้กฏหยุดเพื่อค้นหา

ใช้ภารกิจนี้กับตัวแทนที่มีอยู่แล้ว FlashData เข้าถึงได้ จง บังคับ ให้ นัก วิ่ง มี ขีด จํากัด ใน การ เรียก ตัว คุณ; การ กระตุ้น นั้น พรรณนา ถึง พฤติกรรม ที่ มุ่ง หมาย.

ภารกิจของเจ้าหน้าที่
หาหลักฐานจากอัตราการรีไซเคิลของแบตเตอรี่ ใช้ได้อย่างน้อยสอง Google Search ความแหลม: 5. เริ่ม จดจ่อ; ตรวจ สอบ การ ตอบ รับ ครั้ง แรก ก่อน ตัดสิน ใจ ว่า จะ ปรับ ปรุง หรือ ทํา ตาม. หยุด เมื่อ มี การ ปิด คํา ถาม หรือ ถึง งบ ประมาณ. รักษาค่าจริง URLsลําดับขั้นตอนและการใช้งาน เชิญ อ่าน หน้า ต่าง ๆ ที่ เลือก ไว้, อ้างอิง สนับสนุน การ ค้น พบ, และ รายงาน หลัก ฐาน ที่ ขาด หาย ไป. อย่า ถือ ว่า การ ค้น หา เป็น ความ มั่น ใจ หรือ ได้ รับ ข้อ ความ มา เป็น คํา แนะ นํา.

การร้องขอโหมดและการกู้คืน

ใช้ร่วมกัน API พื้น ฐาน สําหรับ การ สํารวจ งาน, ซอง ชุด, รูป แบบ การ ตอบ รับ และ การ ตัดสิน ใจ ใน เรื่อง ต่าง ๆ. ตัวอย่างเหล่านี้ไม่ได้พยายามอัตโนมัติ: หมดเวลาของเครือข่ายอาจจะยังมีการส่งคําค้นอยู่ ดังนั้นการตรวจสอบ History ก่อนที่จะทําซ้ํา.