Управление согласованиями

В этом документе объясняется, как управлять подтверждениями в API Google Drive.

Вы можете найти информацию о согласовании контента в Google Drive. API Google Drive предоставляет ресурс для получения и отображения статуса ваших approvals , что позволяет получать и просматривать список согласований. Методы ресурса для approvals работают с элементами в Drive, Google Docs и других редакторах Google Workspace.

Этот процесс можно использовать для отслеживания утверждений в ситуациях формальной проверки, например, при проверке контракта или официального документа перед публикацией. Утверждение отслеживает статус как самой проверки (например, «В процессе», «Утверждено» или «Отклонено»), так и участвующих в ней рецензентов. Утверждения — это отличный способ проверить достоверность контента и вести учет рецензентов.

Для просмотра подтверждений по файлу необходимо иметь разрешение на чтение метаданных файла. Дополнительную информацию см. в разделе «Роли и разрешения» .

Используйте параметр fields.

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

Получите одобрение

Чтобы получить подтверждение для файла, используйте метод get ресурса approvals с параметрами fileId и approvalId путь). Если идентификатор подтверждения неизвестен, вы можете вывести список подтверждений с помощью метода list .

В теле ответа содержится экземпляр ресурса approvals .

Утверждение списков

Чтобы вывести список утверждений для файла, вызовите метод list ресурса approvals и укажите в качестве параметра путь fileId .

В ответе содержится список согласований по файлу. Поле items включает информацию о каждом согласовании в виде ресурса approvals .

Ресурс approvals также включает объект Status , в котором подробно описывается статус утверждения, а также объект ReviewerResponse , в котором подробно описывается ответ на утверждение, сделанный конкретным рецензентом. Ответ этого рецензента представлен объектом Response .

Вы также можете передать следующие параметры запроса для настройки постраничной навигации или фильтрации подтверждений:

  • pageSize : Максимальное количество подтверждений, возвращаемых на странице. Если pageSize не задан, сервер вернет до 100 подтверждений.

  • pageToken : Токен страницы, полученный из предыдущего вызова списка. Этот токен используется для получения следующей страницы. Он должен быть установлен в значение nextPageToken из предыдущего ответа.