Method statements.list

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

API гарантирует, что все заявления с безопасными исходными ресурсами, такими как веб-сайты HTTPS или приложения Android, были сделаны безопасным способом владельцем этих ресурсов, как описано в технической спецификации дизайна цифровых активов . В частности, вы должны учитывать, что для небезопасных веб-сайтов (то есть 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 .

Тело запроса

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

Тело ответа

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

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

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