Веб-ресурс — это представление проверенного веб-сайта или домена.
Он содержит канонический идентификатор сайта или домена, URL-адрес или имя домена, а также список владельцев. Обратите внимание, что список владельцев всегда включает аутентифицированного пользователя, поскольку единственные люди, которые могут получить доступ к веб-ресурсу, — это аутентифицированные пользователи, являющиеся владельцами этого сайта или домена.
Список методов для этого ресурса см. в конце этой страницы.
Представления ресурсов
{ "id": string, "site": { "type": string, "identifier": string }, "owners": [ string ] }
Имя свойства | Ценить | Описание | Примечания |
---|---|---|---|
id | string | Строка, используемая для идентификации этого сайта. Это значение следует использовать в части id URL-адреса REST для операций get , update и delete . | |
owners[] | list | Адреса электронной почты всех прямых, проверенных владельцев именно этого объекта недвижимости. Косвенные владельцы — например, проверенные владельцы содержащего домена — не включены в этот список. | |
site | object | Контейнер для адреса и типа сайта, который проверен или будет проверен. | |
site. identifier | string | Идентификатор сайта, который принимает разные формы в зависимости от значения свойства type . | |
site. type | string | Тип сайта. Приемлемые значения:
|
Методы
Используйте метод вставки , чтобы подтвердить право собственности аутентифицированного пользователя на веб-сайт или домен. Используйте методы get , update и delete для получения или изменения ресурса , который уже проверен для аутентифицированного пользователя.
Вы можете просмотреть все проверенные ресурсы для аутентифицированного пользователя с помощью list и получить токен для размещения на сайте аутентифицированного пользователя с помощью getToken .
- удалить
- Отменяет право собственности пользователя на веб-сайт или домен.
- получать
- Получает самые актуальные данные о веб-сайте или домене.
- получить токен
- Получает токен проверки, который пользователь, прошедший проверку подлинности, может разместить на веб-сайте или в домене.
- вставлять
- Подтверждает право собственности на веб-сайт или домен.
- список
- Получает список проверенных веб-сайтов и доменов прошедшего проверку подлинности пользователя.
- обновлять
- Изменяет список владельцев веб-сайта или домена.