Почему некоторые функции Google Sheets API v4 не документированы

Question

Я пытаюсь понять, как работает Google Sheet API v4 , поэтому я проверяю примеры кодов, предоставленные Google для методов API. Просматривая примеры для скрипта Google Apps (например, batchUpdate), я обнаружил, что этот метод Sheets.newUpdateSpreadsheetPropertiesRequest() и многие другие - все начинаются с префикса new. Я искал, но я не могу найти эти методы, описанные в документации.

Это для меня не так ясно, как поведение службы электронных таблиц (SpreadsheetApp).

Я что-то пропустил или API REST недостаточно документирован?

Answer 1

API расширенного сервиса являются оболочками для соответствующих им REST API. Методы с префиксом new являются конструкторами для соответствующего объекта ресурса в соответствующем API (используется в основном для автозаполнения).

Например, Sheets.newUpdateSpreadsheetPropertiesRequest() соответствует объекту UpdateSpreadsheetPropertiesRequest. Требуется немного привыкнуть, но потратить некоторое время на навигацию по документации. Со временем это станет иметь смысл.