yandex360 3.2.0 → 4.0.0

data/README.ru.md

@@ -58,7 +58,7 @@
 Добавьте эту строку в `Gemfile` вашего приложения:
 
 ```ruby
-gem 'yandex360', '~> 3.0'
+gem 'yandex360', '~> 4.0'
 ```
 
 Затем выполните:
@@ -85,6 +85,11 @@ gem install yandex360
 
 ## Переход с 1.x
 
+Пришли с 3.x? Ломающие изменения 4.0 перечислены в
+[changelog](CHANGELOG.md): четыре ресурса обращались к эндпоинтам, которых не
+существует, и исправлены.
+
+
 Два мажора произошли разом: 1.1.4 была последней опубликованной версией перед
 3.0.0. Здесь всё, что требует вашего внимания. Обоснования в
 [changelog](CHANGELOG.md).
@@ -387,9 +392,15 @@ users.auto_paginate.each {|user| puts user.nickname }
 first_fifty = client.users.list(org_id: 1234567, per_page: 25).auto_paginate.first(50)
 ```
 
-Доступно для `users`, `groups`, `departments`, `external_contacts` и двух
-списков почтовых ящиков. Аргументы исходного вызова, такие как `per_page`
-или `parent_id` у подразделений, переносятся на следующие страницы.
+Пагинируются не все списки, и те, что пагинируются, делают это по-разному.
+`users`, `groups`, `departments`, `external_contacts`, `domains`, `dns` и два
+списка почтовых ящиков принимают `page` и `per_page`. `organizations` и оба
+аудит-лога листаются токеном, поэтому принимают `page_size` и не принимают
+`page`. Участники групп, права доступа к ящикам и сервисные приложения
+отвечают целиком и не принимают ни того, ни другого.
+
+Аргументы исходного вызова, такие как `per_page` или `parent_id` у
+подразделений, переносятся на следующие страницы.
 
 ## Объекты ответа
 
@@ -537,7 +548,7 @@ Yandex 360, к которой относится. Покрыты все семн
 |  | `client.external_contacts` | [Внешние контакты](#внешние-контакты) |
 | Домены | `client.domains` | [Домены](#домены) |
 |  | `client.dns` | [DNS-записи](#dns-записи) |
-| Почта | `client.post_settings` | [Настройки почты](#настройки-почты) |
+| Почта | `client.mail_settings` | [Настройки почты](#настройки-почты) |
 |  | `client.mailboxes` | [Почтовые ящики](#почтовые-ящики) |
 |  | `client.routing` | [Маршрутизация почты](#маршрутизация-почты) |
 |  | `client.domain_policies` | [Политики домена](#политики-домена) |
@@ -570,6 +581,10 @@ puts "Email: #{org.email}"
 puts "План подписки: #{org.subscription_plan}"
 ```
 
+У сервиса есть список и ничего уже, поэтому здесь поиск по нему, а не запрос
+одной организации. Токен обычно даёт доступ к одной организации, так что на
+практике это один запрос.
+
 ---
 
 ### Пользователи
@@ -900,53 +915,43 @@ client.external_contacts.delete(org_id: 1234567, contact_id: created.id)
 
 ### Домены
 
-Управление доменами организации и проверка владения.
-
-#### Получить список доменов
-
 ```ruby
-domains = client.domains.list(org_id: 1234567)
-domains.each do |domain|
-  puts "Домен: #{domain.name}"
-  puts "Статус: #{domain.status}"
-  puts "Подтверждён: #{domain.verified}"
-end
-```
-
-#### Добавить домен
+domains = client.domains.list(org_id: 1234567, page: 1, per_page: 10)
+domains.each {|domain| puts "#{domain.name} подтверждён=#{domain.verified}" }
 
-```ruby
-domain = client.domains.add(
-  org_id: 1234567,
-  name: "example.ru"
-)
-puts "Добавлен домен: #{domain.name}"
-puts "Статус проверки: #{domain.status}"
+client.domains.add(org_id: 1234567, name: "example.com")
+client.domains.delete(org_id: 1234567, domain: "example.com")
 ```
 
-#### Получить информацию о домене
+Эндпоинта для чтения одного домена нет, поэтому `find` обходит список. Это
+стоит запроса на страницу, а не одного, отсюда и имя:
 
 ```ruby
-domain = client.domains.info(org_id: 1234567, domain: "example.ru")
-puts "Домен: #{domain.name}"
-puts "Статус: #{domain.status}"
-puts "Подтверждён: #{domain.verified}"
-puts "Email главного администратора: #{domain.master_admin}"
+client.domains.find(org_id: 1234567, domain: "example.com")
 ```
 
-#### Подтвердить владение доменом
+Статус подключения несёт методы подтверждения и их коды, то есть ровно то, что
+нужно для подтверждения домена:
 
 ```ruby
-domain = client.domains.verify(org_id: 1234567, domain: "example.ru")
-puts "Статус проверки: #{domain.status}"
+status = client.domains.connection_status(org_id: 1234567, domain: "example.com")
+status.status
+status.methods.each {|method| puts "#{method.method}: #{method.code}" }
 ```
 
-#### Удалить домен
+Подпись DKIM:
 
 ```ruby
-client.domains.delete(org_id: 1234567, domain: "example.ru")
+dkim = client.domains.dkim_status(org_id: 1234567, domain: "example.com")
+dkim.enabled
+dkim.public_key
+
+client.domains.enable_dkim(org_id: 1234567, domain: "example.com")
+client.domains.disable_dkim(org_id: 1234567, domain: "example.com")
 ```
 
+Кириллические домены передаются в Punycode, как указано в документации API.
+
 ---
 
 ### DNS-записи
@@ -1024,53 +1029,51 @@ client.dns.delete(
 
 ### Настройки почты
 
-Управление настройками электронной почты для пользователей, включая правила пересылки.
-
-#### Получить настройки почты пользователя
+Настройки отдельного сотрудника: автоматический сбор контактов, имя
+отправителя и подписи, правила автоответа и пересылки.
 
 ```ruby
-settings = client.post_settings.list(org_id: 1234567, user_id: 987654321)
-puts "Подпись: #{settings.signature}"
-puts "Ответить на: #{settings.reply_to}"
-```
+# Автоматический сбор контактов
+book = client.mail_settings.address_book(org_id: 1234567, user_id: 987654321)
+book.collect_addresses
 
-#### Обновить настройки почты
+client.mail_settings.update_address_book(
+  org_id: 1234567, user_id: 987654321, collect_addresses: false
+)
 
-```ruby
-updated = client.post_settings.update(
+# Имя отправителя, основной адрес и подписи
+info = client.mail_settings.sender_info(org_id: 1234567, user_id: 987654321)
+puts "#{info.from_name} <#{info.default_from}>"
+info.signs.each {|sign| puts sign.text }
+
+client.mail_settings.update_sender_info(
   org_id: 1234567,
   user_id: 987654321,
-  signature: "С уважением,\nИван Иванов",
-  replyTo: "ivan.ivanov@example.ru"
+  from_name: "Иван Иванов",
+  sign_position: "under" # либо "bottom", значение по умолчанию
 )
 ```
 
-#### Управление пересылкой почты
+Автоответы и пересылки это два вида одного правила, и приходят они вместе:
 
 ```ruby
-# Получить список адресов пересылки
-forwardings = client.post_settings.forwarding_list(
-  org_id: 1234567,
-  user_id: 987654321
-)
+rules = client.mail_settings.rules(org_id: 1234567, user_id: 987654321)
+rules.autoreplies
+rules.forwards
 
-forwardings.each do |forwarding|
-  puts "Пересылка на: #{forwarding.address}"
-end
-
-# Добавить адрес пересылки
-client.post_settings.add_forwarding(
-  org_id: 1234567,
-  user_id: 987654321,
-  address: "forward@example.ru"
+# Одно правило за вызов, одного вида. Автоответ:
+created = client.mail_settings.create_rule(
+  org_id: 1234567, user_id: 987654321,
+  rule_name: "В отпуске", text: "Вернусь в понедельник"
 )
 
-# Удалить адрес пересылки
-client.post_settings.delete_forwarding(
-  org_id: 1234567,
-  user_id: 987654321,
-  address: "forward@example.ru"
+# Либо пересылка:
+client.mail_settings.create_rule(
+  org_id: 1234567, user_id: 987654321,
+  rule_name: "В архив", address: "archive@example.com", with_store: true
 )
+
+client.mail_settings.delete_rule(org_id: 1234567, user_id: 987654321, rule_id: created.rule_id)
 ```
 
 ---
@@ -1219,51 +1222,33 @@ puts "Список очищен"
 
 ### Двухфакторная аутентификация (2FA)
 
-Управление настройками двухфакторной аутентификации для пользователей и всего домена.
-
-#### Включить 2FA для пользователя
+Обязательная 2FA для всей организации. Все три вызова идут по одному пути и
+различаются только глаголом, поэтому отдельных эндпоинтов для включения и
+выключения нет.
 
 ```ruby
-result = client.two_fa.enable(org_id: 1234567, user_id: 987654321)
-puts "2FA успешно включена"
-```
-
-#### Отключить 2FA для пользователя
-
-```ruby
-result = client.two_fa.disable(org_id: 1234567, user_id: 987654321)
-puts "2FA успешно отключена"
-```
-
-#### Проверить статус 2FA пользователя
+settings = client.two_fa.status(org_id: 1234567)
+settings.enabled
+settings.duration    # секунд, на которые сотрудник может отложить настройку
+settings.enabled_at
 
-```ruby
-status = client.two_fa.status(org_id: 1234567, user_id: 987654321)
-puts "2FA включена: #{status.enabled}"
-puts "Есть TOTP: #{status.has_totp}"
-```
-
-#### Получить статус 2FA для всего домена
+# duration обязателен: значения по умолчанию у API нет.
+client.two_fa.enable(
+  org_id: 1234567,
+  duration: 3600,
+  logout_users: true,        # необязательно, завершает все сессии
+  validation_method: "phone" # необязательно, "default" или "phone"
+)
 
-```ruby
-domain_status = client.two_fa.domain_status(org_id: 1234567)
-puts "2FA включена для домена: #{domain_status.enabled}"
+client.two_fa.disable(org_id: 1234567)
 ```
 
-#### Настроить 2FA для всего домена
+Персональная 2FA находится не здесь. Она относится к сотруднику, поэтому живёт
+на `users`:
 
 ```ruby
-# Включить 2FA для всего домена
-result = client.two_fa.configure_domain(
-  org_id: 1234567,
-  enabled: true
-)
-
-# Отключить 2FA для всего домена
-result = client.two_fa.configure_domain(
-  org_id: 1234567,
-  enabled: false
-)
+client.users.get2FA(org_id: 1234567, user_id: 987654321)
+client.users.delete_2fa_phone(org_id: 1234567, user_id: 987654321)
 ```
 
 ---
@@ -1379,7 +1364,7 @@ client.service_applications.delete(org_id: 1234567)
 
 ```ruby
 # Каталог
-organizations.list
+organizations.list(page_size: 10, page_token: nil)
 organizations.info(org_id:)
 users.add(org_id:, dep_id:, **user_params)
 users.add_alias(org_id:, user_id:, user_alias:)
@@ -1407,6 +1392,7 @@ groups.info(org_id:, group_id:)
 groups.params(org_id:, group_id:)   # deprecated, use info
 groups.list(org_id:, page: 1, per_page: 10)
 groups.users(org_id:, group_id:)
+groups.members(org_id:, group_id:)
 groups.create(org_id:, name:, **group_params)
 groups.delete(org_id:, group_id:)
 groups.delete_user(org_id:, group_id:, type:, user_id:)
@@ -1419,22 +1405,27 @@ external_contacts.update_emails(org_id:, contact_id:, emails:)
 external_contacts.update_phones(org_id:, contact_id:, phones:)
 
 # Домены
-domains.list(org_id:)
+domains.list(org_id:, page: 1, per_page: 10)
+domains.find(org_id:, domain:)
 domains.add(org_id:, name:, **params)
-domains.info(org_id:, domain:)
 domains.delete(org_id:, domain:)
-domains.verify(org_id:, domain:)
-dns.list(org_id:, domain:)
+domains.connection_status(org_id:, domain:)
+domains.dkim_status(org_id:, domain:)
+domains.enable_dkim(org_id:, domain:)
+domains.disable_dkim(org_id:, domain:)
+dns.list(org_id:, domain:, page: 1, per_page: 50)
 dns.create(org_id:, domain:, **params)
 dns.update(org_id:, domain:, record_id:, **params)
 dns.delete(org_id:, domain:, record_id:)
 
 # Почта
-post_settings.list(org_id:, user_id:)
-post_settings.update(org_id:, user_id:, **params)
-post_settings.forwarding_list(org_id:, user_id:)
-post_settings.add_forwarding(org_id:, user_id:, address:)
-post_settings.delete_forwarding(org_id:, user_id:, address:)
+mail_settings.address_book(org_id:, user_id:)
+mail_settings.update_address_book(org_id:, user_id:, collect_addresses:)
+mail_settings.sender_info(org_id:, user_id:)
+mail_settings.update_sender_info(org_id:, user_id:, **params)
+mail_settings.rules(org_id:, user_id:)
+mail_settings.create_rule(org_id:, user_id:, **params)
+mail_settings.delete_rule(org_id:, user_id:, rule_id:)
 mailboxes.shared_list(org_id:, page: 1, per_page: 10)
 mailboxes.create_shared(org_id:, email:, name:, description:)
 mailboxes.shared_info(org_id:, resource_id:)
@@ -1456,11 +1447,10 @@ antispam.create(org_id, *strings)
 antispam.delete(org_id:)
 
 # Безопасность
-two_fa.enable(org_id:, user_id:)
-two_fa.disable(org_id:, user_id:)
-two_fa.status(org_id:, user_id:)
+two_fa.status(org_id:)
+two_fa.enable(org_id:, duration:, logout_users: nil, validation_method: nil)
+two_fa.disable(org_id:)
 two_fa.domain_status(org_id:)
-two_fa.configure_domain(org_id:, enabled:)
 sessions.info(org_id:)
 sessions.update(org_id:, auth_ttl:)
 sessions.logout(org_id:, user_id:)

data/lib/yandex360/client.rb

@@ -83,8 +83,15 @@ module Yandex360
       AuditResource.new(self)
     end
 
+    def mail_settings
+      MailSettingsResource.new(self)
+    end
+
+    # Deprecated: the old name, for a resource that called paths the API does
+    # not have. Removed in 5.0.
     def post_settings
-      PostSettingsResource.new(self)
+      warn "[yandex360] client.post_settings is deprecated, use client.mail_settings", uplevel: 1
+      mail_settings
     end
 
     def sessions

data/lib/yandex360/objects/types.rb

@@ -88,6 +88,12 @@ module Yandex360
     attribute :created_at, from: "createdAt"
   end
 
+  class GroupMembers < Record
+    attribute :departments
+    attribute :groups
+    attribute :users
+  end
+
   class Alias < Record
     attribute :alias
     attribute :id
@@ -104,6 +110,16 @@ module Yandex360
     attribute :status
   end
 
+  class DomainStatus < Record
+    attribute :status
+    attribute :methods
+  end
+
+  class DomainDkim < Record
+    attribute :enabled
+    attribute :public_key, from: "publicKey"
+  end
+
   class DnsRecord < Record
     attribute :record_id, from: "recordId"
     attribute :type
@@ -227,6 +243,32 @@ module Yandex360
     attribute :roles
   end
 
+  class Domain2FA < Record
+    attribute :enabled
+    attribute :duration
+    attribute :enabled_at, from: "enabledAt"
+  end
+
+  class MailAddressBook < Record
+    attribute :collect_addresses, from: "collectAddresses"
+  end
+
+  class MailSenderInfo < Record
+    attribute :from_name, from: "fromName"
+    attribute :default_from, from: "defaultFrom"
+    attribute :signs
+    attribute :sign_position, from: "signPosition"
+  end
+
+  class MailUserRules < Record
+    attribute :autoreplies
+    attribute :forwards
+  end
+
+  class MailRule < Record
+    attribute :rule_id, from: "ruleId"
+  end
+
   class MailboxTask < Record
     attribute :task_id, from: "taskId"
     attribute :status

data/lib/yandex360/resources/departments.rb

@@ -6,7 +6,9 @@ module Yandex360
     def add_alias(org_id:, dep_id:, name:)
       validate_required_params({org_id: org_id, dep_id: dep_id, name: name}, %i[org_id dep_id name])
       dep_alias = {alias: name}
-      DepartmentAlias.new post("/directory/v1/org/#{org_id}/departments/#{dep_id}/aliases", body: dep_alias).body
+      # The reply is the whole department, aliases included.
+      Department.new post("/directory/v1/org/#{org_id}/departments/#{dep_id}/aliases",
+                          body: dep_alias).body
     end
 
     def update(org_id:, dep_id:, parent_id:, **params)
@@ -52,7 +54,8 @@ module Yandex360
 
     def delete_alias(org_id:, dep_id:, name:)
       validate_required_params({org_id: org_id, dep_id: dep_id, name: name}, %i[org_id dep_id name])
-      Response.new delete_request("/directory/v1/org/#{org_id}/departments/#{dep_id}/aliases/#{name}").body
+      path = "/directory/v1/org/#{org_id}/departments/#{dep_id}/aliases/#{name}"
+      DepartmentAlias.new delete_request(path).body
     end
 
     def delete(org_id:, dep_id:)

data/lib/yandex360/resources/dns.rb

@@ -4,10 +4,13 @@ module Yandex360
   class DnsResource < Resource
     include ParamBuilder
 
-    def list(org_id:, domain:)
+    def list(org_id:, domain:, page: 1, per_page: 50)
       validate_required_params({org_id: org_id, domain: domain}, %i[org_id domain])
-      resp = get("/directory/v1/org/#{org_id}/domains/#{domain}/dns")
-      Collection.from_response(resp, key: "records", type: DnsRecord)
+      resp = get("/directory/v1/org/#{org_id}/domains/#{domain}/dns",
+                 params: {page: page, perPage: per_page})
+      Collection.from_response(resp, key: "records", type: DnsRecord) do |next_page|
+        list(org_id: org_id, domain: domain, page: next_page, per_page: per_page)
+      end
     end
 
     def create(org_id:, domain:, **params)

data/lib/yandex360/resources/domains.rb

@@ -1,13 +1,29 @@
 # frozen_string_literal: true
 
 module Yandex360
+  # Domains, their connection status and their DKIM signature.
+  #
+  # There is no endpoint for reading one domain: the service offers a list and
+  # nothing narrower, so #find filters what the list returns.
+  #
+  # See https://yandex.ru/dev/api360/doc/ru/ref/DomainService/
   class DomainsResource < Resource
     include ParamBuilder
 
-    def list(org_id:)
+    # per_page is capped at 10 by the API.
+    def list(org_id:, page: 1, per_page: 10)
       validate_required_params({org_id: org_id}, [:org_id])
-      resp = get("/directory/v1/org/#{org_id}/domains")
-      Collection.from_response(resp, key: "domains", type: Domain)
+      resp = get("/directory/v1/org/#{org_id}/domains", params: {page: page, perPage: per_page})
+      Collection.from_response(resp, key: "domains", type: Domain) do |next_page|
+        list(org_id: org_id, page: next_page, per_page: per_page)
+      end
+    end
+
+    # Walks the list until the name matches, because the API has nothing to ask
+    # for a single domain with. Costs one request per page rather than one.
+    def find(org_id:, domain:)
+      validate_required_params({org_id: org_id, domain: domain}, %i[org_id domain])
+      list(org_id: org_id).auto_paginate.find {|candidate| candidate.name == domain }
     end
 
     def add(org_id:, name:, **params)
@@ -16,19 +32,35 @@ module Yandex360
       Domain.new post("/directory/v1/org/#{org_id}/domains", body: domain).body
     end
 
-    def info(org_id:, domain:)
+    def delete(org_id:, domain:)
       validate_required_params({org_id: org_id, domain: domain}, %i[org_id domain])
-      Domain.new get("/directory/v1/org/#{org_id}/domains/#{domain}").body
+      Response.new delete_request(domain_path(org_id, domain)).body
     end
 
-    def delete(org_id:, domain:)
-      validate_required_params({org_id: org_id, domain: domain}, %i[org_id domain])
-      Response.new delete_request("/directory/v1/org/#{org_id}/domains/#{domain}").body
+    # Carries the confirmation methods and their codes, which is what domain
+    # verification actually needs.
+    def connection_status(org_id:, domain:)
+      DomainStatus.new get("#{domain_path(org_id, domain)}/status").body
     end
 
-    def verify(org_id:, domain:)
+    def dkim_status(org_id:, domain:)
+      DomainDkim.new get("#{domain_path(org_id, domain)}/dkim").body
+    end
+
+    def enable_dkim(org_id:, domain:)
+      Response.new post("#{domain_path(org_id, domain)}/dkim/enable", body: {}).body
+    end
+
+    def disable_dkim(org_id:, domain:)
+      Response.new post("#{domain_path(org_id, domain)}/dkim/disable", body: {}).body
+    end
+
+    private
+
+    # Cyrillic domains have to be given in Punycode, as the API documents.
+    def domain_path(org_id, domain)
       validate_required_params({org_id: org_id, domain: domain}, %i[org_id domain])
-      Domain.new post("/directory/v1/org/#{org_id}/domains/#{domain}/verify", body: {}).body
+      "/directory/v1/org/#{org_id}/domains/#{domain}"
     end
   end
 end

data/lib/yandex360/resources/groups.rb

@@ -46,6 +46,13 @@ module Yandex360
       Collection.from_response(resp, key: "users", type: User)
     end
 
+    # A group can hold departments and other groups as well as employees, and
+    # the endpoint answers all three. #users shows only one of them.
+    def members(org_id:, group_id:)
+      validate_required_params({org_id: org_id, group_id: group_id}, %i[org_id group_id])
+      GroupMembers.new get("/directory/v1/org/#{org_id}/groups/#{group_id}/members").body
+    end
+
     def create(org_id:, name:, **group_params)
       validate_required_params({org_id: org_id, name: name}, %i[org_id name])
       group = build_params({name: name}, group_params)

data/lib/yandex360/resources/mail_settings.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+module Yandex360
+  # Per-employee mail settings: automatic contact collection, the sender name
+  # and signatures, and the auto-reply and forwarding rules.
+  #
+  # All three live under /admin/v1/org/{orgId}/mail/users/{userId}/settings.
+  #
+  # See https://yandex.ru/dev/api360/doc/ru/ref/MailUserSettingsService/
+  class MailSettingsResource < Resource
+    include ParamBuilder
+
+    def address_book(org_id:, user_id:)
+      MailAddressBook.new get(settings_path(org_id, user_id, "address_book")).body
+    end
+
+    def update_address_book(org_id:, user_id:, collect_addresses:)
+      required = {org_id: org_id, user_id: user_id}
+      validate_required_params(required, %i[org_id user_id])
+      body = {collectAddresses: collect_addresses}
+      MailAddressBook.new post(settings_path(org_id, user_id, "address_book"), body: body).body
+    end
+
+    def sender_info(org_id:, user_id:)
+      MailSenderInfo.new get(settings_path(org_id, user_id, "sender_info")).body
+    end
+
+    # Accepts from_name, default_from, signs and sign_position; the API
+    # documents them in camelCase, so they are converted here.
+    def update_sender_info(org_id:, user_id:, **params)
+      validate_required_params({org_id: org_id, user_id: user_id}, %i[org_id user_id])
+      body = camelize(build_params({}, params))
+      MailSenderInfo.new post(settings_path(org_id, user_id, "sender_info"), body: body).body
+    end
+
+    # Auto-reply and forwarding rules arrive together, under separate keys.
+    def rules(org_id:, user_id:)
+      MailUserRules.new get(settings_path(org_id, user_id, "user_rules")).body
+    end
+
+    # One rule per call, and of one kind: an auto-reply takes rule_name and
+    # text, a forward takes rule_name, address and with_store.
+    def create_rule(org_id:, user_id:, **params)
+      validate_required_params({org_id: org_id, user_id: user_id}, %i[org_id user_id])
+      raise ArgumentError, "Provide the rule attributes" if params.empty?
+
+      body = camelize(build_params({}, params))
+      MailRule.new post(settings_path(org_id, user_id, "user_rules"), body: body).body
+    end
+
+    def delete_rule(org_id:, user_id:, rule_id:)
+      required = {org_id: org_id, user_id: user_id, rule_id: rule_id}
+      validate_required_params(required, %i[org_id user_id rule_id])
+      Response.new delete_request("#{settings_path(org_id, user_id, 'user_rules')}/#{rule_id}").body
+    end
+
+    private
+
+    def settings_path(org_id, user_id, setting)
+      validate_required_params({org_id: org_id, user_id: user_id}, %i[org_id user_id])
+      "/admin/v1/org/#{org_id}/mail/users/#{user_id}/settings/#{setting}"
+    end
+
+    # Callers write snake_case here as they do everywhere else in the gem.
+    def camelize(params)
+      params.transform_keys do |key|
+        head, *rest = key.to_s.split("_")
+        [head, *rest.map(&:capitalize)].join.to_sym
+      end
+    end
+  end
+end

data/lib/yandex360/resources/organizations.rb

@@ -2,14 +2,24 @@
 
 module Yandex360
   class OrganizationsResource < Resource
-    def list
-      resp = get("/directory/v1/org")
-      Collection.from_response(resp, key: "organizations", type: Organization)
+    # Pages by token rather than page number, so there is no page argument.
+    # page_size is capped at 100 by the API.
+    def list(page_size: 10, page_token: nil)
+      params = {pageSize: page_size}
+      params[:pageToken] = page_token unless page_token.nil?
+
+      resp = get("/directory/v1/org", params: params)
+      Collection.from_response(resp, key: "organizations", type: Organization) do |token|
+        list(page_size: page_size, page_token: token)
+      end
     end
 
+    # OrganizationsService offers a list and nothing narrower, so this walks
+    # it. The token usually reaches one organization, so it is a single
+    # request in practice, but it is a search rather than a fetch.
     def info(org_id:)
       validate_required_params({org_id: org_id}, [:org_id])
-      Organization.new get("/directory/v1/org/#{org_id}").body
+      list.auto_paginate.find {|organization| organization.id.to_s == org_id.to_s }
     end
   end
 end