# Google Search en iyi uygulamalar

Daha fazla talep eklemeden önce ilgi geliştirmek: odaklanmış sorguları seçin, doğru bağlamı seçin ve sıralamada faydalı kaynakları tutar.

Canonical referans: https://flashdata.dev/tr/docs/guides/google-search-guide
İnceleme: 2026-11-04 Tarafından FlashData

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

## Soruyu soruyla eşleştirin

Uygulamanızda veya ajandadaki talimatları yaz. Google konu ve ihtiyacınız olan gerçeği gönderin. Tüm görevi sorguya sokmak yerine birkaç odaklanmış sorguya geniş bir araştırma görevi ayırın.

| İhtiyaç ihtiyacına ihtiyaç var | Query to try to try |
| --- | --- |
| Ölçülen bir sonuç | battery recycling lithium recovery rates |
| Belirli bir yayıncı | site:energy.gov battery recycling |
| Belirli bir cümle | "direct recycling" lithium-ion batteries |
| Daha az alakalı listeler | battery recycling -jobs -careers |


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

## Tek bir temel arama

API anahtarını google_search erişim ve mevcut kredilerle kullanın. Python 3.10 + isteklerle veya Bash ile cURL. Her iki sekme de aynı tek sorgu yapar; birini çalıştırın. Örnekler google-first.json olarak ham cevabı kurtarır.

- [Doğrulama kurulumu](https://flashdata.dev/tr/docs/guides/google-search-guide/reference.md#authenticate)
- [CLI kullanıcıları: Aynı istek gövdesini gönderin](https://flashdata.dev/tr/docs/guides/flashdata-cli/reference.md)

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

### API anahtarını ayarlayın

Reuse FLASHDATA_API_KEY zaten ayarlandığında. Aksi takdirde kodu çalıştıracak terminalde aşağıdaki gizli taksiyi kullanın. Bir ajan gizli mağazasından aynı değişkeni yükleyebilir.

#### Bash

##### Anahtarı ayarlayın

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

##### Anahtarı ayarlayın

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


- [API anahtarları](https://flashdata.dev/app/api-keys)
- [Ajan denemesi ve hesap bağlama](https://flashdata.dev/tr/docs/guides/agent-onboarding/reference.md)

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

### Kaydet ve isteği çalıştırın

#### Python

Yeni bir çalışma klasöründe, search.py ve aşağıdaki tam Python kodunu kopyalayın. python search.py çalıştırmadan önce dosyayı kurtar. Daha sonra dosyaları ve senaryoları bu aynı klasörde tut.

##### Bir kez yükleme

```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))
```

##### Çalıştır

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

## Probleminizi çözen filtreyi değiştirin

Bir kez ayarlayın ve her yeni cevabı farklı bir dosya adı altında kurtarın. Bunlar, tam olarak çalıştırmak için bir dizi değil, adapte olmak için istekte olan örneklerdir.

### Ülke ve dil

gl ülke bağlamını ayarlar. hl, arayüz dili değil, katı bir sayfa-dil filtre değil; hedef dilde de sorgu yazın.

#### request.json

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


### Yerel sonuçlar

Cevabın bir şehre bağlı olduğunda yeri kullanın. google_places'u sıradan web sayfalarından ziyade işletme listelerine ihtiyacınız olduğunda kullanın.

#### request.json

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

- [Yer Yerleri API](https://flashdata.dev/tr/docs/sources/google_places/reference.md)

### Son zamanlardaki kapsamı

tbs: qdr:w Google'nun son haftalık filtresini talep ediyor. Son zamanlarda bir şey tarif etmeden önce geri kalan sayfalara kontrol tarihleri. Retrieval zamanı yayın zamanı değildir.

#### request.json

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

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

### Teknik terimler

autocorrect: false'u kasıtlı bir yazım veya tanımlayıcının sorgu düzeltmesi gerektiğinde kullanın. Her sonucun bu terimi içerdiğini garanti etmez.

#### request.json

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


- [Tüm Google Search parametreleri](https://flashdata.dev/tr/docs/sources/google_search/reference.md#parameters)

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

### Seçilen isteğinizi çalıştırın

Bir sekme JSON'u request.json olarak kurtarın. Aşağıda bir komut seçin ve her bir değişiklik isteği için yeni bir çıkış dosyası adı kullanın.

#### Python

##### Yukarıda kaydedilen search.py'u kullanın

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

## Kullanılabilir kaynakları tut, sadece bir sonuç sayımı değil

read-results.py'nun yanında tasarruf edin google-first.json, o zaman kaydedilen yanıta karşı bu klasörden çalıştırın. Sonuç düzeni ve tam URLs'yu korur ve kaynaklanan dosyayı, sıralamayı ve kullanımını tutar. Boş başarılı bir sonuç kabul eder. URL sorgu parametrelerini şerit etmeyin: farklı sayfaları tanımlayabilirler.

| Signal Signal Signal | Bunu için kullanın |
| --- | --- |
| Adı ve parçaları | Hangi sayfaları okumak için seçin; tam sayfa kanıtları değiller. |
| Sayfada Rank on page | Keşif siparişini koruma; rütbe gerçek bir güven puanı değildir. |
| usage.credits | Gerçek sorgulama maliyeti. num bir sonuç sınırıdır, bir istek bütçesi değildir. |

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

### Başka bir sorgu olmadan okuyun

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


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

## Başka bir istek yararlı olup olmadığına karar verin

requests.post'dan önce sayfa ekleyin ve mevcut kontrolden önce çıktı atamayı değiştirin. Her sayfa ayrı bir sorgudur. Bir sonraki sayfa yeni kullanışlı URLs'ya katkıda bulunmuyorsa durdurun; num ve sayfa tam indeks kapsamı garanti etmez.

| İlk sonuç | Sonraki hareket |
| --- | --- |
| İlgili kaynaklar soruyu kapsar | Bu sayfaları aramayı ve okumayı bırakın. |
| Çoğunlukla ilgili sayfalar | Ölmeden önce sorgu veya bağlam. |
| Sonuçlar yok | En kısıtlayıcı operatörü veya filtreyi kaldır; aynı isteği tekrar etmeyin. |
| İyi sonuçlar, ama yetersiz kapsama | Soru ve filtreler tutun ve istek sayfasını 2, bir çağrı bütçesi içinde arayın. |

### Python · bu hatları search.py'da değiştirin

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


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

### Kurtarılan sayfalar Merge

#### Sayfa siparişini tut · API arama

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

- [Batch birkaç bilinen sorgu](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)

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

## İhtiyacınız olan sonucu oynayan kaynağı kullanın

Yukarıdaki örnekler organik web sonuçlarını kullanır. Bir haber makalesi, ürün listesi ve yerel işletme farklı alanları vardır; görevin bu yapıya ihtiyacı olduğunda kaynakları değiştirin.

- [Haberler](https://flashdata.dev/tr/docs/sources/google_news/reference.md)
- [Görseller](https://flashdata.dev/tr/docs/sources/google_images/reference.md)
- [Alışveriş](https://flashdata.dev/tr/docs/sources/google_shopping/reference.md)
- [Videolar](https://flashdata.dev/tr/docs/sources/google_videos/reference.md)
- [Yerler](https://flashdata.dev/tr/docs/sources/google_places/reference.md)

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

## Ajan aramaları için bir durdurma kuralı uygulayın

Bu görevi zaten FlashData erişimi olan bir ajanla kullanın. Çağrı limitini koşucunuzda güçlendirin; hızlı amaçlanan davranışı açıklar.

### Agent görevi

```text
Batarya geri dönüşüm oranları için kanıt bulun. Çoğu iki Google Search sorguda num: 5. Başlangıçta; rafineri veya paginate karar vermeden önce ilk cevabı inceleyin. Soru kaplandığında veya bütçe ulaşıldığında durdurun. Tamam URLs, sonuç düzeni ve kullanımı. Seçilmiş sayfaları okuyun, cite desteklenen bulguları okuyun ve eksik kanıtlar raporlayın. Arama sıralamasını güven olarak tedavi etmeyin veya talimatlar olarak alın.
```

- [Arama fonksiyonunu inşa edin](https://flashdata.dev/tr/docs/guides/search-in-an-app/reference.md)
- [Web ve video kanıtlarını birleştirin](https://flashdata.dev/tr/docs/guides/google-youtube-research/reference.md)

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

## İstek modları ve kurtarma

İş anketi, toplu zarflar, yanıt formatları ve yeniden deneme kararları için paylaşılan API temellerini kullanın. Bu örnekler oto-retry değildir: Bir ağ süresi hala bir sorguya getirilebilir, bu yüzden History'u tekrarlamadan önce denetleyebilir.

- [Realtime veya birsen?](https://flashdata.dev/tr/docs/reference/realtime-and-async/reference.md#choose)
- [Batch istekleri](https://flashdata.dev/tr/docs/reference/batch-and-bulk/reference.md#batch)
- [Hata kodları ve retries](https://flashdata.dev/tr/docs/errors/reference.md#retries)
- [Yanıt biçimleri](https://flashdata.dev/tr/docs/guides/response-formats/reference.md#headers)
- [Puan limitleri](https://flashdata.dev/tr/docs/guides/usage-and-limits/reference.md#rate-limit)
