İndeksleme API’si URL bildirimini veya yönetilen gönderimi otomatikleştirir; ancak her API’nin uygunluğu ve kanıtı farklıdır. Entegrasyon öncesinde Google’ın sınırlı API’sini, IndexNow’ı ve ticari REST akışlarını karşılaştırın.
URL indeksleme API’si; URL gönderimini, değişiklik bildirimini veya işlem takibini otomatikleştiren arayüzdür. Bu ifade farklı ürünleri kapsar: Google Indexing API belirli yapılandırılmış veri sayfalarıyla sınırlıdır, IndexNow yayıncının kontrol ettiği değişiklikleri katılımcı motorlara bildirir, ticari REST API’leri ise ücretli gönderim iş akışlarını yönetir. Yanlış sınıfı seçmek politika ihlali, çift ücret veya yanıltıcı durum raporu oluşturabilir.
API türlerinin karşılaştırması
| API türü | Amaçlanan kullanım | Kimlik doğrulama | Tipik yanıt | Önemli sınır |
|---|---|---|---|---|
| Google Indexing API | Uygun iş ilanı ve canlı yayın sayfaları | Google Cloud ve OAuth/servis hesabı | Bildirim meta verisi | Genel web sayfası indeksleme API’si değildir |
| IndexNow | Kontrol edilen hostta eklenen, güncellenen veya silinen URL | Host anahtarı | Bildirim kabulü | Katılımcı motorlar tarama ve indekse karar verir |
| Yönetilen REST servisi | Yetkili URL işleri, bakiye ve durum akışı | Sağlayıcı API anahtarı | İşlem ID, kabul edilen adet, durum | Koşul, fiyat ve tanımlar değişir |
Google Indexing API uygunluk tuzağı
Geliştirici bir kod örneği bulup her URL’yi gönderebileceğini düşünebilir. Google’ın resmî dokümanı, gerekli yapılandırılmış veriye sahip iş ilanı ve canlı yayın sayfalarını belirtir. Genel makale veya backlink hattını bu endpoint üzerine kurmak amaçlanan kullanım değildir.
Normal sahip olunan sayfalarda taranabilir linkler, sitemap ve Search Console teşhisine odaklanın. Teknik olarak başarılı HTTP çağrısını Google’ın genel indeks akışını onayladığı iddiasına çevirmeyin.
Değişiklik bildirim API’si olarak IndexNow
IndexNow yayıncı kontrolü üzerine kuruludur. Anahtar barındırır veya yapılandırır, ardından URL değişikliklerini katılımcı motorlara bildirirsiniz. Periyodik yeniden taramayı beklemenin verimsiz olduğu CMS yayınları, stok değişiklikleri ve silme işlemleri için uygundur.
İyi uygulamalar:
- yalnızca anlamlı eklenen, güncellenen veya silinen URL’leri gönderin;
- kuyruğa almadan host ve URL’yi normalize edin;
- aynı URL’ye tekrarlı güncellemeleri birleştirin;
- geçici hataları artan bekleme ile tekrar deneyin;
- yanıt zamanı ve durumunu kaydedin;
- sitemap ve iç link keşfini sağlıklı tutun.
Yönetilen REST API ne sunmalı?
Ticari API finansal ve operasyonel sözleşmeyi açık hâle getirmelidir. En az şu özellikleri arayın:
- HTTPS ve sunucu tarafı API anahtarı;
- belgelenmiş istek/yanıt şeması;
- sabit işlem kimliği;
- tekrar ve idempotency davranışı;
- istek ve işlem başına maksimum URL;
- hız limiti başlıkları veya belgeli limit;
- bakiye endpoint’i ve fiyat hesabı;
- işlem ve URL sonuçlarında sayfalama;
- açık durum sözlüğü;
- doğrulama, bakiye ve servis erişimi için öngörülebilir hata kodları.
Index Grab müşteri REST API’si etkin olduğunda hesap kapsamlı anahtar, URL gönderimi, bakiye, işlem geçmişi, istatistik ve durum sorgulama etrafında tasarlanır. Anahtar public tarayıcı JavaScript’inde değil, sunucuda tutulmalıdır.
Idempotency pahalı tekrarları önler
Ağ zaman aşımı belirsizlik yaratır: istemci yanıtı alamasa bile sunucu işlemi kabul etmiş olabilir. Sağlam istemci idempotency anahtarı veya sabit müşteri referansı gönderir ve aynı mantıksal isteği aynı değerle tekrarlar.
Idempotency yoksa retry ikinci ücretli işlem oluşturabilir. Sağlayıcı özelliği sunmuyorsa istemci yeniden denemeden önce kendi referansıyla son işlemleri sorgulamalı ve aynı paket gönderimlerini sıralamalıdır.
Hız limiti işlem boyutu limiti değildir
Hız limiti istemcinin API’yi ne sıklıkla çağıracağını; işlem boyutu limiti tek isteğin kaç URL içereceğini belirler. Farklı problemleri çözerler.
200 URL için istemci tek mantıksal işlem gönderebilir, servis iç paketleri kontrollü işleyebilir. Public API sözleşmesi müşteriyi özel worker davranışını taklit etmeye zorlamamalıdır. Belgeli istek maksimumuna uyun ve hızlı sorgu yağmuru yerine artan aralıkla işlem endpoint’ini kontrol edin.
Entegrasyon güvenlik listesi
- API anahtarını ortam değişkeni veya secret manager’da saklayın.
- Canlı anahtarı frontend JavaScript, mobil binary veya public repoya koymayın.
- Destekleniyorsa ortam başına ayrı anahtar kullanın.
- Authorization başlığını log ve hata raporlarından temizleyin.
- Göndermeden önce her URL’yi doğrulayın.
- Bağlantı ve toplam zaman aşımı belirleyin.
- Yalnızca güvenli ya da idempotent işlemleri tekrar deneyin.
- Anahtar ifşa olursa hemen döndürün.
- Entegrasyonu yetkili URL’lerle sınırlayın.
Taşınabilir entegrasyon akışı
- Yetkili URL listesini normalize edip tekrarı kaldırın.
- Şema, host, uzunluk ve maksimum paket boyutunu doğrulayın.
- Güncel fiyatı alın veya belgeli kuraldan hesaplayın.
- Sabit müşteri referansıyla tek mantıksal işlem oluşturun.
- Başarı göstermeden dönen işlem ID’sini kaydedin.
- Artan aralıklarla sorgulayın veya belgeli webhook kullanın.
- Gönderildi durumunu indekslendi diye yeniden adlandırmadan eşleyin.
- Düşülen tutar, kabul edilen URL ve son işlem durumunu mutabık kılın.
Bu akış dil SDK’sına değil standart HTTPS ve JSON’a dayandığı için PHP, Node.js, Python, Java ve diğer sunucu ortamlarında çalışır.
Birincil kaynaklar
Sık Sorulan Sorular
Her URL indeksleme API’si Google API’si midir?
Hayır. Bazıları resmî arama motoru arayüzü, bazıları IndexNow uygulaması, bazıları ise gönderim işlerini yöneten ticari servistir. Kapsam ve kanıtları farklıdır.
İndeksleme API anahtarı tarayıcı JavaScript’ine konur mu?
Hayır. İstemci kodundaki canlı secret çıkarılıp kötüye kullanılabilir. İsteği güvenli sunucunuzdan gönderin ve anahtarı public kod dışında tutun.
200 URL gönderirsem ne olur?
Belgeli işlem boyutu limitine bağlıdır. İyi servis mantıksal işlemi kabul edip kontrollü paketlerde işleyebilir. İstemci public sözleşmeye uymalı ve API’yi istek yağmuruna tutmadan dönen işlemi sorgulamalıdır.
Idempotency neden gerekir?
Zaman aşımından sonraki yeniden denemenin ikinci mantıksal işlemi oluşturup ücretlendirmesini önler. Aynı amaçlanan gönderim için aynı idempotency anahtarını kullanın.
Bu rehber, Index Grab editoryal ekibi tarafından kamuya açık arama motoru dokümantasyonu ve uygulanabilir teknik SEO kontrolleri kullanılarak hazırlanıp gözden geçirilmiştir. Ürün özellikleri ve fiyatlar yayın öncesinde güncel Index Grab arayüzünden doğrulanır.
Birincil kaynaklar: Google Search Central · Sitemaps.org · Schema.org