Search Console'un API'sinde güncellemeler

9 Aralık 2020, Çarşamba

Birkaç ay önce, Search Console API'sinin performansının iyileştirilmesine yönelik talebin artmasına bağlı olarak API altyapısının güncellendiğini duyurmuştuk. Bugün, kullanımınıza bazı güncellemeler daha sunduğumuzu duyurmaktan mutluluk duyuyoruz.

API çağrılarınızı kendiniz geliştiriyorsanız aşağıdaki açıklamaları okumanız önerilir.

Search Console API'de yeni veri ve haber filtresi

Performans raporu halihazırda bir günden daha kısa süreye ait yeni verileri destekliyor. Artık, all değerine ayarlanmış dataState istek parametresi ileterek API aracılığıyla bu verilere erişebilirsiniz. Bu değer için aldığınız veriler, henüz nihai olmayan yeni verileri de içerir. Yalnızca nihai verileri almak istiyorsanız bu parametreyi final değerine ayarlanmış olarak iletebilir veya hiç iletmeyip varsayılan olarak yalnızca nihai verileri alabilirsiniz.

Birkaç ay önce, Performans raporunda Arama filtresine Haberler sekmesi ekledik. Bu bilgiler artık API'de de kullanıma sunuldu. İstekte searchType parametresini news değerine ayarlayarak bu bilgilere erişebilirsiniz.

Sitemaps API'de alan mülkü desteği

Diğer Search Console API'lerinde olduğu gibi Site Haritaları API'si de artık alan mülklerini destekliyor. Alan mülklerinde site haritanızı sorgulayabilir, ekleyebilir ve silebilirsiniz. Örneğin:

GET https://www.googleapis.com/webmasters/v3/sites/sc-domain:example.com/sitemaps

Keşif dokümanını taşıma

Web yöneticileri keşif dokümanı artık desteklenmeyecek. Search Console API'yi harici API kitaplığı kullanarak sorguluyorsanız veya Webmasters API keşif dokümanını doğrudan sorguluyorsanız API çağrılarınızı aşağıdaki değişiklikleri içerecek şekilde güncellemeniz gerekir:

API kitaplığı değişiklikleri

API kitaplığı değişiklikleri hakkında bilgi içeren güncel bir API kullanım kılavuzu için Java ve Python hızlı başlangıç kılavuzlarına bakın.

Java

Web yöneticileri hizmeti ile ilgili tümiçe aktarmalarda, webmasters paketini searchconsole.v1 paketi ve hizmet adını (Webmasters) SearchConsole olarak değiştirin. Örnekler:

  • API hizmetini içe aktarma:

    import com.google.api.services.webmasters.Webmasters;

    import com.google.api.services.searchconsole.v1.SearchConsole;

  • Yanıt nesnesini içe aktarma:

    import com.google.api.services.webmasters.model.WmxSite;

    import com.google.api.services.searchconsole.v1.model.WmxSite;

Hizmet nesnesinin yanı sıra, diğer API nesnelerinin de öncekiyle tam olarak aynı olduğunu unutmayın. Yalnızca paket değişir.

Python

Webmasters hizmet nesnesi oluştururken aşağıdaki değişikliği yapın:

webmasters_service = build('webmasters', 'v3', http=http)

webmasters_service = build('searchconsole', 'v1', http=http)

Benzer şekilde, nesnelerin davranışında herhangi bir değişiklik yoktur.

Doğrudan keşif dokümanı sorgusu

Keşif dokümanı sorgulama değişiklikleri şunlardır:

  • URL değişikliği

    https://www.googleapis.com/discovery/v1/apis/webmasters/v3/rest

    https://searchconsole.googleapis.com/$discovery/rest

  • İçerik değişikliği
    • webmasters olan name alanı, searchconsole olarak değiştirildi.
    • v3 olan version alanı, v1 olarak değiştirildi.

Sorularınız varsa Arama Merkezi topluluğunda veya Twitter'da sorabilirsiniz.

Yayınlayan: Nati Kaptan, Gilad Amar ve Michael Huzman, Search Console ekibi