# Go SDK 퀵스타트

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

Canonical 참고: https://flashdata.dev/ko/docs/guides/flashdata-go
검토: 2026-11-04 FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-go) — 소스 및 SDK 참조
- [API 키 받기](https://flashdata.dev/app/api-keys) — 콘솔에서 키 만들기

<a id="application"></a>

## 첫 번째 Go 요청 확인

SDK 설치, API 키 설정하고 아래 예제를 실행합니다.

- [Go SDK 방법 참고](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="install"></a>

### SDK 설치

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

#### 새로운 프로젝트

##### 설치

```bash
mkdir flashdata-demo
cd flashdata-demo
go mod init example.com/flashdata-demo
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


#### Existing 모듈

##### 설치

```bash
go get github.com/flashdatadev/flashdata-go@v1.1.0
```


- [Go 설치](https://go.dev/doc/install)
- [SDK 릴리스](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

<a id="authentication"></a>

### 인증현황

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

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

#### Bash

##### 숨겨진 키 프롬프트 · Bash

```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 7

##### 숨겨진 키 프롬프트 · PowerShell

```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
```


- [가입](https://flashdata.dev/signup)
- [API 키 생성](https://flashdata.dev/app/api-keys)
- [결제하기](https://flashdata.dev/app/billing)
- [Agent 인증](https://flashdata.dev/auth.md)

<a id="query"></a>

### 검색 실행

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

#### main.go

```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)
    }
}
```

#### 실행

```bash
go run .
```


<a id="result"></a>

### 결과 확인

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

| - 연혁 | 은둔 |
| --- | --- |
| status | 완료된 검색을 의미한다. |
| results[].organic[] | 제목, 링크 및 스니펫 필드로 검색 결과. |
| usage.credits | 이 요청에 의해 사용되는 크레딧. 5개의 결과는 1개의 수색, 5개의 요구가 아닙니다. |

#### 예 출력

```json
{
  "status": "done",
  "results": [
    {
      "organic": [
        {
          "title": "Battery recycling research",
          "link": "https://example.org/recycling",
          "snippet": "An example search excerpt."
        }
      ]
    }
  ],
  "usage": {
    "credits": 0.02
  }
}
```


<a id="common-tasks"></a>

## 다른 데이터 소스를 시도

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

### Google 뉴스

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

#### main.go에서 검색 통화를 대체

```go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})
```


### YouTube 메타데이터

youtube_metadata 권한이 필요합니다. 제목, 채널 및 기간과 같은 비디오 세부 사항을 반환합니다. 그것은 비디오를 다운로드하지 않습니다.

#### main.go에서 검색 통화를 대체

```go
result, err := client.YouTube.Metadata(ctx, flashdata.YouTubeMetadataInput{
    VideoID: "dQw4w9WgXcQ",
})
```


### YouTube 성적표

youtube_transcript 권한이 필요합니다. 자동 트랙을 포함한 기존 영어 성적표를 요청합니다. 해당 트랙을 사용할 때 텍스트와 타임 스탬프를 반환합니다.

#### main.go에서 검색 통화를 대체

```go
result, err := client.YouTube.Transcript(ctx, flashdata.YouTubeTranscriptInput{
    VideoID: "dQw4w9WgXcQ",
    Params: &flashdata.YouTubeTranscriptParams{
        Language: flashdata.Ptr("en"),
        Auto: flashdata.Ptr(true),
    },
})
```


- [모든 소스 매개 변수](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/sources.md)

<a id="features"></a>

## Go SDK 지원

| 제품 정보 | 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 다운로드 예](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [다운로드 구성](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md)
- [Go 응답 체재](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/response-formats.md)

<a id="types"></a>

## Go 유형

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

- [저장 및 디코딩 결과](https://flashdata.dev/ko/docs/guides/sdk-operations/reference.md#save)

<a id="next"></a>

## 다음 단계

- [계정 확인 및 저장된 결과](https://flashdata.dev/ko/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/ko/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/ko/docs/guides/youtube-download-guide/reference.md)
- [SDK 방법 참고](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/docs/api-reference.md)

<a id="recover"></a>

## 단계가 실패한 경우

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

- [회사연혁](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
