Python Komut Dosyası Kullanarak Data Portability API'yi Çağırma

Bu hızlı başlangıç kılavuzunda hesabınız için bir OAuth jetonu edinecek ve bir Python komut dosyası kullanarak Data Portability API uç noktalarına istek göndereceksiniz.

Öğrenecekleriniz

Bu hızlı başlangıç kılavuzunda Python komut dosyası kullanarak şunları yapabilirsiniz:

  • Geçerli bir OAuth jetonu sağlayarak InitiatePortabilityArchive uç noktasına kimliği doğrulanmış istek gönderin. Yanıt, geçerli bir job_id.
  • GetPortabilityArchiveState uç noktasına kimliği doğrulanmış bir istek gönderin ve verileri indirin. Yanıt, geçerli bir iş durumu ve iş tamamlandığında da imzalı bir URL içermelidir.
  • ResetAuthorization uç noktasına kimliği doğrulanmış bir istek gönderin. Bu istek, kullanıcı tarafından verilen tüm OAuth kapsamlarını iptal eder.

Ön koşullar

Bu hızlı başlangıç kılavuzunu çalıştırmak için şunları yapmanız gerekir:

  • Data Portability API'yi kullanabileceğinizi doğrulayın. 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.
  • Data Portability API için kurulum adımlarını tamamlayın ve yeni bir proje kullandığınızı doğrulayın.
  • Kuruluşunuza ait veya kuruluşunuz tarafından kontrol edilen bir hesaba erişim elde edin. Söz konusu hesabın arama etkinliği verileri bu hızlı başlangıç kılavuzunda dışa aktarılır.

Bu hızlı başlangıç işlemine başlamadan önce Python istemci kitaplıkları için OAuth, Python ve OAuth paketini de kurmanız gerekir.

OAuth'u kur

  • Yüklü uygulamalar için OAuth'u yapılandırma adımlarını uygulayın. Bu akış, web sunucusu uygulamalarının OAuth akışına benzer. OAuth istemci kimliğinizi yapılandırdığınızda:
    • Uygulama türü Masaüstü uygulaması olmalıdır.
    • İstemci kimliğini oluşturduktan sonra istemci gizli anahtarını JSON biçiminde indirin ve client_secrets.json olarak adlandırın.
    • Data Portability API için kapsamları yapılandırdığınızda, bu hızlı başlangıç kılavuzunun şu kaynak gruplarını kullandığını unutmayın:

Python'u kurun

Bu hızlı başlangıç kılavuzunda kullanılan komut dosyasını çalıştırmak için yerel makinenizde Python'u kurmanız gerekir. Python'u kurmak için:

  • Pip paket yönetimi aracını ve Python 3.9'u (veya sonraki sürümleri) yükleyin.
  • Python için Google API İstemci Kitaplığı'nı yükleyin.

  • Bu komutu çalıştırarak Python istemci kitaplığı için google_auth_oauthlib paketini yükleyin. Bu paket, Python için Google kimlik doğrulama kitaplığı olan google-auth ile oauthlib entegrasyonu sağlar.

    pip install google-auth-oauthlib google-api-python-client --upgrade

Komut dosyasını çalıştırma

Bu komut dosyası, OAuth akışında bir yerel ana makine yönlendirmesi kullanır. Bu seçenek, uygulamanın bir localhost bağlantı noktasını dinlemesini ve ardından OAuth yetkilendirme akışını başlatmak için sistem tarayıcısını açmasını gerektirir.

Komut dosyasını açmak için bu bağlantıyı tıklayın veya bağlantıyı sağ tıklayarak komut dosyasının bir kopyasını indirin.

Data Portability API Python hızlı başlangıç komut dosyası

Komut dosyasını çalıştırmak için şu komutu girin:

python3 data-portability-quickstart.py

Komut dosyası tarafından gerçekleştirilen işlemler, yorumlarda ayrıntılı olarak açıklanmıştır.