Chuyển đến nội dung
VI
Lấy khóa API
Duyệt tài liệu

Hướng dẫn

Google Search Thực hành tốt nhất

cải thiện sự liên quan trước khi thêm yêu cầu: chọn các yêu cầu tập trung, đặt đúng ngữ cảnh, và giữ các nguồn hữu ích xếp hạng.

Trên trang này

Khớp yêu cầu cho câu hỏi

Cứ ghi hướng dẫn trong ứng dụng hay tác nhân của bạn. Gởi Google chủ đề và thực tế mà anh cần. Chia một nhiệm vụ nghiên cứu rộng thành một vài yêu cầu tập trung thay vì dán toàn bộ nhiệm vụ vào truy vấn.

CầnTruy vấn để thử
Kết quả đobattery recycling lithium recovery rates
Một nhà xuất bản đặc biệtsite:energy.gov battery recycling
Một đoạn văn cụ thể"direct recycling" lithium-ion batteries
Những danh sách không thích hợpbattery recycling -jobs -careers

Chạy Tìm kiếm cơ bản

Dùng a API phím với google_search Truy cập và tín dụng có sẵn. Chọn Python 3.10+ với yêu cầu, hoặc Bash có cURL. Cả hai trang đều có cùng một yêu cầu; chạy một. Các ví dụ tiết kiệm các phản ứng thô như google-first.json.

Đặt khóa API

Dùng lại FLASHDATA_API_KEY nếu đã cài đặt. Nếu không, hãy dùng dấu nhắc ẩn bên dưới trong thiết bị cuối để chạy mã. Một tác nhân có thể tải cùng một biến số từ cửa hàng bí mật của nó.

Đặt phím
# 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

Lưu và chạy yêu cầu

Trong một thư mục làm việc mới, hãy tạo search.py và sao chép toàn bộ Python Mật mã bên dưới nó. Lưu tập tin trước khi chạy python search.py. Giữ tập tin yêu cầu sau và tập lệnh trong cùng thư mục này.

Cài đặt một
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))
Chạy
python search.py

Thay đổi bộ lọc giải quyết vấn đề của bạn

Thay đổi một cài đặt cùng một lúc và lưu mỗi phản ứng mới với tên tập tin khác nhau. Đây là những ví dụ về thân thể yêu cầu để thích nghi, không phải là một chuỗi để chạy đầy đủ.

gl đặt bối cảnh quốc gia. hl đặt ngôn ngữ giao diện, không phải một bộ lọc từ khoá nghiêm ngặt trang; hãy ghi yêu cầu trong ngôn ngữ đích của bạn.

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

Chạy yêu cầu đã chọn của bạn

Lưu một thẻ JSON dạng request.json. Chọn một lệnh bên dưới và dùng tên tập tin xuất mới cho mỗi yêu cầu đã thay đổi.

Sử dụng search.py Anh đã để dành trên kia
python search.py request.json google-filtered.json

Giữ các nguồn có thể sử dụng được, không chỉ đếm được kết quả

Lưu read-results.py bên cạnh google-first.jsonSau đó, chạy nó từ thư mục đó để chống lại phản ứng đã được lưu. Nó bảo tồn trật tự và chính xác URLsgỡ bỏ bản sao, và giữ lại tập tin gốc, cấp bậc và sử dụng. Nó chấp nhận một kết quả không có kết quả. Đừng cởi ra URL Tham số truy vấn: họ có thể xác định trang khác nhau.

Tín hiệuDùng nó đi
Tựa và tríchChọn những trang cần đọc; chúng không phải là bằng chứng đầy đủ trang.
Rank nơi trangBảo tồn trật tự khám phá; cấp bậc không phải là điểm tin tưởng thực tế.
usage.creditsThu chi phí truy vấn thực sự. num là giới hạn kết quả, không phải ngân sách yêu cầu.
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))
Đọc mà không truy vấn khác
python read-results.py google-first.json

Quyết định nếu một yêu cầu khác là hữu ích

Thêm trang trước requests.post và thay thế tác vụ xuất trước khi kiểm tra sự tồn tại. Mỗi trang là một yêu cầu riêng biệt. Dừng nếu trang tiếp theo không có ích gì URLs; num and page không đảm bảo toàn bộ chỉ số.

Kết quả đầu tiênBước tiếp theo
Nguồn cung cấp điều kiện để trả lời câu hỏiĐừng tìm kiếm và đọc những trang đó nữa.
Phần lớn trang không liên quanTruy vấn hoặc ngữ cảnh tốt trước khi tưởng tượng.
Không có kết quảLoại bỏ những nhà điều hành hay bộ lọc hạn chế nhất; không lặp lại yêu cầu giống hệt nhau.
Kết quả tốt, nhưng không đủ tin tứcGiữ cho truy vấn và lọc không thay đổi và yêu cầu trang 2Trong ngân sách cuộc gọi.
Python · Thay đổi dòng này trong search.py
payload["params"]["page"] = 2
output = Path("google-page-2.json")

Trộn các trang đã lưu

Theo thứ tự trang #% 1 API cuộc gọi
python read-results.py google-first.json google-page-2.json

Sử dụng nguồn phù hợp với kết quả bạn cần

Những ví dụ trên sử dụng kết quả web hữu cơ. Một bài báo, danh sách sản phẩm và doanh nghiệp địa phương có nhiều lĩnh vực khác nhau; chuyển đổi nguồn tài liệu khi công việc cần thiết.

Áp dụng quy tắc dừng vào tìm kiếm tác vụ

Sử dụng nhiệm vụ này với một tác nhân đã có FlashData Tiếp cận. Hãy hạn chế sự gọi, nhắc nhở diễn tả hành vi đã định.

Nhiệm vụ tác nhân
Tìm bằng chứng về tỷ lệ tái sử dụng pin. Dùng tối đa là hai. Google Search Các yêu cầu số: 5. Bắt đầu tập trung; kiểm tra phản ứng đầu tiên trước khi quyết định nên tinh luyện hay tinh luyện. Hãy ngưng khi câu hỏi được trả lời hoặc ngân sách được hoàn tất. Bảo tồn URLs, kết quả là trật tự và sử dụng. Hãy đọc những trang đã chọn, nêu ra những phát hiện được hỗ trợ và báo cáo thiếu bằng chứng. Đừng xem việc tìm kiếm như là sự tự tin hay là chỉ dẫn để lấy lại văn bản.

Yêu cầu chế độ và phục hồi

Dùng chia sẻ API Những thứ cơ bản cho việc thăm dò công việc, phong bì hàng loạt, định dạng phản ứng và những quyết định thử lại. Những ví dụ này không thử tự động: thời hạn mạng có thể vẫn đã gửi một truy vấn, vì vậy thanh tra History Trước khi lặp lại.