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 membuat kueri Reporting API Google Analytics. Terkadang Anda perlu menambahkan, menghapus, atau mengganti nama kolom ini. Kebijakan penghentian penggunaan data disediakan untuk meningkatkan transparansi terkait proses perubahan ini.

Semua perubahan kolom akan dikomunikasikan melalui changelog dan Metadata API akan otomatis diperbarui untuk mencerminkan perubahan ini.

Yang Tercakup dalam Kebijakan Ini

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

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 pelaporan kueri selama minimal 6 bulan.
  • Setelah 6 bulan, kolom tersebut akan dihapus dari Metadata API dan pembuatan kueri untuk kolom di 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.
  • Dalam Metadata API , atribut status kolom asli akan disetel ke DEPRECATED dan atribut replacedBy akan disetel ke ID kolom pengganti.
  • Kolom asli akan terus berfungsi dalam pelaporan kueri selama minimal 6 bulan.
  • Setelah 6 bulan, kolom asli akan dihapus dari Metadata API dan pembuatan kueri untuk kolom di Reporting API akan menghasilkan error 400 Bad Request.

Penghapusan Atribut

Jika atribut dihapus dari Metadata API:

  • Log perubahan Metadata API akan diperbarui dengan detail mengenai atribut yang dihapus.
  • Atribut tersebut 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: