Method statements.list

Pobiera listę wszystkich instrukcji z danego źródła, które pasują do określonego ciągu docelowego i ciągu instrukcji.

Interfejs API gwarantuje, że wszystkie oświadczenia z bezpiecznymi zasobami źródłowymi, takie jak witryny HTTPS lub aplikacje na Androida, zostały bezpiecznie utworzone przez właściciela tych zasobów, zgodnie z specyfikacją techniczną linków do zasobów cyfrowych. W szczególności pamiętaj, że w przypadku niezabezpieczonych witryn (których adres URL zaczyna się od http:// zamiast https://), nie można tego zagwarantować.

Polecenie List jest najbardziej przydatne w przypadkach, gdy klient API chce poznać wszystkie sposoby powiązania 2 zasobów lub wyliczyć wszystkie relacje z danego zasobu źródłowego. Przykład: funkcja ułatwiająca użytkownikom przechodzenie do powiązanych elementów Gdy aplikacja mobilna działa na urządzeniu, funkcja ułatwia poruszanie się w odpowiedniej witrynie internetowej lub na profilu Google+.

Żądanie HTTP

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

Parametry zapytania

Nazwa parametru Typ Opis
source object(Asset) Źródło hostującej listę wyciągów. Służy ona do kierowania żądania List() do właściwego źródła. WYMAGANE
relation string

Używaj tylko powiązań, które pasują do określonego powiązania.

Szczegółową definicję ciągów relacji znajdziesz w komunikacie Statement.

Aby zapytanie pasowało do instrukcji, musi być spełniony jeden z tych warunków:

  • zarówno ciągi relacji zapytania, jak i wyrażenia są identyczne, lub
  • brak ciągu znaków zapytania lub jest on pusty.

Przykład: zapytanie o relacji delegate_permission/common.handle_all_urls pasuje do linku do zasobu o relacji delegate_permission/common.handle_all_urls.

Treść żądania

Treść żądania musi być pusta.

Treść odpowiedzi

W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:

Odpowiedź na wywołanie listy.

Zapis JSON 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
Nazwa pola Typ Opis
statements[] object(Statement) Lista wszystkich znalezionych dopasowań stwierdzeń.
maxAge string

Od momentu wyświetlenia odpowiedź powinna być uznawana za prawidłową, o ile jest ona uzasadniona. WYMAGANE

Czas trwania w sekundach z maksymalnie 9 cyframi po przecinku (s). Przykład: "3.5s".
debugString string

Czytelna dla człowieka wiadomość zawierająca informacje, które pomagają użytkownikom zrozumieć, odtworzyć i debugować wynik.

Wiadomość będzie w języku angielskim i nie planujemy udostępnić żadnych tłumaczeń.

Pamiętaj, że nie gwarantujemy zawartości ani formatu tego ciągu znaków. Każdy aspekt usługi może ulec zmianie bez powiadomienia. Nie próbuj automatycznie analizować tych danych. Jeśli uważasz, że musisz to zrobić, ponieważ interfejs API nie zapewnia dostępu do potrzebnych informacji, najpierw skontaktuj się z nami.

Instrukcja

Przedstawia rzetelne stwierdzenie na temat zależności między zasobem źródłowym a zasobem docelowym.

Wyciągi są zawsze składane przez zasób źródłowy – bezpośrednio lub przez przekazanie dostępu do listy zapisanych gdzie indziej.

Bardziej szczegółowe definicje wyciągów i zasobów znajdziesz na stronie dokumentacji interfejsu API.

Zapis JSON 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
Nazwa pola Typ Opis
source object(Asset) Każda instrukcja zawiera zasób źródłowy. WYMAGANE
relation string

Relacja wskazuje sposób, w jaki zostanie on użyty przez właściciela zasobu źródłowego, czyli osobę, która je wydała. Każde stwierdzenie ma związek.

Identyfikujemy powiązania z ciągami znaków w formacie <kind>/<detail>, gdzie <kind> musi być jedną ze zdefiniowanych wstępnie kategorii, a <detail> to dowolny ciąg znaków alfanumerycznych, który opisuje konkretny przypadek użycia wyrażenia.

Aktualną listę obsługiwanych relacji znajdziesz w naszej dokumentacji interfejsu API.

Przykład: delegate_permission/common.handle_all_urls WYMAGANE
target object(Asset) Każda instrukcja zawiera zasób docelowy. WYMAGANE

Wypróbuj

Aby wywołać tę metodę w aktywnych danych i zobaczyć odpowiedź, użyj eksploratora interfejsów API.