Belgeleri incele
Başlarken
SDK'u yükleyin ve Node.js'da bir arama yapın. TypeScript veya JavaScript'u seçin; sunucuda API anahtarlarını tut.
Yüklemek için SDK
Bu örnekler kullanır Node.js 22.18+ koşmak TypeScript Doğrudan. Boş bir klasöre başlayın veya package.json'ya sahipseniz mevcut proje seçin.
Yüklenpm init -y npm install --save-exact @flashdata-dev/[email protected]Yüklenpm install --save-exact @flashdata-dev/[email protected]Kimlik Doğrulama
Google Search izni ile anahtar oluşturun veya yetkili bir anahtarı yeniden kullanın. FLASHDATA_API_KEY'u bu terminalde aşağıdaki gizli bir şekilde kullanarak ayarlayın; ortamınızın zaten onu tedarik etmesi durumunda bunu atlayın.
Örnek anahtarı açıkça alır. Bir .env dosyası bu senaryolar tarafından yüklenmez. Bir web uygulamasına entegre edildiğinde sunucunun yanı sıra konfigürasyonunda anahtarı tutun.
Gizli anahtar · 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_KEYGizli anahtar · 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 flashdataSecureKeyArama çalıştırın
Seçilmiş dosyayı kurtar ve bu projede komutasını çalıştırın. Her run beş sonuç için bir arama gönderir. Her iki dosya doğrudan Node.js ile çalışır; bu örnek için bir adım gerekli değildir.
quickstart.mtsimport { 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);Run ... Node.js 22.18+node quickstart.mtsquickstart.mjsimport { 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);Çalıştırnode quickstart.mjsSonucu kontrol edin
Senaryo kontrolleri durumu yapılır ve kaynak başlıklarını yazdırır, URLs ve kullanılan kredileri. Boş organik sonuçlar geçerlidir. Aşağıdaki örnek çıktı şekli gösterir; canlı kaynaklar değişir.
Örnek çıktıBattery recycling research https://example.org/recycling Credits used: 0.02results[].organic[]- Google Search başlıkları, bağlantılar ve parçalar. Diğer kaynaklar kendi tip ödeme yüklerine sahiptir.
usage.credits- Bu istek için ücretlendirilir; beş geri dönüş vuruşu bir arama isteğidir.
Başka bir veri kaynağı deneyin
Her sekme hem TypeScript hem de JavaScript'da çalışır. Dosyayı 3 adımından değiştirin, .mts veya .mjs uzantısını tut ve aynı komutu çalıştırın. Her işletme yeni bir istektir ve gösterilen kaynak iznine ihtiyaç duyar.
google_news'u gerektirir. results[].news[] makale girişlerini okuyun.
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_metadata'u gerektirir. Başlıklar, kanallar, süresi ve diğer video ayrıntıları.
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_transcript'u gerektirir. Mevcut bir İngilizce otomatik pist talep eder. Text, results[].fullText'da, takip mevcut olduğunda.
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);Bir TypeScript projesi
Node bu örneği striptiz türleri ile çalıştırıyor. Bir istek göndermeden türlerini kontrol etmek için, TypeScript'u yüklemek ve --noEmit ile derleyiciyi çalıştırmak:
npm install --save-dev typescript@~5.9.3 @types/node@^22
npx tsc quickstart.mts --module nodenext --target es2022 --strict --noEmitSDK ne destekliyor
google / youtube- Arama ve yapılandırılmış verileri tiplenen kaynak yardımcıları ile alın. Hizmetinizde bir müşteriyi yeniden kullanın.
youtube.download- Bir arka plan işi aracılığıyla bulut depolamanıza ses veya video gönderin. youtube_download izni ve depolama yapılandırması gerekir.
jobs / bulk- Kaydetilmiş iş IDs ve tamamlanmış sonuçları alın. JavaScript; mode: 'async' bir sunucu arka arka plan işi gönderir.
account- Erişim, denge, fiyatlandırma, limitler ve kullanım tekrarlanan çalışmadan önce.
respondWith / accept- { respondWith: 'markdown' }, bir dize için Markdown için ikinci argüman olarak response.content veya { accept: 'text/plain' } için. JSON nesneler varsayılandir.
Sonraki adımlar
Bir adım başarısız olursa
- Paket veya runtime eksik
- Bu projede Node --version ve @flashdata-dev/sdk'u kontrol edin. Yukarıda gösterilen .mts veya .mjs uzantısını tut.
- 401 / FLASHDATA_API_KEY
- Örnek çalıştırdığınız terminalde geçerli bir anahtar ayarlayın.
- 403
- Enable Google Search Bunun için API anahtar.
- 402
- Kullanılabilir krediler için Billing bölümünü kontrol edin veya tükenmiş ajan denemesini hesaba bağlayın.
- 429
- Retry-After için bekleyin, sonra istek oranını azaltır.
- Zamanout veya sunucu hatası
- History'u tekrarlamadan önce kontrol edin; ilk istek zaten çalıştırılabilir.