Method statements.list

Извлекает список всех операторов из заданного источника, которые соответствуют указанной цели и строке оператора.

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

Команда List наиболее полезна в тех случаях, когда клиент API хочет знать все способы связи двух ресурсов или перечислить все связи из определенного исходного актива. Пример: функция, которая помогает пользователям переходить к связанным элементам. Когда мобильное приложение запущено на устройстве, эта функция позволит легко перейти на соответствующий веб-сайт или профиль Google+.

HTTP-запрос

GET https://digitalassetlinks.googleapis.com/v1/statements:list

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

Имя параметра Тип Описание
source object( Asset ) Источник, содержащий список утверждений. Это используется для направления запроса List() к нужному источнику. НЕОБХОДИМЫЙ
relation string

Используйте только ассоциации, соответствующие указанному отношению.

См. сообщение Statement для подробного определения строк отношения.

Чтобы запрос соответствовал оператору, должно выполняться одно из следующих условий:

  • строки отношений запроса и оператора точно совпадают, или
  • строка связи запроса пуста или отсутствует.

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

Тело запроса

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

Тело ответа

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

Ответное сообщение для вызова List.

JSON-представление
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
Имя поля Тип Описание
statements[] object( Statement ) Список всех найденных совпадающих утверждений.
maxAge string

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

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

debugString string

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

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

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

Заявление

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

Заявления всегда делаются исходным активом либо напрямую, либо путем делегирования списку операторов, который хранится в другом месте.

Более подробные определения операторов и активов можно найти на нашей целевой странице документации API .

JSON-представление
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
Имя поля Тип Описание
source object( Asset ) У каждого оператора есть исходный актив. НЕОБХОДИМЫЙ
relation string

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

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

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

Пример: delegate_permission/common.handle_all_urls ОБЯЗАТЕЛЬНО

target object( Asset ) У каждого утверждения есть целевой актив. НЕОБХОДИМЫЙ

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

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