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

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

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

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

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

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

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

Метод get() требует, чтобы параметр fields перечислил поля, которые будут возвращены в ответе. Если вы опустите параметр, метод вернет ошибку. Чтобы вернуть именно те поля, которые вам нужны, см. раздел «Возврат определенных полей» .

Показать пример

В следующем примере кода показано, как предоставить несколько 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 , чтобы перечислить поля, которые будут возвращены в ответе. Чтобы вернуть именно те поля, которые вам нужны, см. раздел «Возврат определенных полей» .

Показать пример

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

Запрос

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 Диском .

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

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

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

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

Чтобы загрузить подробную информацию о приложении в виде экземпляра 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 : идентификатор продукта для этого приложения.

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