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 edinir ve bir Python komut dosyası kullanarak Veri Taşınabilirliği API uç noktalarına istek gönderirsiniz.

Öğrenecekleriniz

Bu hızlı başlangıç kılavuzunda, aşağıdakileri yapmak için bir Python komut dosyası kullanırsınız:

  • Geçerli bir OAuth jetonu sağlayarak InitiatePortabilityArchive uç noktasına kimliği doğrulanmış bir istek gönderin. Yanıt geçerli bir job_id olmalıdır.
  • 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 imzalı bir URL içermelidir.
  • OAuth jetonunu daha sonra yeniden kullanmak için zamana dayalı erişim ile saklayın.
  • 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.
  • İsteğinize zaman filtresi uygulamak için start_time veya end_time ile birlikte geçerli bir OAuth jetonu sağlayarak InitiatePortabilityArchive uç noktasına kimliği doğrulanmış bir istek gönderin.

Ön koşullar

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

  • Data Portability API'nin kullanabileceğinizi doğrulayın. Desteklenen ülke ve bölgelerin listesi için "Verilerinizin kopyasını üçüncü taraflarla paylaşma" sayfasındaki Yaygın 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şunuzun sahibi olduğu veya kontrol ettiği bir hesaba erişme Bu hesaptaki arama etkinliği verileri bu hızlı başlangıç kılavuzunda dışa aktarılır.

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

OAuth'u ayarlama

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

Python'u ayarlama

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

  • Pip paket yönetim aracını ve Python 3.11 (veya sonraki bir sürümü) 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 için uygulamanın bir yerel ana makine bağlantı noktasında dinleme yapması ve ardından OAuth yetkilendirme akışını başlatmak için sistem tarayıcısını açması gerekir.

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 ve veri kümesinin tamamını dışa aktarmak için şu komutu girin:

python3 data-portability-quickstart.py

Farklı kapsamlar kullanmak için --resources kullanarak bunları belirtin. Örneğin:

python3 data-portability-quickstart.py --resources myactivity.shopping myactivity.play

Zaman filtrelemesi uygulamak için start_time ve end_time işaretleriyle aynı komut dosyasını kullanın. Örneğin:

python3 data-portability-quickstart.py --start_time 2023-01-01T12:00:00Z --end_time 2024-01-01T12:00:00Z

Komut dosyasının gerçekleştirdiği işlemler yorumlarda ayrıntılı olarak açıklanmıştır.