# TypeScript & JavaScript SDK

ติดตั้ง SDK และทําการค้นหาใน Node.js. เลือก TypeScript หรือ JavaScript. . เก็บ API กุญแจบนเซิฟเวอร์

อ้างอิงทางคลอง: https://flashdata.dev/th/docs/guides/flashdata-typescript
Recorder: 2026-11-04 โดย FlashData

- [GitHub](https://github.com/flashdatadev/flashdata-typescript) — ต้นฉบับและ SDK อ้างอิง
- [รับคีย์ API](https://flashdata.dev/app/api-keys) — สร้างกุญแจในคอนโซล

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

## ให้เป็นครั้งแรกของคุณ Node.js ร้องขอ

ติดตั้งแพกเกจต่าง ๆ แล้วตั้งค่า API ปุ่มพิมพ์และเลือก TypeScript หรือ JavaScript ข้างล่าง ประมวลผลโค้ดบนเซิร์ฟเวอร์ของคุณ หรือในสคริปต์ภายในเครื่อง

- [SDK การอ้างอิงแบบใด](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)
- [npm](https://www.npmjs.com/package/@flashdata-dev/sdk/v/1.1.0)

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

### ติดตั้ง SDK

ตัวอย่างเหล่านี้ใช้ Node.js 22.18เพิ่มที่ประมวลผล TypeScript ตรงๆเลย เริ่มในโฟลเดอร์ว่าง หรือเลือกโครงการที่มีอยู่ หากคุณมี package.json.

#### โครงการใหม่

##### ติดตั้ง

```bash
npm init -y
npm install --save-exact @flashdata-dev/sdk@1.1.0
```


#### มีโครงการอยู่แล้ว

##### ติดตั้ง

```bash
npm install --save-exact @flashdata-dev/sdk@1.1.0
```


- [ติดตั้ง Node.js](https://nodejs.org/en/download)

<a id="key"></a>

### การตรวจสอบสิทธิ์

สร้างกุญแจด้วย Google Search อนุญาตหรือใช้กุญแจที่ได้รับอนุญาตอีกครั้ง ตั้งค่า FLASHDATA_API_KEY ในเทอร์มินัลนี้ โดยใช้ตัวกระตุ้นที่ซ่อนอยู่ด้านล่างนี้; ข้ามที่นี่ไป หากสภาพแวดล้อมของคุณได้จัดเตรียมเอาไว้แล้ว

ตัว อย่าง นี้ ถ่ายทอด กุญแจ อย่าง ชัดเจน. แฟ้ม .env ไม่ได้ถูกโหลดโดยสคริปต์เหล่านี้ เก็บกุญแจไว้ในการปรับแต่งของเซิร์ฟเวอร์ด้านข้าง เมื่อมีการรวมเข้ากับโปรแกรมต่าง ๆ

#### Bash

##### แจ้งเตือนปุ่มซ่อน as 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

##### แจ้งเตือนปุ่มซ่อน as 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 Keys](https://flashdata.dev/app/api-keys)
- [เปิด Billing](https://flashdata.dev/app/billing)
- [การทดลองของเจ้าหน้าที่](https://flashdata.dev/th/docs/guides/agent-onboarding/reference.md)

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

### เรียกใช้การค้นหา

บันทึกแฟ้มที่เลือกไว้และประมวลผลคําสั่งในโครงการนี้ แต่ละการทํางานจะส่งหนึ่งการค้นหาถึงห้าผลลัพธ์ แฟ้มทั้งสองทํางานโดยตรงด้วย Node.js(; ไม่ จําเป็น ต้อง มี ขั้น ตอน ใน การ สร้าง สําหรับ ตัว อย่าง นี้.

#### TypeScript

##### quickstart.mts

```typescript
import { FlashData, type GoogleSearchParams } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY in the server environment.');
const client = new FlashData({ apiKey });
const params: GoogleSearchParams = { num: 5 };
const response = await client.google.search({ query: 'battery recycling research', ...params });
if (response.status !== 'done') throw new Error(JSON.stringify(response));

for (const page of response.results) {
  for (const hit of page.organic ?? []) console.log(hit.title, hit.link);
}
console.log('Credits used:', response.usage.credits);
```

##### เรียกใช้ '' Node.js 22.18+

```bash
node quickstart.mts
```


#### JavaScript

##### quickstart.mjs

```javascript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY in the server environment.');
const client = new FlashData({ apiKey });
const response = await client.google.search({ query: 'battery recycling research', num: 5 });
if (response.status !== 'done') throw new Error(JSON.stringify(response));

for (const page of response.results) {
  for (const hit of page.organic ?? []) console.log(hit.title, hit.link);
}
console.log('Credits used:', response.usage.credits);
```

##### เรียกใช้

```bash
node quickstart.mjs
```



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

### ตรวจสอบผลลัพธ์

การตรวจสอบสคริปต์เสร็จสิ้นแล้ว และการพิมพ์ชื่อต้นฉบับ URLs และใช้เครดิต ผลของออร์แกนิคว่างเปล่าใช้ได้ ตัว อย่าง ที่ ออก มา ข้าง ล่าง นี้ แสดง ให้ เห็น รูป ร่าง; แหล่ง ที่ มี ชีวิต จะ แตก ต่าง ออก ไป.

| ช่องข้อมูล | ใช้ |
| --- | --- |
| results[].organic[] | Google Search ชื่อเพลง, ลิงก์และชิ้นส่วน แหล่งข่าวอื่น ๆ มีกระสุนชนิดของตัวเอง |
| usage.credits | เครดิตค่าใช้จ่ายสําหรับคําขอนี้; ห้าตีกลับมาเป็นหนึ่งการร้องขอการค้นหา |

#### ตัวอย่างผลลัพธ์

```text
Battery recycling research https://example.org/recycling
Credits used: 0.02
```


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

## ลองแหล่งข้อมูลอื่น

แท็บแต่ละตัวใช้ได้ทั้งคู่ TypeScript ถึง JavaScript. แทนที่แฟ้มจากขั้นที่ 3, ให้คงนามสกุล .mts หรือส่วนขยาย mpjs และประมวลผลคําสั่งเดียวกัน การเรียกทํางานแต่ละครั้งเป็นการร้องขอใหม่ และต้องการสิทธิ์ในการแสดงแหล่งข้อมูล

### Google ข่าว

ต้องมีสิทธิ์ google_news อ่านรายการบทความจาก results[].news[]

#### quickstart.mts / quickstart.mjs

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.google.news({
  query: 'battery recycling', num: 5,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


### YouTube ข้อมูลกํากับภาพ

ต้องการ youtube_metadata คืนชื่อเพลง, ช่องเสียง, ความยาว และรายละเอียดวิดีโออื่น ๆ

#### quickstart.mts / quickstart.mjs

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.youtube.metadata({
  video_id: 'dQw4w9WgXcQ', include_formats: false,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


### YouTube เอกสาร

ต้องการ youtube_transcript ต้องการร่องเสียงอัตโนมัติจากภาษาอังกฤษที่มีอยู่ ข้อความอยู่ใน results[].fullText เมื่อมีแทร็กเสียงอยู่

#### quickstart.mts / quickstart.mjs

```typescript
import { FlashData } from '@flashdata-dev/sdk';

const apiKey = process.env.FLASHDATA_API_KEY;
if (!apiKey) throw new Error('Set FLASHDATA_API_KEY first.');
const client = new FlashData({ apiKey });
const response = await client.youtube.transcript({
  video_id: 'dQw4w9WgXcQ', language: 'en', auto: true,
});
if (response.status !== 'done') throw new Error(JSON.stringify(response));
console.log(response);
```


- [พารามิเตอร์ต่าง ๆ ทั้งหมด](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/sources/index.md)

<a id="typecheck"></a>

## พิมพ์- กาเลือกโครงการ TypeScript

โหนดดําเนินการตัวอย่างนี้โดยชนิดการลอกเลียน ให้ทําการตรวจสอบชนิดของรายการโดยไม่ต้องส่งการร้องขอให้ติดตั้ง TypeScript และเรียกตัวรวบรวม --noEmit:

### ตรวจสอบชนิดเสริม

```bash
npm install --save-dev typescript@~5.9.3 @types/node@^22
npx tsc quickstart.mts --module nodenext --target es2022 --strict --noEmit
```

- [Node.js TypeScript สนับสนุน](https://nodejs.org/api/typescript.html)

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

## อะไรกันนี่ SDK สนับสนุน

| ใช้ | วิธีการต่าง ๆ |
| --- | --- |
| google / youtube | ค้นหาและดึงข้อมูลที่มีโครงสร้างกับแหล่งข้อมูลพิมพ์ ช่วยลูกความคนหนึ่งในบริการคุณ |
| youtube.download | ส่งเสียงหรือวิดีโอไปยังที่เก็บเมฆของคุณผ่านทางงานเบื้องหลัง ต้องการ youtube_download อนุมัติและบันทึกการปรับแต่ง |
| jobs / bulk | บันทึกงานที่ส่งแล้ว IDs และรับผลที่เสร็จสมบูรณ์แล้ว รออยู่ใน JavaScript; mode: 'async' ส่งงานเบื้องหลังของแม่ข่าย |
| account | อ่าน เข้าถึง, สมดุล, ประเมินค่า, จํากัด และการใช้งาน ก่อนการทํางานซ้ํา |
| respondWith / accept | ผ่าน { respondWith: 'markdown' } เป็นวิธีการโต้แย้งที่สองสําหรับ Markdown ใน response.contentหรือ { accept: 'text/plain' } สําหรับเชือก JSON วัตถุเป็นค่าปริยาย |

- [ดาวน์โหลดตัวอย่าง](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/examples/youtube_download.mjs)
- [ตั้งค่าจัดเก็บ](https://flashdata.dev/th/docs/guides/youtube-download-guide/reference.md)
- [รูปแบบคำตอบ](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/response-formats.md)

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

## ถัดไป

- [บันทึกผลลัพธ์และจัดการข้อผิดพลาด](https://flashdata.dev/th/docs/guides/sdk-operations/reference.md)
- [งานและชุดงาน](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/jobs.md)
- [การปรับแต่งไคลเอนต์](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/client.md)
- [SDK การอ้างอิงแบบใด](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/api-reference.md)

<a id="errors"></a>

## ถ้าขั้นตอนล้มเหลว

| ปัญหา | แก้ไข |
| --- | --- |
| แพกเกจหรือไม่พบเวลาทํางาน | ตรวจสอบโหนด --version และติดตั้งflashdata-dev/sdk ในโครงการนี้ เก็บส่วนขยาย .mts หรือ .mmjs ที่แสดงอยู่ด้านบน |
| 401 / FLASHDATA_API_KEY | ตั้งค่ากุญแจที่ถูกต้องในเทอร์มินัลที่คุณเรียกใช้งานตัวอย่าง |
| 403 | เปิด Google Search สําหรับสิ่งนี้ API กุญแจ |
| 402 | ตรวจสอบเครดิตที่ใช้ได้ใน Billing หรือผูกสิทธิ์ทดลองใช้ของเอเจนต์ที่หมดเครดิตแล้วกับบัญชี |
| 429 | รอ Retry-After แล้วลดอัตราการร้องขอของคุณ |
| หมดเวลาหรือเซิร์ฟเวอร์ผิดพลาด | ตรวจสอบ History ก่อนจะทําการแก้ไขการร้องขอแรกอาจจะทํางานอยู่แล้ว |

- [ต้องการประวัติ](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
- [SDK มีข้อผิดพลาดและการกู้คืน](https://github.com/flashdatadev/flashdata-typescript/blob/v1.1.0/docs/errors.md)
