Belgeleri incele
Başlarken
Bir istek için geçerlidir, bir senaryodan çalıştırın ve ayrı bir sonuç ve hata makbuzlarını okuyun.
Bu sayfada
1. Mevcut profili seçin
CLI, Bash ve jq'u kullanın. Windows, Git Bash'daki kabuk örneklerini çalıştırın. Bu yürüyüş, özgün bir araştırma profili kullanır; FLASHDATA_STATE_DIR'u bu profilin saklandığı mutlak diziye ayarlayın.
Aynı OS kullanıcısını ve eyalet dizilerini her komutta kullanın. FLASHDATA_API_KEY, kurtarılan anahtarı abartır; profili kullanmaya başlamaz. CLI, .env dosyaları yüklemez.
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata auth status --profile research --state-dir "$FLASHDATA_STATE_DIR" --jsonVarsayılan devlet yerleri lokasyonları
Orijinal --state-dir'larınızı özel bir yer seçtiyseniz kullanın. auth status'u rapor etmeli data.accessVerified: true. Önleyici bir dağıtım için, sahibinin anahtarını stdin aracılığıyla gizli mağazasından ithal edin.
| OS | Directory |
|---|---|
| Windows | %APPDATA%/FlashData |
| macOS | ~/Library/Application Support/FlashData |
| Linux | $XDG_STATE_HOME/flashdata veya ~/.local/state/flashdata |
2. İstek ve fiyat doğrulama
request.json'u kurtarın, o zaman aynı dizide ücretsiz çekleri çalıştırın. Filtre baskıları true sadece bir kaynak fiyatı mevcut olduğunda ve denge bir sorguyu kapsar. Bir nonzero çıkışına durdurun. Bir fiyat kontrolü kredi rezervu etmez.
{
"source": "google_search",
"query": "battery recycling research",
"params": {
"num": 5
}
}set -euo pipefail
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
flashdata account balance --profile research --state-dir "$FLASHDATA_STATE_DIR" \
--json --non-interactive > balance.json
flashdata query --input request.json --dry-run --run-id cli-research-001 \
--profile research --state-dir "$FLASHDATA_STATE_DIR" \
--json --non-interactive > preflight.json
jq -e --slurpfile balance balance.json '
.ok and .data.dryRun and .data.estimateAvailable
and ($balance[0].ok == true)
and any(.data.estimate.prices[]?;
.source == "google_search" and .available == true
and (.estimatedCredits | type == "number")
and ($balance[0].data.availableCredits | type == "number")
and .estimatedCredits <= $balance[0].data.availableCredits)
' preflight.json3. Run ve makbuz oku
Kontroller geçtikten sonra run-search.sh'u kurtarın ve bash run-search.sh çalıştırın. İlk başarılı infaz tek bir arama sunar. Her girişim, dosyaları yeni bir cli-run rehberinde kurtarır; stabil run ID, CLI'nun aynı hesap, profil ve eyalet rehberi için daha erken bir başarı kaydetmesine izin verir.
#!/usr/bin/env bash
set -euo pipefail
umask 077
: "${FLASHDATA_STATE_DIR:?Set the existing absolute state directory}"
dir=$(mktemp -d "cli-run.XXXXXX")
if ! flashdata query --input request.json --run-id cli-research-001 \
--profile research --state-dir "$FLASHDATA_STATE_DIR" \
--output "$dir/result.json" --timeout 2m --json --non-interactive \
> "$dir/receipt.json" 2> "$dir/error.json"; then
cat "$dir/error.json" >&2
printf 'Inspect saved run cli-research-001; receipts: %s\n' "$dir" >&2
exit 1
fi
jq -e '.schemaVersion == 1 and .ok == true' "$dir/receipt.json" >/dev/null
jq -e '.status == "done" and .source == "google_search"' "$dir/result.json" >/dev/null
jq -r '.results[]?.organic[]? | [.title, .link] | @tsv' "$dir/result.json"
jq '{runId, cached, usage}' "$dir/receipt.json"
printf 'Files: %s\n' "$dir"Hangi dosyayı okumak için hangi dosyayı bilmek
CLI zarfı ve kaynak cevabı farklı JSON belgeleridir. --output olmadan, kaynak cevabı veridedir. Bu örnek --output'u kullanır, bu nedenle kaydedilen result.json'dan kaynak alanları okuyun.
| Dosya | Read Oku |
|---|---|
| receipt.json | Tamam, runId, önbellek, kullanım ve çıkış yolu. Önbellekli bir makbuz orijinal kullanımı rapor eder, yeni bir ücret değil. |
| result.json | source, status, results ve usage alanları. Google Search için results[].organic[] alanını okuyun. Boş bir dizi de geçerli bir arama sonucu olabilir. |
| error.json | Nonzero çıkışında, error.code, error.httpStatus, error.retryAfter ve herhangi bir run/job IDs. |
{
"schemaVersion": 1,
"ok": true,
"runId": "cli-research-001",
"cached": false,
"data": {
"output": "cli-run.EXAMPLE/result.json"
},
"usage": {
"credits": 0.02
}
}Başka bir arama olmadan yeniden keşfedin
Yeniden denemeden önce kurtarma işlemine dikkat edin.Inspect the save run before retrying. Orijinal hesaba erişimle, henüz mevcut olmayan bir dosya adı için başarılı bir koşu ihracat. Dava hesabından sahibine kadar geçiş yapar; daha önce ihraç edilen deneme sonuçları tutar ve yeni IDs'u yeni sahibi görevler için kullanın. Aynı koşu ID’nun altında bir değişiklik isteği reddedilir; yeni bir ID kullanmak sadece niyetli yeni bir görev için.
flashdata runs show cli-research-001 --profile research \
--state-dir "$FLASHDATA_STATE_DIR" --json
flashdata runs show cli-research-001 --result --output recovered.json \
--profile research --state-dir "$FLASHDATA_STATE_DIR" --jsonSenaryonun çalıştığı zaman zamanlama ekle
--recurring'u yerleşik sahibi erişimle kullanın, planlanan olaylar ve kalıcı durum için bir stabil ID kullanın. Bir deneme tekrarlanan işi çalıştıramaz. Ev sahibinizin programı vardır; bayrak sadece erişim kontrol eder. Planlanan güncel kullanım ve yeniden başlatma için tam tekrarlanan koşucuyu kullanın.
Seçmeli: özel indirme depolama depolama depolama
youtube indir --storage-config storage.json, storage.json olarak sadece bu depolama nesnesini kurtarın ve yerel olarak yer sahipleri yerini değiştir. Dosya özel olmalı ve yürütme kullanıcısına ait olmalıdır. Bir indirme yapmadan önce eşleşen izni komutunu kullanın.
{
"storage_type": "s3",
"storage_url": "YOUR_BUCKET",
"access_key": "YOUR_ACCESS_KEY",
"secret_key": "YOUR_SECRET_KEY",
"region": "us-east-1"
}chmod 600 storage.json$storagePath = (Resolve-Path -LiteralPath './storage.json').Path
$storageUser = [System.Security.Principal.WindowsIdentity]::GetCurrent().User
$storageAcl = [System.Security.AccessControl.FileSecurity]::new()
$storageAcl.SetOwner($storageUser)
$storageAcl.SetAccessRuleProtection($true, $false)
$storageAcl.AddAccessRule([System.Security.AccessControl.FileSystemAccessRule]::new($storageUser, 'FullControl', 'Allow'))
Set-Acl -LiteralPath $storagePath -AclObject $storageAcl