Kebijakan Penghentian Penggunaan Data untuk Google Analytics API

Dokumen ini menjelaskan kebijakan penghentian penggunaan data untuk Core Reporting dan Metadata API.

Ringkasan

Dimensi dan metrik (kolom) digunakan untuk mengkueri Google Analytics Reporting API. Terkadang, Anda perlu menambahkan, menghapus, atau mengganti nama kolom ini. Kebijakan penghentian penggunaan data disediakan untuk meningkatkan transparansi terkait bagaimana perubahan ini dilakukan.

Semua perubahan kolom akan dikomunikasikan melalui log perubahan dan Metadata API akan otomatis diupdate untuk mencerminkan perubahan ini.

Yang Tercakup dalam Kebijakan Ini

Kebijakan ini mencakup dimensi dan metrik yang ditampilkan oleh API publik. Topik ini tidak mencakup permintaan API (parameter kueri), respons API, nilai yang ditampilkan oleh API, atau kombinasi valid dari dimensi dan metrik.

Data Baru

Saat kolom baru ditambahkan ke API:

Penghapusan Data

Jika kolom dihapus dari API:

  • Log perubahan API terkait akan diperbarui dengan detail tentang kolom yang dihapus.
  • Dalam Metadata API, atribut kolom status akan ditetapkan ke DEPRECATED.
  • Kolom ini akan terus berfungsi dalam kueri pelaporan selama minimal 6 bulan.
  • Setelah 6 bulan, kolom tersebut akan dihapus dari Metadata API dan pembuatan kueri untuk kolom dalam Reporting API akan menghasilkan error 400 Bad Request.

Penggantian Nama Data

Jika nama kolom diganti:

  • Log perubahan API terkait akan diperbarui dengan detail tentang kolom asli dan pengganti.
  • Di Metadata API , atribut status dari kolom asli akan ditetapkan ke DEPRECATED dan atribut replacedBy akan ditetapkan ke ID kolom pengganti.
  • Kolom asli akan terus berfungsi dalam kueri pelaporan selama minimal 6 bulan.
  • Setelah 6 bulan, kolom asli akan dihapus dari Metadata API dan pembuatan kueri untuk kolom dalam Reporting API akan menghasilkan error 400 Bad Request.

Penghapusan Atribut

Saat atribut dihapus dari Metadata API:

  • Log perubahan Metadata API akan diperbarui dengan detail tentang atribut yang dihapus.
  • Atribut akan terus tersedia di Metadata API selama minimal 6 bulan.
  • Setelah 6 bulan, atribut akan dihapus dari Metadata API.

Grup

Terkadang, Anda perlu mengubah nama grup atau urutan kolom. Jika hal ini terjadi: