Вызов API переносимости данных с помощью скрипта Python

В этом кратком руководстве вы получите токен OAuth для своей учетной записи и отправите запросы к конечным точкам API переносимости данных с помощью скрипта Python.

Что вы узнаете

В этом кратком руководстве вы используете скрипт Python, чтобы:

• Отправьте аутентифицированный запрос в конечную точку InitiatePortabilityArchive , предоставив действительный токен OAuth. Ответом является действительный job_id .
• Отправьте аутентифицированный запрос в конечную точку GetPortabilityArchiveState и загрузите данные. Ответ должен содержать допустимое состояние задания, а после завершения задания — подписанный URL-адрес.
• Отправьте аутентифицированный запрос в конечную точку ResetAuthorization . Этот запрос отменяет все предоставленные пользователем области OAuth.

Предварительные условия

Чтобы запустить это краткое руководство, вам необходимо:

• Убедитесь, что вам доступен API переносимости данных. Список поддерживаемых стран и регионов см. в разделе « Общие вопросы» на странице «Отправка копии своих данных третьему лицу».
• Выполните действия по настройке API переносимости данных и убедитесь, что вы используете новый проект.
• Получите доступ к учетной записи, принадлежащей или контролируемой вашей организацией. Данные о поисковой активности этого аккаунта экспортируются в этом кратком руководстве.

Прежде чем приступить к работе с этим кратким руководством, вам также необходимо настроить OAuth, Python и пакет OAuth для клиентских библиотек Python.

Настройте OAuth

• Следуйте инструкциям по настройке OAuth для установленных приложений . Этот поток аналогичен потоку OAuth для приложений веб-сервера . Когда вы настраиваете идентификатор клиента OAuth:
  • Тип приложения должен быть «Настольное приложение» .
  • После создания идентификатора клиента загрузите секрет клиента в формате JSON и назовите файл: client_secrets.json .
  • При настройке областей для API переносимости данных обратите внимание, что в этом кратком руководстве используются следующие группы ресурсов:
    • myactivity.search : https://www.googleapis.com/auth/dataportability.myactivity.search
    • myactivity.youtube : https://www.googleapis.com/auth/dataportability.myactivity.youtube.

Настройка Python

Вам необходимо настроить Python на локальном компьютере для запуска сценария, используемого в этом кратком руководстве. Чтобы настроить Python:

• Установите инструмент управления пакетами Pip и Python 3.9 (или более поздней версии).
• Установите клиентскую библиотеку Google API для Python .

• Установите пакет google_auth_oauthlib для клиентской библиотеки Python, выполнив эту команду. Этот пакет обеспечивает интеграцию oauthlib с google-auth — библиотекой аутентификации Google для Python.

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

Запустите сценарий

Этот скрипт использует перенаправление localhost в потоке OAuth. Этот параметр требует, чтобы приложение прослушивало порт локального хоста, а затем открывало системный браузер, чтобы инициировать поток авторизации OAuth.

Щелкните эту ссылку, чтобы открыть сценарий, или загрузите копию сценария, щелкнув ссылку правой кнопкой мыши.

API переносимости данных. Сценарий быстрого запуска Python.

Чтобы запустить скрипт, введите следующую команду:

python3 data-portability-quickstart.py

Действия скрипта подробно описаны в комментариях.