Giriş: Data Portability API'yi kullanarak uygulama geliştirme

Veri Taşıma API'si, Google hizmetlerindeki verilerin bir kopyasını uygulamanıza taşımak için kullanıcıdan yetki isteyen uygulamalar oluşturmanıza olanak tanır. Bu, veri taşınabilirliğini sağlar ve hizmet geçişini kolaylaştırır.

Kullanıcıların verileri nasıl paylaştığı hakkında bilgi edinmek istiyorsanız Verilerinizin kopyasını üçüncü taraflarla paylaşma başlıklı makaleyi inceleyin.

Ön koşullar

Uygulamanızı yayınlamadan önce Google tarafından onaylanması gerekir.

Ayrıca, Data Portability API'nin bulunduğunuz yerdeki kullanıcılara sunulduğunu doğrulamanız gerekir. Desteklenen ülke ve bölgelerin listesi için "Verilerinizin kopyasını üçüncü taraflarla paylaşma" sayfasındaki Sık Sorulan Sorular bölümüne bakın.

Geliştirici iş akışı

Aşağıda, Data Portability API'yi kullanan bir uygulama oluşturmak için uygulayacağınız adımlar verilmiştir.

1. Kullanıcı için OAuth izin akışını uygulayın. Bu örnekte kullanıcı, YouTube video verilerine erişim izni vermektedir.

   1. Kullanıcı, YouTube videolarını içe aktar'ı tıklar ve Google Hesabında oturum açar.

   2. Uygulama, kullanıcıyı bir OAuth izin URL'sine yönlendirir. Bu örnek URL'nin basitleştirilmiş olduğunu ve bazı parametrelerin eksik olduğunu unutmayın:

      https://accounts.google.com/o/oauth2/v2/auth?scope=https://www.googleapis.com/auth/dataportability.myactivity.youtube

   3. Kullanıcı, OAuth izin ekranında İleri'yi tıklar, verilerini paylaşmayı kabul eder ve hesap erişimi sağlar.

   4. Kullanıcı uygulamaya yönlendirilir.

   5. Geliştirici, kullanıcı için bir OAuth jetonu alır.

2. Uygulamanız, şu OAuth kapsamını içeren ekli bir OAuth jetonuyla InitiatePortabilityArchive(resources = ["myactivity.youtube"]) çağırıyor:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   Bu çağrı, veri arşivi oluşturma işlemini başlatır. Kullanıcı yetkilendirmesini takip eden 24 saat içinde taşınabilirlik arşivini başlatmanız gerekir.

3. Uygulamanız, aşağıdaki OAuth kapsamını içeren ekli bir OAuth jetonuyla GetPortabilityArchiveState(job_id)'i çağırıyor:

   https://www.googleapis.com/auth/dataportability.myactivity.youtube

   Arşivleme işinin durumunu almak için bu yöntemi birden çok kez çağırabilirsiniz. Yöntem, işin durumunu döndürür. Durum TAMAMLANABİLDİ ise arşiv hazırdır ve imzalı Cloud Storage URL'leri sağlanır. Arşiv isteğini tamamlamak için gereken sürenin, verilerin boyutuna bağlı olarak dakikalar ile saatler arasında değişebileceğini unutmayın.

4. İmzalı URL'leri kullanarak veri arşivini indirin.

5. Kullanılmamış kaynakları sıfırlamak ve tüm OAuth izinlerini kaldırmak için ekli bir OAuth jetonuyla ResetAuthorization() çağırın.

Data Portability API yöntemlerinin kullanımı hakkında daha fazla bilgi için Data Portability API yöntemlerini çağırma başlıklı makaleyi inceleyin.

Kullanıcıların Data Portability API uygulamasıyla etkileşimi

Bu şema, kullanıcıların Veri Taşınabilirliği API'si ile entegre bir uygulamayla nasıl etkileşime geçtiğini gösterir.

1. İlk olarak kullanıcıya verilerini alma seçeneği sunulur.

2. Ardından, kullanıcı Google Hesabında oturum açar.

3. Ardından kullanıcı, verilerini paylaşması istendiğinde Sonraki'yi, gizlilik politikasını kabul etmesi istendiğinde ise Anladım'ı tıklar.

4. Ardından kullanıcıya, uygulamanın verilerine erişmesine izin vermek için kullanılan bir OAuth izin ekranı gösterilir. Buradaki seçenekler, yapılandırdığınız OAuth kapsamlarıyla eşleşir.

5. Erişime izin verildikten sonra verileri içe aktarma işlemi başlar. Verilerin boyutuna bağlı olarak isteğin tamamlanması birkaç dakika ile birkaç saat arasında sürebilir.