Определяет, существует ли указанная (направленная) связь между указанными исходными и целевыми активами.
Отношение описывает намерение связи между двумя активами, заявленное исходным активом. Примером таких отношений является делегирование привилегий или разрешений.
Эта команда чаще всего используется инфраструктурными системами для проверки предварительных условий действия. Например, клиент может захотеть узнать, можно ли вместо этого отправить веб-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 , чтобы вызвать этот метод для оперативных данных и просмотреть ответ.