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

시작하기

Go SDK 퀵스타트

Go SDK를 설치하고 입력된 Google Search 요청을 실행합니다. 그런 다음 YouTube 데이터를 동일한 클라이언트로 시도하십시오.

  1. SDK 설치

    Go 1.25+를 요구합니다. 새로운 프로젝트를 선택하거나 기존 go.mod를 포함하는 디렉토리에 설치하십시오.

    설치
    mkdir flashdata-demo
    cd flashdata-demo
    go mod init example.com/flashdata-demo
    go get github.com/flashdatadev/[email protected]
  2. 인증현황

    로그인, 이메일 확인 및 API 키 생성 Google Search 권한, 또는 허가 된 키를 재사용.

    아래 FLASHDATA_API_KEY를 설정하거나 이미 환경을 공급하는 값을 유지하십시오. 예제는 명시적으로 읽습니다. .env 파일은로드되지 않습니다.

    숨겨진 키 프롬프트 · 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
  3. 검색 실행

    go.mod 외에 main.go로 저장하면 동일한 터미널에서 실행됩니다. 최대 5개의 결과를 위한 1개의 검색을 보내고 JSON 응답을 인쇄합니다.

    main.go
    package main
    
    import (
        "context"
        "encoding/json"
        "log"
        "os"
        "time"
    
        flashdata "github.com/flashdatadev/flashdata-go"
    )
    
    func main() {
        key := os.Getenv("FLASHDATA_API_KEY")
        if key == "" {
            log.Fatal("Set FLASHDATA_API_KEY through your server's secret manager.")
        }
        client, err := flashdata.New(flashdata.Options{APIKey: key})
        if err != nil {
            log.Fatal(err)
        }
        ctx, cancel := context.WithTimeout(context.Background(), 2*time.Minute)
        defer cancel()
        result, err := client.Google.Search(ctx, flashdata.GoogleSearchInput{
            Query: "battery recycling research",
            Params: &flashdata.GoogleSearchParams{Num: flashdata.Ptr(int64(5))},
        })
        if err != nil {
            // Do not automatically resubmit an uncertain paid request.
            log.Fatal(err)
        }
        if err := json.NewEncoder(os.Stdout).Encode(result); err != nil {
            log.Fatal(err)
        }
        if result.Status != "done" {
            log.Fatalf("Search did not complete: %s", result.Status)
        }
    }
    실행
    go run .
  4. 결과 확인

    인쇄된 JSON에 있는 status: done를 찾습니다. 반환된 제목, URLs 및 스니펫을 사용하여 응용 또는 에이전트. 빈 유기 목록은 또한 유효한 결과입니다.

    예 출력
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }
    status
    완료된 검색을 의미한다.
    results[].organic[]
    제목, 링크 및 스니펫 필드로 검색 결과.
    usage.credits
    이 요청에 의해 사용되는 크레딧. 5개의 결과는 1개의 수색, 5개의 요구가 아닙니다.

다른 데이터 소스를 시도

main.go에서, 결과 만 교체, err := client.Google.Search(...) 이러한 통화 중 하나와 호출합니다. 클라이언트, 컨텍스트, 오류 검사 및 JSON 출력을 유지하고, 실행 . 다시. 각 실행은 하나의 새로운 요청을 제출합니다.

google_news 권한이 필요합니다. 귀하의 쿼리에 대한 뉴스 결과를 반환합니다.

main.go에서 검색 통화를 대체
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

Go SDK 지원

Google
검색, 뉴스, 이미지, 쇼핑, 비디오 및 장소. 질 결과를 위한 Google.Pages를 사용하십시오.
YouTube
Search, Metadata, Transcript, Captions, Channel 및 제안은 구조화 된 비디오 데이터를 제공합니다.
YouTube.Download
오디오 또는 비디오 배달 작업을 클라우드 스토리지에 제출하십시오. youtube_download 권한 및 저장 구성이 필요합니다. 아래의 전체 예제를 사용하십시오.
Jobs / Bulk
Async 헬퍼로 제출하면 ID를 저장하고 Jobs.Wait 및 Jobs.Result를 사용하십시오. Bulk는 더 큰 데이터 세트 및 재작용 가능한 일을 취급합니다.
Account
정체성, 균형, 가격, 제한 및 사용 전에 무인화 작업. 동일한 클라이언트와 승인된 열쇠를 재사용하십시오.
WithFormat
JSON, 일반 텍스트 또는 Markdown를 요청하여 명시된 형식 옵션으로 요청하십시오. Markdown 형식은 귀하의 에이전트에 대한 데이터를 검색; 응용 프로그램 공급 모델 통화 또는 summaries.

Go 유형

GoogleSearchInput은 쿼리를 설명합니다. flashdata.Ptr (int64 (5)와 같은 선택적인 모수 사용 포인터. 결과 소스 JSON 포함; 입력 필드가 필요할 때 DecodeResults[GoogleSearchPayload]를 사용.

다음 단계

단계가 실패한 경우

패키지 또는 실행 시간 누락
이동 버전 및 실행 go.mod를 포함하는 디렉토리에서 얻을.
401 / FLASHDATA_API_KEY
예를 실행하는 터미널에서 유효한 키를 설정합니다.
403
이 API 열쇠를 위한 가능하게 하는 Google Search.
402
Billing를 사용 가능한 신용을 확인하거나 소진된 에이전트 체험을 주장합니다.
429
Retry-After를 기다리면 요청 속도를 줄입니다.
Timeout 또는 서버 오류
History를 다시 구출하기 전에 확인하십시오. 첫 번째 요청은 이미 실행 될 수 있습니다.