본문으로 건너뛰기
KO
API 키 받기
문서 둘러보기

시작하기

SDK 계정 확인 및 저장된 결과

각 시도의 기록을 유지하고 다른 API 통화없이 저장된 결과를 읽으십시오.

이 페이지의 내용

시작하기 전에

프로젝트를 사용하여 SDK 및 FLASHDATA_API_KEY를 SDK Quickstart에서 설치했습니다. 아래 언어 선택. 각 새로운 실행 디렉토리는 하나의 의도 된 검색을 나타냅니다; 어떤 요청을 만들기 전에 기존 디렉토리를 재사용합니다.

1. 액세스 및 현재 비용 확인

SDK에 맞는 확인 코드를 저장하고 실행하세요. 권한, 잔액 및 Google Search 한 번의 가격을 읽습니다. Access check passed가 표시된 뒤에만 진행하세요. 이 확인은 유료 쿼리를 보내거나 크레딧을 예약하지 않습니다.

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. 저장된 산출을 읽으십시오

파싱, summaries 및 UI 작업을 위해 result.json를 읽으십시오. 이 명령은 로컬 파일만 사용합니다. 네트워크 호출 전에 동일한 디렉토리의 검색을 다시 실행; 그것은 다른 기계를 조정하거나 손실 서버 응답을 복구하지 않습니다.

현지 정보
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의 기존 실행 저널.