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 konumdaki kullanıcılar tarafından kullanılabildiğini 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ğıdaki adımlar, Data Portability API'yi kullanan bir uygulama oluşturmak için uygulayacağınız adımlardır.

Geliştiricilerin Data Portability API'yi kullanarak uygulama oluşturmak için uyguladığı adımlar

  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ı İç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ğini 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ı, hangi verilerin paylaşılacağını ve uygulamanın bu verilere ne kadar süre boyunca erişebileceğini (verilerine tek seferlik erişim veya 30 ya da 180 gün boyunca zamana dayalı erişim) seçip Devam'ı tıklar.

      Not: Kullanıcı, OAuth jetonunuzun süresi dolmadan 90 gün öncesine kadar verilerine erişim izninizi yenileme seçeneğine sahiptir. Kullanıcının 90 gün içinde süresi dolacak kapsamı yoksa yenile düğmesi görünmez.

    5. Kullanıcı uygulamaya yönlendirilir.

    6. 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 ve bir iş kimliği ile kullanıcının tek seferlik mi yoksa zamana dayalı erişim izni mi verdiğini döndürür.

    Not: Tek seferlik erişim, kapsam başına bir dışa aktarma işlemi anlamına gelir. Kullanıcı birden fazla kapsam verirse jeton tarafından yetkilendirilen kaynakların her biri için ayrı işler oluşturmayı seçebilirsiniz.

  3. Uygulamanız, aşağıdaki OAuth kapsamını içeren ekli bir OAuth jetonuyla GetPortabilityArchiveState(job_id)'yi ç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 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 birkaç dakika ile birkaç saat arasında değişebileceğini unutmayın.

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

  5. Kullanıcı tek seferlik erişim izni verirse, tükenmiş kaynakları sıfırlamak ve tüm OAuth izinlerini kaldırmak için ResetAuthorization()'yi ekli bir OAuth jetonuyla çağırırsınız.

  6. Kullanıcı zamana dayalı erişim izni verirse, izin süresi dolana kadar kaynakları 24 saatte bir dışa aktarabilirsiniz.

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şıma API'si ile entegre bir uygulamayla nasıl etkileşime geçtiğini gösterir.

Kullanıcının verilerini dışa aktarmak için uyguladığı adımlar

  1. Öncelikle 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. Kullanıcı, hangi verilerin paylaşılacağını ve uygulamanın bu verilere ne kadar süre boyunca erişebileceğini (verilerine tek seferlik erişim veya 30 ya da 180 gün boyunca zamana dayalı erişim) seçip Devam'ı tıklar.

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