# 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.

Tài liệu tham khảo chính điển: https://flashdata.dev/vi/docs/guides/google-search-guide
Xem lại: 2026-11-04 by FlashData

<a id="query-patterns"></a>

## 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ần | Truy vấn để thử |
| --- | --- |
| Kết quả đo | battery recycling lithium recovery rates |
| Một nhà xuất bản đặc biệt | site: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ợp | battery recycling -jobs -careers |


<a id="setup"></a>

## 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.

- [Thiết lập xác thực](https://flashdata.dev/vi/docs/guides/google-search-guide/reference.md#authenticate)
- [CLI Người dùng:](https://flashdata.dev/vi/docs/guides/flashdata-cli/reference.md)

<a id="authenticate"></a>

### Đặ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ó.

#### Bash

##### Đặt phím

```bash
# 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
```


#### PowerShell 7

##### Đặt phím

```powershell
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey
```


- [Phím API](https://flashdata.dev/app/api-keys)
- [Dùng thử tác nhân và liên kết tài khoản](https://flashdata.dev/vi/docs/guides/agent-onboarding/reference.md)

<a id="first-search"></a>

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

#### Python

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

```bash
python -m pip install requests
```

##### search.py

```python
# 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

```bash
python search.py
```


#### cURL

##### Bash

```bash
# Bash; FLASHDATA_API_KEY must be set. Run one language tab, not both.
(
set -eu
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
test ! -e google-first.json || { echo 'Read google-first.json first'; exit 1; }
curl --fail-with-body --silent --show-error --max-time 70 \
  --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data '{"source":"google_search","query":"battery recycling recovery rates","params":{"num":5,"gl":"us","hl":"en"}}' \
  --output google-first.json
)
```



<a id="context"></a>

## 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 đủ.

### Quốc gia và Ngôn ngữ

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

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


### Kết quả cục bộ

Dùng địa điểm khi câu trả lời tùy thuộc vào một thành phố. Dùng google_places khi bạn cần danh sách kinh doanh hơn là thường trang web.

#### request.json

```json
{
  "source": "google_search",
  "query": "battery recycling companies",
  "params": { "num": 5, "gl": "us", "hl": "en",
    "location": "Austin, Texas, United States" }
}
```

- [Nơi API](https://flashdata.dev/vi/docs/sources/google_places/reference.md)

### Tin tức gần đây

tbs: yêu cầu qdr:w GoogleBộ lọc trong tuần qua. Kiểm tra ngày tháng trên các trang đã gửi về trước khi mô tả một điều gì đó gần đây. Thời gian thu hồi không phải là thời gian xuất bản.

#### request.json

```json
{
  "source": "google_search",
  "query": "battery recycling pilot plant",
  "params": { "num": 5, "tbs": "qdr:w" }
}
```

- [News API](https://flashdata.dev/vi/docs/sources/google_news/reference.md)

### Điều kiện kỹ thuật

Dùng autocorrect: false Khi một lỗi chính tả hoặc nhận diện cố ý phải tồn tại sau khi sửa chữa truy vấn. Kinh Thánh không bảo đảm mọi kết quả đều có từ này.

#### request.json

```json
{
  "source": "google_search",
  "query": "\"LiFePO4\" direct recycling",
  "params": {
    "num": 5,
    "autocorrect": false
  }
}
```


- [Tất cả Google Search Tham số](https://flashdata.dev/vi/docs/sources/google_search/reference.md#parameters)

<a id="apply-filter"></a>

### 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.

#### Python

##### Sử dụng search.py Anh đã để dành trên kia

```bash
python search.py request.json google-filtered.json
```


#### cURL

##### Bash

```bash
curl --fail-with-body --silent --show-error --max-time 70 \
  --request POST 'https://data.flashdata.dev/v1/queries/realtime' \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-binary @request.json --output google-filtered.json
```



<a id="results"></a>

## 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ệu | Dùng nó đi |
| --- | --- |
| Tựa và trích | Chọn những trang cần đọc; chúng không phải là bằng chứng đầy đủ trang. |
| Rank nơi trang | Bả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.credits | Thu 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

```python
# 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

```bash
python read-results.py google-first.json
```


<a id="pagination"></a>

## 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ên | Bướ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 quan | Truy 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ức | Giữ 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

```python
payload["params"]["page"] = 2
output = Path("google-page-2.json")
```


<a id="merge-pages"></a>

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

#### Theo thứ tự trang #% 1 API cuộc gọi

```bash
python read-results.py google-first.json google-page-2.json
```

- [Batch Một số truy vấn đã biết](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch)

<a id="choose"></a>

## 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.

- [Tin tức](https://flashdata.dev/vi/docs/sources/google_news/reference.md)
- [Hình ảnh](https://flashdata.dev/vi/docs/sources/google_images/reference.md)
- [Mua sắm](https://flashdata.dev/vi/docs/sources/google_shopping/reference.md)
- [Video](https://flashdata.dev/vi/docs/sources/google_videos/reference.md)
- [Địa điểm](https://flashdata.dev/vi/docs/sources/google_places/reference.md)

<a id="agent"></a>

## Á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

```text
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.
```

- [Xây dựng hàm tìm kiếm](https://flashdata.dev/vi/docs/guides/search-in-an-app/reference.md)
- [Kết hợp web và bằng chứng video](https://flashdata.dev/vi/docs/guides/google-youtube-research/reference.md)

<a id="operations"></a>

## 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.

- [Realtime hay định kỳ?](https://flashdata.dev/vi/docs/reference/realtime-and-async/reference.md#choose)
- [Yêu cầu theo lô](https://flashdata.dev/vi/docs/reference/batch-and-bulk/reference.md#batch)
- [Mã lỗi và trả lại](https://flashdata.dev/vi/docs/errors/reference.md#retries)
- [Định dạng phản hồi](https://flashdata.dev/vi/docs/guides/response-formats/reference.md#headers)
- [Giới hạn](https://flashdata.dev/vi/docs/guides/usage-and-limits/reference.md#rate-limit)
