문서 둘러보기
시작하기
Go SDK를 설치하고 입력된 Google Search 요청을 실행합니다. 그런 다음 YouTube 데이터를 동일한 클라이언트로 시도하십시오.
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]설치go get github.com/flashdatadev/[email protected]인증현황
로그인, 이메일 확인 및 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숨겨진 키 프롬프트 · 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검색 실행
go.mod 외에 main.go로 저장하면 동일한 터미널에서 실행됩니다. 최대 5개의 결과를 위한 1개의 검색을 보내고 JSON 응답을 인쇄합니다.
main.gopackage 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 .결과 확인
인쇄된 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 권한이 필요합니다. 귀하의 쿼리에 대한 뉴스 결과를 반환합니다.
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
Query: "battery recycling",
})youtube_metadata 권한이 필요합니다. 제목, 채널 및 기간과 같은 비디오 세부 사항을 반환합니다. 그것은 비디오를 다운로드하지 않습니다.
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
VideoID: "dQw4w9WgXcQ",
})youtube_transcript 권한이 필요합니다. 자동 트랙을 포함한 기존 영어 성적표를 요청합니다. 해당 트랙을 사용할 때 텍스트와 타임 스탬프를 반환합니다.
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
VideoID: "dQw4w9WgXcQ",
Params: &flashdata.YouTubeTranscriptParams{
Language: flashdata.Ptr("en"),
Auto: flashdata.Ptr(true),
},
})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]를 사용.