Pembaruan untuk Search Console API

Rabu, 9 Desember 2020

Beberapa bulan lalu kami mengumumkan upgrade infrastruktur API untuk meningkatkan performa Search Console API karena permintaan yang makin meningkat. Hari ini dengan senang hati kami umumkan bahwa beberapa pembaruan lainnya akan segera hadir:

  • Penambahan filter data dan berita terbaru di Search Console API
  • Dukungan properti domain di Sitemaps API
  • Panduan tentang cara memigrasikan dokumen Penemuan

Jika Anda melakukan panggilan sendiri ke API, baca informasinya.

Filter data dan berita terbaru di Search Console API

Laporan performa sudah mendukung data terbaru yang berusia kurang dari satu hari. Sekarang Anda dapat mengakses data ini melalui API dengan meneruskan dataState parameter permintaan dengan nilai yang ditetapkan ke all. Data yang Anda dapatkan untuk nilai ini juga akan mencakup data baru yang belum diputuskan. Jika hanya ingin memperoleh data akhir, Anda dapat meneruskan parameter ini dengan nilai yang ditetapkan ke final. Jika memilih tidak meneruskannya sama sekali, Anda hanya akan memperoleh data akhir secara default.

Beberapa bulan lalu, kami menambahkan tab Berita di filter Penelusuran ke Laporan performa. Informasi ini juga sekarang tersedia di API, dan Anda dapat mengaksesnya dengan menyetel nilai parameter searchType dalam permintaan ke news.

Dukungan properti domain di Sitemaps API

Sitemaps API kini mendukung properti domain, sama seperti Search Console API lainnya. Anda dapat membuat kueri, menambahkan, dan menghapus peta situs di properti domain, misalnya:

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

Migrasi dokumen penemuan

Kami akan menghentikan dukungan di dokumen penemuan Webmaster. Jika Anda membuat kueri untuk Search Console API menggunakan library API eksternal, atau untuk dokumen penemuan Webmaster API secara langsung, Anda harus memperbarui panggilan API untuk menyertakan perubahan berikut.

Perubahan library API

Untuk pembaruan tentang perubahan library API, lihat panduan memulai Java dan Python, untuk panduan penggunaan API yang diperbarui.

Java

Untuk semua impor terkait layanan Webmaster, ubah paket webmasters ke paket searchconsole.v1, dan nama layanan, Webmasters, ke SearchConsole. Contoh:

  • Mengimpor layanan API:

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

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

  • Mengimpor objek respons:

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

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

Perlu diketahui bahwa selain objek layanan, objek API lainnya sama persis seperti sebelumnya, hanya paket yang berubah.

Python

Saat mem-build objek layanan Webmaster, lakukan perubahan berikut:

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

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

Sekali lagi, tidak ada perubahan dalam perilaku objek.

Kueri dokumen penemuan langsung

Perubahan proses kueri dokumen penemuan mencakup:

  • Perubahan URL

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

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

  • Perubahan konten
    • Kolom name diubah dari webmasters menjadi searchconsole.
    • Kolom version diubah dari v3 menjadi v1.

Jika ada pertanyaan, Anda dapat bertanya di komunitas Pusat Penelusuran atau di Twitter.