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:
- Log perubahan API terkait akan diperbarui dengan detail tentang kolom baru.
- Kolom akan tersedia di Metadata 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 keDEPRECATED
. - 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 keDEPRECATED
dan atributreplacedBy
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:
- Log perubahan Metadata API akan diperbarui dengan detail mengenai nama grup dan perubahan urutan.