---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/disk-api/doc/ru/reference/public-settings-get-admin-path.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt

# Получение списка всех настроек доступа к публичному ресурсу по идентификатору его владельца и пути к ресурсу

Метод возвращает список всех настроек доступа к публичному ресурсу сотрудника организации, в которой состоит администратор. В запросе используется идентификатор пользователя и путь к публичному ресурсу на его Диске.


Необходимые права доступа для OAuth-приложения:
* `cloud_api:disk.read`


## Формат запроса {#pub-set-get-request}

Метод: ##GET##.

```
https://cloud-api.yandex.net/v1/disk/public/resources/admin/public-settings-by-path
 ? [user_id](*popup-user_id)=<идентификатор (UID) сотрудника организации>
 & [path](*popup-path)=<путь к ресурсу на Диске сотрудника с указанным user_id>
```

### Описание query-параметров {#query}

user_id[*](*popup-a)
: Идентификатор (UID) сотрудника организации.


path[*](*popup-a)
: Путь к ресурсу на Диске сотрудника с указанным `user_id`.

<!-- source: ru/_includes/reference/parameters-warehouse/id-format/path-encoding.md -->
Путь в значении параметра следует кодировать в URL-формате.
<!-- endsource: ru/_includes/reference/parameters-warehouse/id-format/path-encoding.md -->


\*  Обязательный параметр.


### Заголовок {#header}

```
Authorization: OAuth <token>
```

где `<token>` — токен администратора организации.


## Формат ответа {#pub-set-get-response}

### Успешный ответ

Если запрос был обработан без ошибок, API отвечает кодом `200 OK` и возвращает ссылку на опубликованный ресурс в теле ответа (в объекте [PublicSettings](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#publicsettings)).

Пример ответа:

<!-- source: ru/_includes/reference/public-settings-get-admin/response-body.md -->
```json
{
  "accesses": [
    {
      "id": 1130000066112015,
      "type": "user",
      "rights": [
        "read"
      ],
      "org_id": 8012499
    },
    {
      "id": 32,
      "type": "group",
      "rights": [
        "write"
      ],
      "org_id": 8012499
    },
    {
      "rights": [
        "read_with_password_without_download"
      ],
      "org_id": 8012499,
      "type": "macro",
      "macros": [
        "employees"
      ]
    },
    {
      "id": 8,
      "type": "group",
      "rights": [
        "write"
      ],
      "org_id": 8012499
    },
    {
      "id": 1130000066115011,
      "type": "owner",
      "rights": [
        "write"
      ],
      "org_id": 8012499
    }
  ],
  "available_until": null
}
```
<!-- endsource: ru/_includes/reference/public-settings-get-admin/response-body.md -->

#### Описание элементов ответа

**PublicSettings**

<!-- source: ru/_includes/reference/response-objects/id-link/publicsettings-table.md -->


#|
|| **Элемент** | **Описание** ||
||`available_until` | Время жизни ссылки на ресурс (в секундах). По истечении указанного времени ссылка на опубликованный ресурс перестанет быть действительной. ||
||`accesses` | Массив объектов, которые описывают права доступа пользователей к ресурсу ([PublicAccesses](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#publicaccesses)).||
|#
<!-- endsource: ru/_includes/reference/response-objects/id-link/publicsettings-table.md -->

**PublicAccesses**

<!-- source: ru/_includes/reference/response-objects/id-link/publicaccesses-table.md -->


- Общий доступ (`"type": "macro"`)

  #|
  || **Элемент** | **Описание** ||
  ||`macros` | Массив, который содержит информацию о том, будет ли общий доступ к ресурсу с указанными правами предоставлен только внутри организации или для любых пользователей. Возможные значения:
    - `employees` — общий доступ к ресурсу только внутри определенной организации;
    - `all` — общий доступ для всех пользователей. ||
  ||`org_id` | Идентификатор организации, сотрудникам которой предоставляется общий доступ к ресурсу с правами, указанными в параметре `rights` данного объекта. Указывается, только если параметр `macros` имеет значение `employees`. ||
  ||`type` | Уровень права доступа: `macro` — общий доступ. ||
  ||`rights` | Права доступа к ресурсу. Возможные значения:
    - `write` — редактирование;
    - `read` — просмотр;
    - `read_without_download` — просмотр без возможности скачивания;
    - `read_with_password` — просмотр с доступом по паролю;
    - `read_with_password_without_download` — просмотр с доступом по паролю без возможности скачивания. ||
  |#

- Персональный доступ для сотрудников (`"type": "user"`)

  #|
  || **Элемент** | **Описание** ||
  ||`id` | Уникальный идентификатор (uid) сотрудника организации, которому предоставлен персональный доступ к ресурсу с правами, указанными в параметре `rights` данного объекта. ||
  ||`org_id` | Идентификатор организации, к которой относится сотрудник. ||
  ||`type` | Уровень права доступа: `user` — персональный доступ для сотрудника организации. ||
  ||`rights` | Права доступа к ресурсу. Возможные значения:
    - `write` — редактирование;
    - `read` — просмотр. ||
  |#

- Персональный доступ для групп (`"type": "group"`)

  #|
  || **Элемент** | **Описание** ||
  ||`id` | Уникальный идентификатор (id) группы в организации, которой предоставлен персональный доступ к ресурсу с правами, указанными в параметре `rights` данного объекта. ||
  ||`org_id` | Идентификатор организации, которой принадлежит группа. ||
  ||`type` | Уровень права доступа: `group` — персональный доступ для группы. ||
  ||`rights` | Права доступа к ресурсу. Возможные значения:
    - `write` — редактирование;
    - `read` — просмотр. ||
  |#

- Персональный доступ для подразделений (`"type": "department"`)

  #|
  || **Элемент** | **Описание** ||
  ||`id` | Уникальный идентификатор (id) подразделения в организации, которому предоставлен персональный доступ к ресурсу с правами, указанными в параметре `rights` данного объекта. ||
  ||`org_id` | Идентификатор организации, которой принадлежит подразделение. ||
  ||`type` | Уровень права доступа: `department` — персональный доступ для подразделения. ||
  ||`rights` | Права доступа к ресурсу. Возможные значения:
    - `write` — редактирование;
    - `read` — просмотр. ||
  |#
<!-- endsource: ru/_includes/reference/response-objects/id-link/publicaccesses-table.md -->

<!-- source: ru/_includes/reference/public-settings-get-admin/publicaccesses-table-admin-addon.md -->


- Доступ для владельца (`"type": "owner"`)

  #|
  || **Элемент** | **Описание** ||
  ||`id` | Уникальный идентификатор (uid) сотрудника организации — владельца публичного ресурса. ||
  ||`org_id` | Идентификатор организации, к которой относится сотрудник. ||
  ||`type` | Уровень права доступа: `owner` — доступ для владельца ресурса. ||
  ||`rights` | Права доступа к ресурсу. Всегда `write` — редактирование. ||
  |#
<!-- endsource: ru/_includes/reference/public-settings-get-admin/publicaccesses-table-admin-addon.md -->

### Ответ с ошибкой

<!-- source: ru/_includes/reference/response-error.md -->
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит [описание ошибки](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#error).
<!-- endsource: ru/_includes/reference/response-error.md -->

Некоторые возможные ошибки:

* `400` — Некорректный запрос.
* `401` — Не авторизован.
* `403` — API недоступно. Ваши файлы занимают больше места, чем у вас есть. Удалите лишнее или увеличьте объем Диска. / Отправитель запроса не является администратором в организации.
* `404` — Не удалось найти запрошенный ресурс. / Публичной ресурс не принадлежит организации, в которой состоит текущий пользователь.
* `503` — Сервис временно недоступен.

[*popup-user_id]: Идентификатор (UID) сотрудника организации.

[*popup-path]: Путь к ресурсу на Диске сотрудника с указанным `user_id`.


Путь в значении параметра следует кодировать в URL-формате.

[*popup-a]: Обязательный параметр.