Giriş ve Temel Kavramlar
Search Console API, Google’ın webmasterlara sunduğu güçlü bir araçtır. Bu API sayesinde, web sitenize ait verileri programatik olarak çekebilir, analizleri otomatikleştirebilir ve raporları özelleştirebilirsiniz. Kullanımı, özellikle büyük web projelerinde ve düzenli veri güncellemeleri gereken durumlarda oldukça avantaj sağlar. API, RESTful mimarisiyle tasarlandığından, HTTP protokolü üzerinden erişim mümkündür ve JSON formatında veri döner.
API'ye Erişim ve Yetkilendirme
İlk adım, Google Cloud Console üzerinde proje oluşturmaktır. Bu projeye Search Console API'yi etkinleştirdikten sonra, OAuth 2.0 veya API anahtarı kullanarak yetkilendirme işlemini gerçekleştirmelisiniz. OAuth 2.0, özellikle kullanıcı verilerine erişim sağlarken tercih edilir; API anahtarı ise genel ve sınırlı erişimlerde kullanılır. Yetkilendirme süreci tamamlandıktan sonra, API istemcisi veya doğrudan HTTP istekleriyle API çağrılarına başlayabilirsiniz.
Temel API Kullanım Adımları
- Yetkilendirme ve Erişim Token’ı Alma: OAuth 2.0 kullanıyorsanız, token alımı için uygun akışları takip etmek gerekir. Bu, kullanıcıdan izin almayı ve erişim token’ı üretmeyi içerir.
- API Endpoint’lerine İstek Gönderme: Örneğin, sıralama ve tıklama verilerini çekmek için https://searchconsole.googleapis.com/v1/sites ve ilgili yöntemleri kullanmalısınız.
- Veri Çekme ve İşleme: Gelen JSON verisini, ihtiyaçlarınıza göre filtreleyebilir, görselleştirebilir veya raporlar oluşturabilirsiniz.
Örnek Kullanım ve Kod Parçaları
Aşağıda, Python dilinde Google API Client Library kullanarak temel bir API çağrısı örneği verilmiştir:
123456789101112131415161718192021
from googleapiclient.discovery import build
from oauth2client.service_account import ServiceAccountCredentials
SCOPES = ['https://www.googleapis.com/auth/webmasters.readonly']
SERVICE_ACCOUNT_FILE = 'path/to/your/service-account.json'
credentials = ServiceAccountCredentials.from_json_keyfile_name(
SERVICE_ACCOUNT_FILE, scopes=SCOPES)
service = build('searchconsole', 'v1', credentials=credentials)
site_url = 'https://www.orneksite.com/'
request = {
'startDate': '2024-01-01',
'endDate': '2024-02-01',
'dimensions': ['query'],
'rowLimit': 10
}
response = service.searchanalytics().query(siteUrl=site_url, body=request).execute()
print(response)
Bu kod, belirli bir tarih aralığında en çok tıklanan sorguları listeleyecektir. API kullanımı, ihtiyaçlara göre farklı raporlar ve detaylar eklenerek genişletilebilir.
Sonuç ve Değerlendirme
Search Console API, teknik açıdan detaylı ve oldukça esnektir. Doğru yapılandırma ve yetkilendirme ile, web sitenizin performansını düzenli takip edebilir, SEO stratejilerinizi güçlendirebilirsiniz. API’nin kapsamını ve sınırlarını dikkatli incelemek, daha verimli sonuçlar almanızda faydalı olacaktır.
