# Go SDK

ثبّت Go SDK وشغّل طلب Google Search بأنواع محددة. ثم جرّب بيانات YouTube بالعميل نفسه.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/flashdata-go
Reviewed: 2026-11-04 by 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>

### Install the SDK

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


#### الوحدة الحالية

##### تثبيت

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


- [Install Go](https://go.dev/doc/install)
- [SDK release](https://github.com/flashdatadev/flashdata-go/releases/tag/v1.1.0)

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

### التوثيق

وقّعْ، يُحقّقُ بريدكَ الإلكتروني ويُخلقُ API مفتاح Google Search إذن، أو إعادة استخدام مفتاح مأذون به.

المجموعة FLASHDATA_API_KEY تحت، أو الحفاظ على القيمة التي تم توفيرها بالفعل من قبل البيئة الخاصة بك. ويقرأ هذا المثال صراحة؛ ولا تُحمَّل الملفات التي تُملأ.

#### 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)
- [Create an API key](https://flashdata.dev/app/api-keys)
- [الأرصدة الدائنة الشيكة](https://flashdata.dev/app/billing)
- [التوثيق من قبل العميل](https://flashdata.dev/auth.md)

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

### نفّذ بحثًا

احفظ هذا main.go بجانبك go.modثم تشغيله في نفس المحطة. وهو يرسل بحثا واحدا عن ما يصل إلى خمسة نتائج ويطبع رد 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>

### تحقق من النتيجة

ابحث عن status: done in the printed JSON. استعملوا ألقاب العودة URLs والقناص في طلبك أو وكيلك والقائمة العضوية الفارغة هي أيضا نتيجة صحيحة.

| الميدان | معنى |
| --- | --- |
| status | القيام به يعني الانتهاء من البحث. |
| results[].organic[] | نتائج البحث في حقول الملكية والربط والقناص |
| usage.credits | الائتمانات التي يستخدمها هذا الطلب. خمسة نتائج هي بحث واحد، وليس خمسة طلبات. |

#### الناتج المثالي

```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، يستعاض عن النتيجة فقط، er := client.Google.Search(...) أبقِ العميلَ، السياق، تَدقيق الأخطاءِ و ناتجَ JSON، ثمّ يَدْخلُ ثانيةً. وتقدم كل عملية طلبا جديدا واحدا.

### Google News

الاحتياجات google_news إذن. يعيد نتائج الأخبار من أجل سؤالك.

#### يستعاض عن نداء البحث في main.go

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


### YouTube metadata

الاحتياجات 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 | ويوفر البحث، والبيانات الوصفية، والنسخ، والقواني، والاقتراحات بيانات مصورة. |
| YouTube.Download | قم بتوصيل وظيفة تسجيل صوتي أو فيديو لتخزينك السحابي (ب) اشتراطات الأذن والتخزين من طراز youtube_download؛ استخدام المثال الكامل أدناه. |
| Jobs / Bulk | أرسل باستخدام دالة Async مساعدة، واحفظ معرّف المهمة، ثم استخدم Jobs.Wait وJobs.Result. يعالج Bulk مجموعات البيانات الأكبر والمهام القابلة للاستئناف. |
| Account | اقرأ الهوية والتوازن والتسعير والحدود والعرف قبل العمل غير المعدل. إعادة استخدام نفس العميل والمفتاح المأذون به. |
| WithFormat | اطلب JSON أو نصًا عاديًا أو Markdown بخيارات تنسيق صريحة. ينسّق Markdown البيانات المسترجعة لوكيلك؛ ويتولى تطبيقك استدعاءات النموذج أو الملخصات. |

- [تحميل كامل Go على سبيل المثال](https://github.com/flashdatadev/flashdata-go/blob/v1.1.0/examples/youtube_download/main.go)
- [تخزين حمولة المصادرة](https://flashdata.dev/ar/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 describes the query. (ز) مؤشرات استخدام البارامترات الاختيارية، مثل flashdata.Ptr(int64(5)). وتتضمن النتائج المصدر JSON؛ واستخدام DecodeResults [GoogleSearchPayload] عندما تحتاج إلى حقول مطبوعة.

- [تحقيق نتائج من نوع الإنقاذ والديكور](https://flashdata.dev/ar/docs/guides/sdk-operations/reference.md#save)

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

## الخطوات التالية

- [التحقق من الحسابات وتحقيق النتائج](https://flashdata.dev/ar/docs/guides/sdk-operations/reference.md)
- [YouTube Data](https://flashdata.dev/ar/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/ar/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>

## إذا فشلت خطوة

| المشكلة | Fix |
| --- | --- |
| الحزمة أو الإجازات المفقودة | تحقق من النسخة و اذهب وادخل الدليل المحتوي go.mod. |
| 401 / FLASHDATA_API_KEY | ضع مفتاحاً صالحاً في المحطة حيث تدير المثال |
| 403 | Enable Google Search for this API key. |
| 402 | تحقق من شركة Billing فيما يتعلق بالائتمانات المتاحة، أو تدّعي تجربة عميل مستنفد. |
| 429 | انتظر Retry-Afterثم خفض معدل طلبك. |
| الوقت أو خطأ الخادم | تحقق History وقبل الإلغاء؛ قد يكون الطلب الأول قد بدأ بالفعل. |

- [التاريخ](https://flashdata.dev/app/jobs)
- [Billing](https://flashdata.dev/app/billing)
