İçeriğe geç
TR
API anahtarı al
Belgeleri incele

Başlarken

Hızlı başlangıç

İlk Google aramanızı çalıştırın ve uygulamanız veya yapay zekâ ajanınız için yapılandırılmış sonuçlar alın.

Yapay zekâ ajanınızla başlayın

Bu istemi terminal erişimi olan bir ajana verin. Ajan FlashData’yı kurar ve bir arama çalıştırır.

İlk API çağrınızı yapın

Kodu kendiniz mi yazmak istiyorsunuz? Terminalde bu üç adımı izleyin.

  1. API anahtarı alın

    Hesap oluşturun, e-postanızı doğrulayın ve Google Search izni olan bir anahtar oluşturun. Böyle bir anahtarınız varsa yeniden kullanın.

    Terminalde çalıştırın ve anahtarı gizli giriş istemine yapıştırın. FLASHDATA_API_KEY zaten ayarlıysa bu adımı atlayın.

    Anahtarınızı ayarlayın
    # 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
  2. Arama çalıştırın

    Bir dil seçin ve örneği aynı terminalde çalıştırın. Her çalıştırma bir arama gönderir.

    Python 3.10+ · Örneği quickstart.py olarak kaydedin.

    Yükle
    python -m pip install "flashdata==1.1.0"
    quickstart.py
    import json
    import os
    from flashdata import FlashData
    
    with FlashData(api_key=os.environ["FLASHDATA_API_KEY"]) as client:
        response = client.google.search("battery recycling research", num=5)
        if response["status"] != "done":
            raise RuntimeError(response)
        print(json.dumps(response, indent=2))
    Çalıştır
    python quickstart.py
  3. Sonucu kontrol edin

    Başarılı yanıtta status: done bulunur. Kaynaklar results[].organic, kullanılan krediler ise usage.credits alanındadır.

    Örnek yanıt (kısaltılmış)
    {
      "status": "done",
      "results": [
        {
          "organic": [
            {
              "title": "Battery recycling research",
              "link": "https://example.org/recycling",
              "snippet": "An example search excerpt."
            }
          ]
        }
      ],
      "usage": {
        "credits": 0.02
      }
    }

Konsolu deneyin

  1. Hesap oluşturun veya oturum açın. E-posta doğrulamasını ve konsolda gösterilen hesap kurulum adımlarını tamamlayın.
  2. Google Search sayfasını açın, Google Search kaynağını ve Realtime modunu seçip battery recycling research yazın. Additional parameters bölümünü açın ve Page size (num) değerini 5 yapın.
  3. Gösterilen isteği ve kullanılabilir kredileri kontrol edip aramayı bir kez çalıştırın.
  4. Yanıtı ve kullanımı inceleyin. Alıntının ötesinde bir bilgiyi kaynak göstermeden önce dönen kaynağı açıp içeriğini kontrol edin.

İlk sonuçtan devam edin

İlk istek başarısız olursa

FLASHDATA_API_KEY eksik
Anahtarı örneğin çalıştığı terminalde veya çalışma ortamında ayarlayın. Bu örnekler .env dosyalarını yüklemez.
401 / 403
Anahtarın veya bağlantının etkin olduğunu ve google_search izni bulunduğunu kontrol edin.
402
Billing bölümünde kullanılabilir kredileri kontrol edin. Hesap sahibi erişimi gerekiyorsa mevcut denemeyi hesabınıza bağlayın.
429
Retry-After değerine uyun. Aynı kimliği ve kayıt kanıtını koruyun; başka bir deneme oluşturmayın.
Zaman aşımı veya gönderim durumu bilinmiyor
Yeniden denemeden önce mevcut çalıştırmayı inceleyin. CLI kullanıcıları aynı profili ve çalıştırma kimliğini korumalı; SDK/API kullanıcıları döndürülen iş veya istek kimliğini kaydetmelidir.