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

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

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

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

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

Получить сведения о пользователе

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

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

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"
  }
}

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

Приложения Google Drive перечислены в Google Workspace Marketplace и используются для того, чтобы сделать 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"
  ]
}

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

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

• 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 с идентификатором приложения.

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"
}

Похожие темы

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

• Чтобы создать файл на Диске, см. раздел Создание и управление файлами .

• Чтобы загрузить данные файла при создании или обновлении файла, см. раздел Загрузка данных файла .

• Чтобы загрузить и экспортировать файлы, см. раздел Загрузка и экспорт файлов .