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

Data Portability API, Google hizmetlerindeki verilerin bir kopyasını uygulamanıza taşımak için kullanıcıdan yetkilendirme isteyen uygulamalar derlemenize olanak tanır. Bu sayede veri taşınabilirliği sağlanır ve hizmetler arasında geçiş yapılması kolaylaşı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ınlanmadan önce Google tarafından onaylanmalıdır.

Data Portability API'nin bulunduğunuz yerdeki kullanıcılara sunulduğunu da 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ışı

Bunlar, Data Portability API'yi kullanan bir uygulama oluşturmak için uygulamanız gereken adımlardır.

1. Kullanıcı için OAuth izin akışını uygulayın. Bu örnekte kullanıcı YouTube video verilerine erişim sağlar.

   1. Kullanıcı, YouTube Videolarını İç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ştirildiğine ve bazı parametrelerin eksik olduğuna dikkat edin:

      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 edinir.

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

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

   Bu çağrı, veri arşivi oluşturma işlemini başlatır. Taşınabilirlik arşivini kullanıcı yetkilendirmesinden sonraki 24 saat içinde başlatmanız gerekir.

3. Uygulamanız şu OAuth kapsamını içeren bir OAuth jetonu eklenmiş olarak GetPortabilityArchiveState(job_id) çağırır:

   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 COMPLETE ise arşiv hazırdır ve imzalı Cloud Storage URL'leri sağlanır. Arşivleme isteğinin tamamlanması 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. Tükenmiş kaynakları sıfırlamak ve tüm OAuth izinlerini kaldırmak için ResetAuthorization() numaralı telefonu çağırarak OAuth jetonu ekleyin.

Data Portability API yöntemlerini kullanma hakkında daha fazla bilgi için Call Data Portability API yöntemleri bölümüne bakın.

Kullanıcılar Data Portability API uygulamasıyla nasıl etkileşimde bulunur?

Bu şema, kullanıcıların Data Portability API'ye entegre bir uygulamayla nasıl etkileşimde bulunduğunu göstermektedir.

1. İlk olarak kullanıcıya verilerini alması için bir seçenek sunulur.

2. Daha sonra, kullanıcı Google Hesabında oturum açar.

3. Ardından, verilerini paylaşması istendiğinde kullanıcı İleri'yi ve gizlilik politikasını kabul etmesi istendiğinde 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şim izni 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.