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