Определяет, существует ли указанная (направленная) связь между указанными исходными и целевыми активами.
Отношение описывает цель связи между двумя активами, заявленную исходным активом. Примером таких отношений является делегирование привилегий или разрешений.
Эта команда чаще всего используется инфраструктурными системами для проверки предварительных условий действия. Например, клиент может захотеть узнать, можно ли вместо этого отправить веб-URL-адрес конкретному мобильному приложению. Клиент может проверить ссылку на соответствующий актив с веб-сайта на мобильное приложение, чтобы решить, следует ли разрешить операцию.
Примечание о безопасности: если вы укажете в качестве источника защищенный ресурс, например веб-сайт HTTPS или приложение Android, API будет гарантировать, что все операторы, используемые для генерации ответа, были сделаны безопасным способом владельцем этого актива. . И наоборот, если исходным ресурсом является небезопасный веб-сайт HTTP (то есть URL-адрес начинается с http://
вместо https://
), API не может безопасно проверить свои утверждения, и невозможно гарантировать, что утверждения веб-сайта не были изменены третьей стороной. Дополнительную информацию см. в технической спецификации Digital Asset Links .
HTTP-запрос
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Параметры запроса
Имя параметра | Тип | Описание |
---|---|---|
source | object( | Источник, содержащий список утверждений. Это используется для маршрутизации вызова Check() к правильному источнику. |
relation | string | Строка запроса для отношения. Мы идентифицируем отношения со строками формата Текущий список поддерживаемых отношений можно найти в нашей документации по API . Чтобы запрос соответствовал ссылке на актив, строки отношений запроса и ссылки на актив должны точно совпадать. Пример. Запрос с отношением |
target | object( | Целевой актив отчета. |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
В случае успеха тело ответа содержит данные следующей структуры:
Ответное сообщение на вызов CheckAssetLinks.
JSON-представление |
---|
{ "linked": boolean, "maxAge": string, "debugString": string, } |
Имя поля | Тип | Описание |
---|---|---|
linked | boolean | Установите значение true, если активы, указанные в запросе, связаны отношением, указанным в запросе. НЕОБХОДИМЫЙ |
maxAge | string | В зависимости от времени обслуживания, в течение какого времени ответ следует считать действительным, за исключением дальнейших обновлений. НЕОБХОДИМЫЙ Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся символом « |
debugString | string | Читабельное сообщение, содержащее информацию, призванную помочь конечным пользователям понять, воспроизвести и отладить результат. Сообщение будет на английском языке, и в настоящее время мы не планируем переводить его. Обратите внимание, что никаких гарантий относительно содержимого или формата этой строки не предоставляется. Любой аспект может быть изменен без предварительного уведомления. Не следует пытаться программно анализировать эти данные. Если вы считаете, что вам необходимо это сделать, потому что нужная вам информация иначе не предоставляется через API, сначала свяжитесь с нами. |
Попробуй это!
Используйте API-обозреватель , чтобы вызвать этот метод для реальных данных и просмотреть ответ.