Search Console'un Search Analytics API'si, web sitenizin arama performansını detaylı analiz etmenize olanak tanır. Node.js ortamında bu API'yi kullanmak, özellikle büyük veri setlerini otomatik raporlama ve analiz işlemlerinde oldukça faydalıdır. İşte temel yapı ve dikkat edilmesi gereken noktalar:
- Kimlik Doğrulama ve API Erişimi
Google API'lerine erişim için OAuth 2.0 veya servis hesabı kullanılır. En yaygın yöntem, serviss hesabıyla yetkilendirmektir. Öncelikle Google Cloud Console'da proje oluşturup, Search Console API'yi etkinleştirip, bir servis hesabı anahtarı (JSON dosyası) indiriyorsunuz. Bu anahtar, Node.js uygulamanızda kimlik doğrulama için kullanılacak.
- Google API Client Kütüphanesini Kullanma
Node.js için resmi Google API client kütüphanesini npm üzerinden yükleyebilirsiniz:
Bu kütüphane, API'ye erişim ve yetkilendirme işlemlerini kolaylaştırır.
- Temel Kod Yapısı
Aşağıda, Search Console'dan belirli bir tarih aralığında ve sorgu parametreleriyle veri çeken örnek bir kod parçası yer alıyor:
1234567891011121314151617181920212223242526const {google} = require('googleapis');
const path = require('path');
async function fetchSearchAnalytics() {
const auth = new google.auth.GoogleAuth({
keyFile: path.join(__dirname, 'servis-hesabi-key.json'),
scopes: ['https://www.googleapis.com/auth/webmasters.readonly'],
});
const authClient = await auth.getClient();
const webmasters = google.webmasters({version: 'v3', auth: authClient});
const response = await webmasters.searchanalytics.query({
siteUrl: 'https://ornekalan.com',
requestBody: {
startDate: '2023-01-01',
endDate: '2023-01-31',
dimensions: ['query', 'page'],
rowLimit: 1000,
},
});
console.log(response.data.rows);
}
fetchSearchAnalytics().catch(console.error);
- Çalışma Mantığı ve Dikkat Edilmesi Gerekenler
- siteUrl parametresi, Search Console'da doğruladığınız alan adıdır.
- API limitleri ve kota sınırlarına dikkat edin. Özellikle büyük veri çekiminde throttling sorunları yaşanabilir.
- Dimension ve filters kullanarak detaylı sorgular yapabilirsiniz.
- Çekilen veriyi uygun biçimde işleyerek, SEO stratejilerinizi geliştirmek için kullanabilirsiniz.
- Hata ve Çözüm
- Yetkilendirme hatası alırsanız, servis hesabınızın Search Console'da ilgili siteye erişim izni olup olmadığını kontrol edin.
- API limitleri veya yanlış site URL'si gibi sorunlarda, API dökümantasyonuna başvurmak ve hata mesajlarına göre hareket etmek gerekir.
Sorularınız veya belirli senaryolarınız varsa, detaylı yardım alabilmek için örnekleri de paylaşabilirsiniz. Bu konuda deneyiminiz veya karşılaştığınız sorunlar nelerdir?
