Перейти до вмісту
UK
Отримати ключ API
Переглянути документацію

Початок роботи

Перевірка облікового запису та збережені результати в SDK

Перевірте вартість, зберігайте запис кожної спроби та ознайомтеся з збереженими результатами без іншого виклику API.

На цій сторінці

Перед тим, як початися

Використовуйте проект, встановлений SDK і FLASHDATA_API_KEY з вашого SDK Quickstart. Виберіть одну мову нижче. Кожен новий каталог запуску є одним призначеним пошуком; перенаправлення існуючого каталогу припиняється до виконання будь-якого запиту.

1. Перевірити доступ і поточну вартість

Заощаджуйте та запустіть чек на SDK. Зазначте дозвіл на роботу, баланс і ціну одного Google Search. Продовжити тільки після перевірки доступу, ці перевірки не подають платних запитів або заброньованих кредитів.

check_access.py
import os
import sys
from flashdata import FlashData, APIError

def main():
    key = os.environ.get("FLASHDATA_API_KEY", "").strip()
    if not key:
        raise RuntimeError("Set FLASHDATA_API_KEY in this terminal.")
    with FlashData(api_key=key) as client:
        access = client.account.access()
        if "google_search" not in access["sources"]:
            raise RuntimeError("This key needs google_search permission.")
        balance = client.account.balance()
        pricing = client.account.pricing(source="google_search", request_count=1)
    price = next((p for p in pricing["prices"]
                  if p["source"] == "google_search" and p["available"]), None)
    cost = price.get("estimatedCredits") if price else None
    if cost is None:
        raise RuntimeError("No current price is available; stop here.")
    available = balance["availableCredits"]
    print(f"Available credits: {available}")
    print(f"One search: {cost} credits")
    if available < cost:
        raise RuntimeError("Insufficient credits. Review Billing.")
    print("Access check passed. No paid query submitted.")

if __name__ == "__main__":
    try:
        main()
    except APIError as error:
        print(f"HTTP {error.status_code}; code={error.code}; "
              f"request_id={error.request_id}; Retry-After={error.retry_after}",
              file=sys.stderr)
        sys.exit(1)
    except Exception as error:
        print(f"{type(error).__name__}: {error}", file=sys.stderr)
        sys.exit(1)
Linux / macOS
.venv/bin/python check_access.py
Windows PowerShell
.\.venv\Scripts\python.exe check_access.py

2. Запуск з новим вихідним каталогом

Запуск одного з цих програм після проходження перевірок. Створює каталог перед поданням, записує запит, потім зберігає відповідь. Збережіть каталог про відмову: видаліть його або вибравши новий, що дозволяє іншому зараховуватися.

archive_search.py
import json
import os
import sys
from datetime import datetime, timezone
from pathlib import Path
from flashdata import FlashData, APIError, SubmissionUnknownError

def main():
    key = os.environ.get("FLASHDATA_API_KEY", "").strip()
    if not key:
        raise RuntimeError("Set FLASHDATA_API_KEY before running.")
    directory = Path(sys.argv[1] if len(sys.argv) > 1 else "runs/research-001")
    directory.mkdir(mode=0o700, parents=True, exist_ok=False)

    def save(name, value):
        with (directory / name).open("x", encoding="utf-8") as output:
            json.dump(value, output, ensure_ascii=False, indent=2)

    request = {"source": "google_search", "query": "battery recycling research",
               "params": {"num": 5}}
    save("request.json", request)
    save("intent.json", {"state": "dispatching",
                         "startedAt": datetime.now(timezone.utc).isoformat()})
    try:
        with FlashData(api_key=key) as client:
            response = client.google.search(request["query"], **request["params"])
    except (APIError, SubmissionUnknownError) as error:
        detail = {"kind": type(error).__name__}
        if isinstance(error, APIError):
            detail.update(code=error.code, httpStatus=error.status_code,
                          requestId=error.request_id, retryAfter=error.retry_after)
        save("error.json", detail)
        raise RuntimeError("Inspect the saved attempt and History before retrying.") from None
    save("result.json", response)
    if response.get("status") != "done":
        raise RuntimeError("Response saved; inspect its status before proceeding.")
    print("Saved:", directory / "result.json")
    print("Usage:", response.get("usage"))

if __name__ == "__main__":
    try:
        main()
    except Exception as error:
        print(f"{type(error).__name__}: {error}", file=sys.stderr)
        sys.exit(1)
Linux / macOS
.venv/bin/python archive_search.py runs/research-001
Windows PowerShell
.\.venv\Scripts\python.exe archive_search.py runs/research-001

Очікувані файли

Успіх друкує збережений шлях результату і використання. result.json повинен мати status: done; Google результати в results[].organic[]. Порожній органічний масив діє. Про це API або транспортні помилки зберігаються в error.json; intent.json залишається оригінальним записом допуску.

Успішна спроба
runs/research-001/
  request.json # Джерело, запит та параметри
  intent.json # Інтемпт час запуску
  result.json # Повний відгук, включаючи результати та використання

3. Читати збережений вихід

Читайте result.json для парсингу, підсумків та UI роботи. Ці команди використовують лише локальні файли. Виконуючи пошук з тим самим каталогом зупиняється перед підключенням мережі; він не координує різні машини або відновити втрачену відповідь сервера.

Читати локально
cat runs/research-001/result.json

Вирішити, що робити після збою

Що ви маєтеПопередня дія
Експлуатаційний каталог / EEXISTПерегляд його файлів. Немає нових запитань, які надсилали цю спробу.
result.json, status: doneПрочитати і обробляти збережену відповідь. Запобігти його використанню як квитанції оригінального заряду.
error.json з 401 / 403 / 402Виправлення доступу, вихідних дозволів або балансу перед плануванням нової спроби.
429 / retryAfterОчікується, як незрівнянний і знижувати швидкість запиту. Переглядайте невдалу спробу перед вибором нового каталогу.
Невідоме подання / неприпустимо тільки / записувати відмовуРобота вже може бути прийнята. Зберігайте каталог і перевірте History або відома робота ID перед відправкою іншої запиту.

Async клієнтів і фонових робочих місць

ПотрібніЗареєструватися
Тримайте подію петлю чуйнимКлієнт-асинхронізований SDK/ очікується. У свою чергу, в свою чергу, ми працюємо з HTTP.
Резюме після виходу з процесу викликуВідправте фонову роботу раз, заощаджуйте свій віддалений ID, після чого прочитайте статус і результати.
Запуск на графікуВикористовуйте доступ власника та міцні записи додатків, або існуючий журнал запуску CLI.