Method assetlinks.check

Определяет, существует ли указанная (направленная) связь между указанными исходными и целевыми активами.

Отношение описывает цель связи между двумя активами, заявленную исходным активом. Примером таких отношений является делегирование привилегий или разрешений.

Эта команда чаще всего используется инфраструктурными системами для проверки предварительных условий действия. Например, клиент может захотеть узнать, можно ли вместо этого отправить веб-URL-адрес конкретному мобильному приложению. Клиент может проверить ссылку на соответствующий актив с веб-сайта на мобильное приложение, чтобы решить, следует ли разрешить операцию.

Примечание о безопасности: если вы укажете в качестве источника защищенный ресурс, например веб-сайт HTTPS или приложение Android, API будет гарантировать, что все операторы, используемые для генерации ответа, были сделаны безопасным способом владельцем этого актива. . И наоборот, если исходным ресурсом является небезопасный веб-сайт HTTP (то есть URL-адрес начинается с http:// вместо https:// ), API не может безопасно проверить свои утверждения, и невозможно гарантировать, что утверждения веб-сайта не были изменены третьей стороной. Дополнительную информацию см. в технической спецификации Digital Asset Links .

HTTP-запрос

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

Параметры запроса

Имя параметра Тип Описание
source object( Asset ) Источник, содержащий список утверждений. Это используется для маршрутизации вызова Check() к правильному источнику.
relation string

Строка запроса для отношения.

Мы идентифицируем отношения со строками формата <kind>/<detail> , где <kind> должен быть одной из набора заранее определенных категорий назначения, а <detail> — это буквенно-цифровая строка свободной формы в нижнем регистре, описывающая конкретное использование. случай высказывания.

Текущий список поддерживаемых отношений можно найти в нашей документации по API .

Чтобы запрос соответствовал ссылке на актив, строки отношений запроса и ссылки на актив должны точно совпадать.

Пример. Запрос с отношением delegate_permission/common.handle_all_urls соответствует ссылке на актив с отношением delegate_permission/common.handle_all_urls .

target object( Asset ) Целевой актив отчета.

Тело запроса

Тело запроса должно быть пустым.

Тело ответа

В случае успеха тело ответа содержит данные следующей структуры:

Ответное сообщение на вызов CheckAssetLinks.

JSON-представление
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
Имя поля Тип Описание
linked boolean Установите значение true, если активы, указанные в запросе, связаны отношением, указанным в запросе. НЕОБХОДИМЫЙ
maxAge string

В зависимости от времени обслуживания, в течение какого времени ответ следует считать действительным, за исключением дальнейших обновлений. НЕОБХОДИМЫЙ

Длительность в секундах, содержащая до девяти дробных цифр, заканчивающаяся символом « s ». Пример: "3.5s" .

debugString string

Читабельное сообщение, содержащее информацию, призванную помочь конечным пользователям понять, воспроизвести и отладить результат.

Сообщение будет на английском языке, и в настоящее время мы не планируем переводить его.

Обратите внимание, что никаких гарантий относительно содержимого или формата этой строки не предоставляется. Любой аспект может быть изменен без предварительного уведомления. Не следует пытаться программно анализировать эти данные. Если вы считаете, что вам необходимо это сделать, потому что нужная вам информация иначе не предоставляется через API, сначала свяжитесь с нами.

Попробуй это!

Используйте API-обозреватель , чтобы вызвать этот метод для реальных данных и просмотреть ответ.