Вернуть информацию о пользователе

Google Drive предоставляет два способа сбора информации о пользователях Drive:

  • С помощью раздела about программе" вы можете получить информацию о пользователе, его настройках Google Диска и возможностях его системы.

  • С помощью ресурса apps можно получить список установленных пользователем приложений, а также информацию о поддерживаемых MIME-типах, расширениях файлов и другие сведения для каждого приложения.

В этом руководстве объясняется, как получить доступ к информации о пользователях в Google Диске.

Получить подробную информацию о пользователе

Чтобы получить информацию о пользователе Google Диска в виде экземпляра объекта about , используйте метод get . Возвращаемые значения измеряются в байтах.

Необходимо установить системный параметр fields в методе get , чтобы указать поля, которые должны быть возвращены в ответе. В большинстве методов Drive это действие требуется только для возврата полей, отличных от полей по умолчанию, но для ресурса about это обязательно. Если вы опустите этот параметр, метод вернет ошибку. Для получения дополнительной информации см. раздел «Возврат определенных полей» .

Приведённый ниже пример кода демонстрирует, как передать несколько fields в качестве параметра запроса. В ответе возвращаются значения полей из запроса.

Запрос

GET https://www.googleapis.com/drive/v3/about/?fields=kind,user,storageQuota

Ответ

{
  "kind": "drive#about",
  "user": {
    "kind": "drive#user",
    "displayName": "DISPLAY_NAME",
    "photoLink": "PHOTO_LINK",
    "me": true,
    "permissionId": "PERMISSION_ID",
    "emailAddress": "EMAIL_ADDRESS"
  },
  "storageQuota": {
    "usage": "10845031958",
    "usageInDrive": "2222008387",
    "usageInDriveTrash": "91566"
  }
}

В ответе содержатся следующие значения:

  • DISPLAY_NAME : имя пользователя в текстовом формате.
  • PHOTO_LINK : URL-адрес фотографии профиля пользователя.
  • PERMISSION_ID : идентификатор пользователя в ресурсах Permission .
  • EMAIL_ADDRESS : адрес электронной почты пользователя

Список пользовательских приложений

Приложения Google Drive представлены в Google Workspace Marketplace и используются для повышения удобства работы с Google Drive, например, приложение Google Docs или надстройка для подписи документов в Docs. Для получения дополнительной информации см. раздел «Использование приложений Google Drive» .

Чтобы вернуть список всех установленных пользователем приложений в виде экземпляра класса apps , используйте метод list без каких-либо параметров.

Если вы хотите указать поля, которые должны быть возвращены в ответе, вы можете задать системный параметр fields . Если вы не укажете параметр fields , сервер вернет набор полей по умолчанию. Для получения дополнительной информации см. раздел «Возвращение определенных полей» .

Приведённый ниже пример кода показывает, как в запросе вернуть список всех установленных пользователем приложений. В ответе возвращаются значения полей запроса.

Запрос

GET https://www.googleapis.com/drive/v3/apps

Ответ

{
  "kind": "drive#appList",
  "selfLink": "https://www.googleapis.com/drive/v3/apps",
  "items": [
    {
      "kind": "drive#app",
      "id": "ID",
      "name": "Google Sheets",
      "supportsCreate": true,
      "supportsImport": true,
      "supportsMultiOpen": false,
      "supportsOfflineCreate": true,
      "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
      "productId": "PRODUCT_ID"
    }
  ],
  "defaultAppIds": [
    "ID"
  ]
}

В ответе содержатся следующие значения:

  • ID : идентификатор приложения.
  • PRODUCT_ID : идентификатор товара в этом приложении.

Список пользовательских приложений с параметрами запроса

Для поиска конкретного приложения используйте один или несколько необязательных параметров запроса:

  • appFilterExtensions : Фильтрует результаты поиска, используя список расширений файлов, разделенных запятыми. В ответ включаются приложения, входящие в область поиска приложений и способные открывать файлы с указанными расширениями. Если также указаны appFilterMimeTypes , возвращается объединение двух полученных списков приложений. Примеры расширений включают docx для Microsoft Word и pptx для Microsoft PowerPoint. Дополнительные примеры расширений файлов см. в разделе «Экспорт MIME-типов для документов Google Workspace» .

    Следующий пример кода демонстрирует, как передать несколько расширений файлов в качестве параметра запроса: GET https://www.googleapis.com/drive/v3/apps?appFilterExtensions=docx,pptx .

  • appFilterMimeTypes : Фильтрует результаты поиска, используя список MIME-типов, разделенных запятыми. В ответ включаются приложения, находящиеся в области поиска приложений и способные открывать перечисленные MIME-типы. Если также указаны appFilterExtensions , возвращается объединение двух результирующих списков приложений. Примеры MIME-типов включают application/vnd.google-apps.form для Google Forms и application/vnd.google-apps.site для Google Sites. Дополнительные примеры MIME-типов см. в разделе «Поддерживаемые MIME-типы Google Workspace и Google Drive» .

    Следующий пример кода демонстрирует, как передать несколько MIME-типов в качестве параметра запроса: GET https://www.googleapis.com/drive/v3/apps?appFilterMimeTypes=application/vnd.google-apps.form,application/vnd.google-apps.site .

  • languageCode : Фильтрует результаты поиска, используя код языка или локали, определенный в BCP 47, с некоторыми расширениями из формата LDML Unicode . Примеры кодов языков включают en-us для английского (США) и fr-ca для французского (Канада).

    Следующий пример кода демонстрирует, как передать несколько языковых кодов в качестве параметра запроса: GET https://www.googleapis.com/drive/v3/apps?languageCode=en-us,fr-ca .

Получить приложение пользователя по ID

Чтобы загрузить подробную информацию о приложении как об экземпляре apps , используйте метод get с идентификатором приложения.

Приведённый ниже пример кода показывает, как передать appId в качестве параметра запроса. В ответе возвращаются значения полей запроса.

Запрос

GET https://www.googleapis.com/drive/v3/apps/APP_ID

Ответ

{
  "kind": "drive#app",
  "id": "ID",
  "name": "Google Sheets",
  "supportsCreate": true,
  "supportsImport": true,
  "supportsMultiOpen": false,
  "supportsOfflineCreate": true,
  "productUrl": "https://chrome.google.com/webstore/detail/felcaaldnbdncclmgdcncolpebgiejap",
  "productId": "PRODUCT_ID"
}

В ответе содержатся следующие значения:

  • ID : идентификатор приложения.
  • PRODUCT_ID : идентификатор товара в этом приложении.

Вот несколько дальнейших шагов, которые вы можете попробовать: