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

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

Yang Tercakup oleh Kebijakan Ini

Kebijakan ini mencakup dimensi dan metrik yang diekspos oleh API publik. Laporan 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:

  • changelog pada API yang terkait akan diperbarui dengan detail tentang kolom baru.
  • Kolom akan tersedia di Metadata API.

Penghapusan Data

Jika kolom dihapus dari API:

  • changelog pada API yang terkait akan diperbarui dengan detail tentang kolom yang dihapus.
  • Di Metadata API, atribut kolom status akan ditetapkan ke DEPRECATED.
  • Kolom akan terus berfungsi dalam kueri pelaporan selama minimal 6 bulan.
  • Setelah 6 bulan, kolom akan dihapus dari Metadata API dan kueri untuk kolom di Reporting API akan menghasilkan error 400 Bad Request.

Penggantian Nama Data

Jika nama kolom diganti:

  • changelog pada API yang terkait akan diperbarui dengan detail tentang kolom aslinya dan kolom 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 kueri untuk kolom di 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 ini 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 ini terjadi: