Method: approvals.start

Инициирует процесс утверждения файла.

HTTP-запрос

POST https://www.googleapis.com/drive/v3/files/{fileId}/approvals:start

В URL-адресе используется синтаксис транскодирования gRPC .

Параметры пути

Параметры
fileId

string

Обязательно. Идентификатор файла, для которого будет создано подтверждение.

Текст запроса

Тело запроса содержит данные следующей структуры:

JSON-представление 
{
  "reviewerEmails": [
    string
  ],
  "dueTime": string,
  "lockFile": boolean,
  "message": string
}
Поля
reviewerEmails[]

string

Обязательно. Адреса электронной почты пользователей, которым назначено рассмотрение запроса на утверждение.

dueTime

string ( Timestamp format)

Необязательно. Срок, к которому должно быть подано одобрение.

Используется RFC 3339, согласно которому генерируемый вывод всегда будет Z-нормализован и будет содержать 0, 3, 6 или 9 дробных знаков. Допускаются также смещения, отличные от "Z". Примеры: "2014-10-02T15:01:23Z" , "2014-10-02T15:01:23.045123456Z" или "2014-10-02T15:01:23+05:30" .

lockFile

boolean

Необязательно. Следует ли блокировать файл при начале процедуры утверждения.

message

string

Необязательно. Сообщение, которое будет отправлено рецензентам при уведомлении их о запросе на одобрение.

Ответный текст

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

Области полномочий

Требуется один из следующих диапазонов аутентификации OAuth:

  • https://www.googleapis.com/auth/drive
  • https://www.googleapis.com/auth/drive.file
  • https://www.googleapis.com/auth/drive.metadata

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