ข้ามไปยังเนื้อหา
TH
รับคีย์ API
เรียกดูเอกสาร

เริ่มต้นใช้งาน

เริ่มต้นใช้ Go SDK

ติดตั้ง Go SDK และประมวลผลแบบพิมพ์ Google Search ขอล่ะ งั้นลอง YouTube ข้อมูลที่มีลูกค้าคนเดียวกัน

  1. ติดตั้ง 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]
  2. การตรวจสอบสิทธิ์

    เซ็นกํากับแล้วตรวจสอบอีเมลของคุณและสร้าง API กุญแจพร้อม Google Search อนุญาตหรือใช้กุญแจที่ได้รับอนุญาตอีกครั้ง

    ตั้งค่า FLASHDATA_API_KEY ข้าง ล่าง นี้ หรือ รักษา คุณค่า ที่ คุณ มี อยู่ แล้ว โดย สิ่ง แวด ล้อม ของ คุณ. ตัวอย่างการอ่านมันโดยตรง; แฟ้ม.env ยังไม่ได้โหลด

    แจ้งเตือนปุ่มซ่อน as 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
  3. เรียกใช้การค้นหา

    บันทึกนี้เป็น main.go ข้าง go.modแล้วเอาไปใช้ในอาคารเดียวกัน มันส่งหนึ่งการค้นหาถึงห้าผล และพิมพ์การตอบสนอง JSON

    main.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)
        }
    }
    เรียกใช้
    go run .
  4. ตรวจสอบผลลัพธ์

    ค้นหา status: done ในการพิมพ์ JSON. ใช้ชื่อเล่นที่คืนมา 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
    เงิน ที่ ได้ มา จาก คํา ขอ นี้. ห้าผลคือหนึ่งการค้นหา ไม่ใช่ห้าคําขอ

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

ใน main.goต้องการจะแทนที่ผลลัพธ์เท่านั้น ให้ผิดพลาด:= client.Google.Search(...) โทรหาด้วยสายหนึ่ง เก็บไคลเอนต์, บริบท, การตรวจสอบข้อผิดพลาดและ JSON ส่งออกแล้วให้ประมวลผลอีกครั้ง แต่ละการทํางานส่งหนึ่งการร้องขอใหม่

ต้องการ google_news อนุญาต ตอบกลับผลการค้นหาของคุณ

แทนที่การเรียกค้นหาใน main.go
result, err := client.Google.News(ctx, flashdata.GoogleNewsInput{
    Query: "battery recycling",
})

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

Google
สืบค้น, ข่าว, ภาพ, ร้านค้า, วิดีโอ และสถานที่ต่างๆ ใช้ Google.Pages สําหรับผลการดัดแปลง
YouTube
สืบค้น, ข้อมูลกํากับภาพ, ทรานสคริปต์, คําบรรยาย, ช่องและคําแนะนําจัดทําข้อมูลวิดีโอแบบโครงสร้าง
YouTube.Download
ส่งงานส่งเสียงหรือวิดีโอไปยังที่เก็บเมฆของคุณ ต้องการ youtube_download อนุญาตให้ใช้และบันทึกค่าต่าง ๆ โดยใช้ตัวอย่างที่สมบูรณ์ด้านล่างนี้
Jobs / Bulk
ส่งข้อมูลด้วย Async ผู้ช่วย, บันทึกงาน IDแล้วใช้ Jobs.Wait ถึง Jobs.Result. Bulk จัดการกับชุดข้อมูลขนาดใหญ่และงานที่ใช้งานได้อีกครั้ง
Account
อ่านอัตลักษณ์ ดุลยภาพ ค่านิยม ข้อจํากัด และการใช้งาน ก่อนงานไม่มีกําหนด ใช้ลูกความเดียวกันและกุญแจที่ได้รับอนุญาต
WithFormat
ต้องการ JSONข้อความธรรมดาหรือ Markdown ด้วยตัวเลือกการจัดรูปแบบ Markdown รูปแบบการรับข้อมูลจากตัวแทนของคุณ; การแจ้งรุ่นของโปรแกรมหรือผลรวม

Go ชนิด

Google สืบค้น Input อธิบายคําค้น พารามิเตอร์ทางเลือก ใช้ตัวชี้ เช่น flashdata.Ptr(inT64)5)). ผลลัพธ์มีแหล่ง JSONสืบค้นเมื่อคุณต้องการช่องข้อมูลที่พิมพ์แล้ว

ถัดไป

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

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