Списковые ручки возвращают результаты страницами. Управление — параметрами
limit и page_token.
Как это работает
Передайте next_page_token в следующий запрос, чтобы получить следующую страницу.
Пустой next_page_token означает, что страниц больше нет.
limit — по умолчанию 100, максимум 1000.page_token — непрозрачный. Не разбирайте и не конструируйте его; передавайте
ровно то значение, что получили.
Токен привязан к набору фильтров, для которого был выдан. Если передать его в
запрос с другими status, department_id, updated_since или limit, ответ
будет INVALID_ARGUMENT. Меняете фильтры — начинайте обход заново без токена.
Общее число
По умолчанию число всех подходящих записей не считается. Запросите его явно через
include_total=true:
Поле total_count появляется в ответе. На больших выборках (свыше ~10 000 записей)
это оценка планировщика, а не точное число.
Инкрементальная синхронизация
Чтобы забирать только изменения, фильтруйте по updated_since (RFC 3339):
updated_since отражает изменения самой карточки сотрудника. Переименование
связанных сущностей (человек, отдел) в это поле не попадает — для них
используйте вебхуки: переименование человека приходит
как employee.changed. Для сверки удалений периодически делайте полный перечит.Смещение часового пояса в query кодируйте как %2B05:00 или присылайте время в
Z (UTC): «плюс» в URL иначе трактуется как пробел. 
