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 , чтобы вызвать этот метод для оперативных данных и просмотреть ответ.