Belgeleri incele
Başlarken
Aynı Google aramayı imzalamadan önce deneyin, o zaman aynı CLI profili kullanmaya devam etmek için bir sahibi hesabı bağlayın.
Bu sayfada
1. Mevcut erişim kontrolü
Bu ücretsiz check in your agent's environment. data.accessVerified, true ve Google Search'ye izin verilirse, 3'ye adım atabilir. Hiçbir kurtarma profili olmadan, 2'yu adım atmaya devam edin. Aşağıdaki kurtarma bölümünü kullanarak devam eden veya bloke edilen erişim.
flashdata auth status --json --non-interactiveAynı profili Keep the same profile
Çalışma erişim raporları data.accessVerified: true, access: ready içeri in in in In in in içinde data.identity.identityVe google_search içeri in in in In in in içinde data.identity.permittedSources.
Bu komutlar, Bash veya PowerShell'da varsayılan profili ve çalışmasını kullanır. Mevcut bir profil veya özel devlet rehberi için, aynı --profile NAME ve --state-dir ABSOLUTE_PATH'yu yeni bir terminalde de dahil olmak üzere her komuta gönderin.
FLASHDATA_API_KEY, kayıtlı anahtardan önceliklidir. Bu profilin deneme erişimini ve kimlik bilgisi devrini test ederken bu değişkeni ayarlamayın. Aynı OS kullanıcısını kullanın ve özel durum dizinini koruyun; bu dizin kimlik bilgilerini, kayıt kanıtını ve çalıştırma geçmişini içerir.
Inspect credentialProtection içeri in in in In in in içinde auth status. Windows Kullanım kullanım kullanımı kullanır DPAPI, macOS Kullanım kullanım kullanımı kullanır KeychainVe kafasız Linux Bir sahibi yalnızca credential dosyasını kullanabilir. Mevcut bir an mevcut OS Dükkanlar ile gerekli olabilir --credential-store Os.
Bunun yerine mevcut bir sahibinin anahtarını kullanın
Bir terminaldeki bir kişi aşağıda gizli bir şekilde anahtar ithal edebilir ve deneme kayıtlarını atlayabilir ve iddia edebilir. Ajanslar bunu tedarik etmeli stdin with with with ile --api-key-stdin --non-interactive Gizli mağazalarından; asla tartışma veya sohbette bir anahtar koymayın.
Profil zaten farklı erişime sahipse, auth login --replace kullanarak önce gözden geçirin. Başka bir anahtarı ithal etmek iddia elioff değildir. MCP OAuth aynı zamanda ayrı bir ev sahibi bağlantıdır.
flashdata auth login
flashdata auth status --json --non-interactive2. Uygun bir deneme başlatın
discover ilk önce. data.onboardingAvailable ve data.onboarding.trial'daki ödenekleri kontrol edin. Eğer dolap mevcutsa, init için bir kez Google Search çalıştırın. Sunucu uygunluk kontrol eder; CLI, açılış işareti olmadan geçici anahtarı kurtarır veya bir sorgu gönderir.
flashdata discover --json --non-interactiveflashdata init --name "Research assistant" --scopes google_search --json --non-interactiveKayıt makbulunu kontrol edin
ok: true, data.status: trial ve google_search'u data.connection.scopes'da bekliyor. data.connection.trialExpiresAt ve data.startingAllowanceCredits'u okuyun. Anahtar yerel olarak kurtarılır, basılı değil. data.currentBalanceAvailable, false ise, sorgulanmadan önce ücretsiz bakiye kontrolü yeniden çalıştırın.
Kurulum zaten erişim yarattıysa, yeniden kullanın. Bir ajanın ilk kayıtlarını etiketlemek için, --client codex --audience coding veya --client openclaw --audience personal. Yeniden denemede tam giriş yapın; etiketler izin vermez.
Deneme izni ve sınırları
İstek eşdeğerleri aynı başlangıç kredi dengesini paylaşıyor; geri kalan istekler veya bağımsız kotalar değiller. YouTube Download gibi sadece kaynaklar deneme kredilerini yapamaz.
| Limit Sınır sınırı | Ne kontrol etmek için |
|---|---|
| Kredi / genişlet | Mevcut varsayılanlar: 1 kredi için 72 saatler. hibe ve yaşam için keşif okuyun; makbuz expiry'ye verir ve kaynaklar verilir. |
| Kayıt Kaydı Kayıt Kayıt Kayıt Kaydı | 3 IP başına kayıt kayıtları 24 Saatler, o IP kullanıcıları tarafından paylaşılan. Küresel deneme kapağı da yeni kayıtları durdurabilir. |
| Concurrency | Deneme görevlerini sırayla çalıştırın: her batch içinde bir öğe ve aynı anda bir bekleyen iş. Daha fazlasını göndermeden önce yanıttaki sınırları kontrol edin. |
3. Bir arama deneyin
İlk önce. Gereklilik Gereklilik data.estimateAvailable, mevcut bir google_search fiyat fiyat fiyatı data.estimate.pricesVe availableCredits Tartla estimatedCredits. Bir çek başarısız olursa durdurun. Tanıtım ücretsizdir; bir sonraki komut bir arama gönderir.
flashdata account balance --json --non-interactive
flashdata search "battery recycling" --num 5 --dry-run --json --non-interactiveflashdata search "battery recycling" --num 5 --run-id trial-search --json --non-interactiveSonucu kontrol edin
ok: true ve data.status: done'u bekleyin. Başlıkları, bağlantıları ve parçaları okuyun data.results[].organic, ve sorumlu data.usage.credits. Boş organik sonuçlar geçerlidir. Bahsedilmeden önce, bu kesin görevi trial-search ile tekrarlayın, kurtarılan sonucu döndürür. Profili ve devleti tut ve ihtiyacınız olan herhangi bir deneme sonuçlarını tut.
flashdata account balance --json --non-interactive4. Bir sahibi hesabı ile erişim tutun
Denemeden önce talep devam etmek veya tekrarlamak istiyorsanız sona erer. Sahibi hazır olduğunda, bunu orijinal profilde çalıştırın. Sadece data.claimUrl ve data.confirmationCode'u onlarla paylaşın; data.expiresAt son tarih verir.
Bağlantı 15 dakika geçerlidir; deneme daha erken sona ererse bağlantı da sona erer. Bağlantıyı oluşturmak erişimi onaylamaz veya kredi satın almaz.
flashdata auth claim --json --non-interactiveTarayıcıda Approve
- Sahibi bağlantı ve işaretleri açar veya yeni bir hesap yaratır ve e-postayı verir. Yeni bir işaret doğrulamadan sonra iddiayı yeniden başlatır.
- Talep sayfasında gösterilen hesabı kontrol edin. Farklı veya yeni bir sahibi için, ayrı bir tarayıcı seansı kullanın. İmzalanan hesabı, daha sonra talepler için ödeyecek olan hesaptır.
- Bu sayfada sekiz dijital kod girin, ürün izinlerini gözden geçirin ve paylaşılan-balance erişim, sonra onaylayın. Sahibi işaret eder, yasal kabul, e-posta doğrulama ve onay alır.
Orijinal terminalde bitirin
Onaylandıktan sonra, koşmak finish Orijinal profil içinde 24 saatler. CLI, sahibi anahtarı kurtarır, taze bir süreçte bunu doğrular ve yüklemeyi kabul eder. Tarayıcıdan anahtar kopyalanmaz.
flashdata auth finish --wait --timeout 10m --json --non-interactiveflashdata auth status --json --non-interactive
flashdata account balance --json --non-interactiveSahibi onaylayın ve dengeyi onaylayın
auth status, amaçlanan accountId'u doğrulayın ve aşağıdaki alanlardan yararlanın. Taze bakiyeyi ayrı okuyun; gelecekteki talepler sahibinin ortak kredilerini harcar. Kullanılmamış geçici krediler transfer edilmez. Yeni bir hesap normal işaretleme uygunluk takip eder; iddia edilen ekstra işaret hibesi yoktur.
Faturalı hesabı değiştirir. Sahibi altında yeni bir görev için, yeni bir run ID. seçin. Bir deneme çalıştırmak için ID, run_account_mismatch'u başka bir sorgu göndermeden döndürür; bu sahibine giden transfer değildir.
{
"ok": true,
"data": {
"accessVerified": true,
"identity": {
"identity": {
"accountType": "owned",
"access": "ready",
"installed": true,
"recurringAllowed": true
}
}
}
}Ürün izinlerini seçin
HTTP izin kataloğu trialEligible ile ownerAllowed değerlerini ayırır. İlk kayıttan önce yalnızca görevinizin gerektirdiği kaynakları isteyin. requestedScopes istenen izinleri, scopes ise anahtarın mevcut erişimini gösterir. Yeni ürünler için açıkça izin verilmesi gerekir.
Onay, satın alınan krediler dâhil hesap sahibinin ortak bakiyesinin kullanılmasına izin verir. Kaynak kısıtlamaları ajan başına harcama sınırı oluşturmaz. MCP OAuth ayrı bir bağlantıdır ve bu CLI profilini hesaba bağlamaz.
Sadece YouTube Download'a mı ihtiyacınız var?
youtube_download iznine sahip bir hesap sahibi anahtarını içe aktarın, ardından hedef depolamayı yapılandırın. Download geçici deneme kredilerini kullanmaz.
CLI 1.2.1 hala init için uygun bir deneme kaynağı gerektirir. Yalnızca işaret etmeden önce yükleme için HTTP iddia akışını auth.md'da kullanın. Bu müşteri kısıtlamasını atlamak için ilgili bir deneme kaynağı eklemeyin.
Resume a stop flow
| Ne durdu? | Sonraki eylem |
|---|---|
| Register Register Register | 429 için Retry-After süresini bekleyin. Yanıt kaybolduysa init komutunu aynı profil, kanıt ve aynı girdilerle tekrarlayın. Mevcut durumu koruyun; IP değiştirmeyin ve yerine yeni deneme başlatmayın. |
| Ara | Aşağıdaki trial-search kaydını inceleyin. Zaman aşımı, işin kabul edilmediğini kanıtlamaz; yeniden denemeyi zorlamak için çalıştırma ID değerini değiştirmeyin. |
| Talep Linki | Bağlantının süresi dolmuş ancak deneme hâlâ geçerliyse, hesap sahibi hazır olduğunda aynı profilde yeni bağlantı oluşturun. Onaydan önce oturum açmış hesabın doğru olduğunu kontrol edin. |
| Handoff | Onaydan sonra, yenidenrun auth finish Orijinal profil içinde 24 saatler. Pending onayı, kesintili bir bekle ya da kayıp bir onay yeni bir kayıt gerektirmez. |
| Açıklama / kayıp devlet | Geç bir deneme veya eloff veya kayıp bir özel devlet rehberi için, sahibi onaylı bir yeniden bağlantı kullanın veya bir sahibi anahtar ithal edin. |
flashdata runs show trial-search --json --non-interactive