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

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

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

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

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

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

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

Необходимо задать системный параметр fields в методе get , чтобы указать поля, возвращаемые в ответе. В большинстве методов Диска это действие требуется только для возврата полей, отличных от полей по умолчанию, но является обязательным для ресурса 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 Диска представлены в Google Workspace Marketplace и используются для повышения удобства работы с Диском, например, приложение Google Docs или дополнение к Docs для подписи документов. Подробнее см. в разделе Использование приложений Google Диска .

Чтобы вернуть список всех установленных приложений пользователя в виде экземпляра 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 : фильтрует результаты поиска по списку расширений файлов, разделенных запятыми. Приложения, входящие в область запроса app, которые могут открывать перечисленные расширения файлов, включаются в ответ. Если также указано appFilterMimeTypes , возвращается объединение двух результирующих списков приложений. Примеры расширений включают docx для Microsoft Word и pptx для Microsoft PowerPoint. Дополнительные примеры расширений файлов см. в разделе Экспорт типов MIME для документов Google Workspace .

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

  • appFilterMimeTypes : фильтрует результаты поиска по списку типов MIME, разделенному запятыми. Приложения, входящие в область запроса app, которые могут открывать перечисленные типы 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 : идентификатор листинга продукта для этого приложения.

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