Gọi API Khả năng di chuyển dữ liệu bằng tập lệnh Python

Trong hướng dẫn bắt đầu nhanh này, bạn sẽ lấy mã thông báo OAuth cho tài khoản của mình và gửi yêu cầu đến các điểm cuối của API Khả năng chuyển đổi dữ liệu bằng tập lệnh Python.

Kiến thức bạn học được

Trong hướng dẫn bắt đầu nhanh này, bạn sẽ sử dụng tập lệnh Python để:

  • Gửi yêu cầu đã xác thực đến điểm cuối InitiatePortabilityArchive bằng cách cung cấp mã thông báo OAuth hợp lệ. Phản hồi là một job_id hợp lệ.
  • Gửi yêu cầu đã xác thực đến điểm cuối GetPortabilityArchiveState rồi tải dữ liệu xuống. Phản hồi phải chứa trạng thái công việc hợp lệ và một URL đã ký khi công việc hoàn tất.
  • Gửi yêu cầu đã xác thực đến điểm cuối ResetAuthorization. Yêu cầu này thu hồi tất cả các phạm vi OAuth do người dùng cấp.

Điều kiện tiên quyết

Để chạy quy trình khởi động nhanh này, bạn cần:

  • Xác minh rằng bạn có thể sử dụng API Khả năng di chuyển dữ liệu. Để biết danh sách các quốc gia và khu vực được hỗ trợ, hãy xem phần Các câu hỏi thường gặp trên trang "Chia sẻ bản sao dữ liệu của bạn với bên thứ ba".
  • Hoàn tất các bước thiết lập cho API Khả năng chuyển đổi dữ liệu và xác minh rằng bạn đang sử dụng một dự án mới.
  • Lấy quyền truy cập vào tài khoản do tổ chức của bạn sở hữu hoặc kiểm soát. Dữ liệu về hoạt động tìm kiếm của tài khoản này được xuất trong quá trình bắt đầu nhanh này.

Trước khi bắt đầu quy trình bắt đầu nhanh này, bạn cũng cần thiết lập OAuth, Python và gói OAuth cho thư viện ứng dụng Python.

Thiết lập OAuth

  • Làm theo các bước để định cấu hình OAuth cho các ứng dụng đã cài đặt. Quy trình này tương tự như quy trình OAuth cho ứng dụng máy chủ web. Khi bạn định cấu hình mã ứng dụng khách OAuth:
    • Loại ứng dụng phải là Ứng dụng dành cho máy tính để bàn.
    • Sau khi bạn tạo ID ứng dụng khách, hãy tải mật khẩu ứng dụng khách xuống ở định dạng JSON và đặt tên cho tệp là: client_secrets.json.
    • Khi bạn định cấu hình phạm vi cho API Khả năng chuyển đổi dữ liệu, hãy lưu ý rằng hướng dẫn nhanh này sử dụng các nhóm tài nguyên sau:

Thiết lập Python

Bạn cần thiết lập Python trên máy cục bộ để chạy tập lệnh được dùng trong quá trình bắt đầu nhanh này. Cách thiết lập Python:

  • Cài đặt công cụ quản lý gói Pip và Python 3.9 (trở lên).
  • Cài đặt Thư viện ứng dụng API của Google cho Python.

  • Cài đặt gói google_auth_oauthlib cho thư viện ứng dụng Python bằng cách chạy lệnh này. Gói này cung cấp khả năng tích hợp oauthlib với google-auth – thư viện xác thực của Google cho Python.

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

Chạy tập lệnh

Tập lệnh này sử dụng lệnh chuyển hướng localhost trong quy trình OAuth. Tuỳ chọn này yêu cầu ứng dụng phải theo dõi trên cổng máy chủ cục bộ, sau đó mở trình duyệt hệ thống để bắt đầu quy trình uỷ quyền OAuth.

Nhấp vào đường liên kết này để mở tập lệnh hoặc tải bản sao tập lệnh xuống bằng cách nhấp chuột phải vào đường liên kết.

Tập lệnh bắt đầu nhanh Python API Tính di chuyển dữ liệu

Để chạy tập lệnh, hãy nhập lệnh sau:

python3 data-portability-quickstart.py

Những hành động mà tập lệnh thực hiện được nêu chi tiết trong phần nhận xét.