Bu belgede, Temel Raporlama ve Meta Veri API'leri için verilerin kullanımdan kaldırılması politikası açıklanmaktadır.
Genel bakış
Boyutlar ve metrikler (sütunlar), Google Analytics Reporting API'lerini sorgulamak için kullanılır. Bazen bu sütunları eklemek, kaldırmak veya yeniden adlandırmak gerekebilir. Bu verilerin ne şekilde uygulandığına dair şeffaflığı artırmak için verilerin kullanımdan kaldırılması politikası yayınlanmıştır.
Tüm sütun değişiklikleri, değişiklik günlükleri aracılığıyla bildirilir ve Meta Veri API'si bu değişiklikleri yansıtacak şekilde otomatik olarak güncellenir.
Bu politika neleri kapsar?
Bu politika, genel API'ler tarafından kullanıma sunulan boyut ve metrikleri kapsar. API isteğini (sorgu parametreleri), API yanıtını, API tarafından döndürülen değerleri veya boyutların ve metriklerin geçerli kombinasyonlarını kapsamaz.
Yeni Veriler
API'ye yeni sütunlar eklendiğinde:
- İlgili API'nin changelog bölümü, yeni sütunlarla ilgili ayrıntılarla güncellenir.
- Sütunlar, Meta Veri API'sinde kullanılabilir hale gelir.
Veri Kaldırma
Bir API'den sütun kaldırıldığında:
- İlgili API'nin changelog bölümü, kaldırılan sütunlarla ilgili ayrıntılarla güncellenir.
- Meta Veri API'sinde
status
sütunu özelliğiDEPRECATED
olarak ayarlanır. - Sütunlar, raporlama sorgularında en az 6 ay boyunca çalışmaya devam eder.
- 6 ay sonra sütunlar Meta Veri API'sinden kaldırılır ve raporlama API'sinde sütunları sorgulamak
400 Bad Request
hatasına neden olur.
Verileri Yeniden Adlandırma
Sütunlar yeniden adlandırıldığında:
- İlgili API'nin changelog bölümü, orijinal ve değiştirme sütunlarıyla ilgili ayrıntılarla güncellenir.
- Meta Veri API'sinde, orijinal sütunun
status
özelliğiDEPRECATED
olarak vereplacedBy
özelliği, yeni sütunun kimliği olarak ayarlanır. - Orijinal sütunlar, raporlama sorgularında en az 6 ay boyunca çalışmaya devam eder.
- 6 ay sonra, orijinal sütunlar Metadata API'den kaldırılır ve Reporting API'de sütunların sorgulanması,
400 Bad Request
hatasıyla sonuçlanır.
Özellik Kaldırma
Özellikler Metadata API'den kaldırıldığında:
- Meta Veri API değişiklik günlüğü, kaldırılan özelliklerle ilgili ayrıntılarla güncellenecektir.
- Özellikler, en az 6 ay boyunca Meta Veri API'sinde kullanılabilir olmaya devam edecek.
- 6 ay sonra özellikler Meta Veri API'sinden kaldırılır.
Gruplar
Bazen bir grubun adının veya sütunların sırasının değiştirilmesi gerekir. Bu durumda:
- Meta Veri API değişiklik günlüğü, grup adı ve değişiklik sıralamasıyla ilgili ayrıntılarla güncellenecektir.