Method statements.list

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

Interfejs API gwarantuje, że wszystkie instrukcje z zasobami zabezpieczonymi źródłowymi, takie jak witryny HTTPS lub aplikacje na Androida, zostały wykonane w bezpieczny sposób przez właściciela tych zasobów, zgodnie ze specyfikacją techniczną linków do zasobów cyfrowych. Pamiętaj, że w przypadku niezabezpieczonych witryn (czyli takich, których adres URL zaczyna się od http:// zamiast https://) nie można zagwarantować takiej gwarancji.

Polecenie List jest najbardziej przydatne, gdy klient interfejsu API chce poznać wszystkie sposoby, na jakie dwa zasoby są ze sobą powiązane, lub wyliczyć wszystkie relacje z określonego zasobu źródłowego. Przykład: funkcja, która pomaga użytkownikom przejść do powiązanych elementów. Gdy aplikacja mobilna działa na urządzeniu, funkcja ta ułatwia przechodzenie do odpowiedniej witryny lub 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ące listę instrukcji. Służą do kierowania żądania List() do właściwego źródła. WYMAGANE
relation string

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

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

Aby zapytanie zostało dopasowane do wyrażenia, musi być spełniony jeden z tych warunków:

  • ciągi relacji zapytania i wyrażenia są dokładnie dopasowane, lub
  • ciąg relacji zapytania jest pusty lub brakuje w nim ciągu znaków.

Przykład: zapytanie z relacją delegate_permission/common.handle_all_urls pasuje do linku zasobu z relacją 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:

Komunikat z odpowiedzią na wywołanie listy.

Zapis JSON 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
Nazwa pola Typ Opis
statements[] object(Statement) Lista wszystkich pasujących instrukcji.
maxAge string

Po jakim czasie od wyświetlenia odpowiedź ma być uznawana za prawidłową, z wyłączeniem dalszych aktualizacji. WYMAGANE

Czas trwania w sekundach z maksymalnie dziewięcioma cyframi po przecinku, zakończony znakiem „s”. Przykład: "3.5s".
debugString string

Zrozumiały dla człowieka komunikat zawierający informacje, które pomogą użytkownikom zrozumieć, odtworzyć i debugować wynik.

Wiadomość będzie w języku angielskim. Obecnie nie planujemy oferować żadnych tłumaczeń.

Pamiętaj, że nie możemy zagwarantować co najmniej 1 z treści ani formatu tego ciągu znaków. Jego każdy aspekt może ulec zmianie bez powiadomienia. Nie należy podejmować prób programowej analizy tych danych. Jeśli uważasz, że musisz to zrobić, ponieważ informacje, których potrzebujesz, nie są ujawniane przez interfejs API, najpierw skontaktuj się z nami.

Instrukcja

Opisuje rzetelne stwierdzenie dotyczące relacji między zasobem źródłowym a docelowym.

Instrukcje są zawsze tworzone przez zasób źródłowy – bezpośrednio lub przez przekazanie do listy instrukcji przechowywanej w innym miejscu.

Bardziej szczegółowe definicje wyciągów i komponentó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 określa użycie wyrażenia przez właściciela zasobu źródłowego (czyli osobę lub podmiot, który je wydał). Każde pełne wyrażenie ma swój związek.

Identyfikujemy relacje z ciągami znaków w formacie <kind>/<detail>, gdzie <kind> musi być jedną ze wstępnie zdefiniowanych kategorii przeznaczenia, a <detail> to swobodny ciąg alfanumeryczny, który opisuje określony przypadek użycia wyrażenia.

Bieżącą listę obsługiwanych relacji znajdziesz w dokumentacji interfejsu API.

Przykład: delegate_permission/common.handle_all_urls REQUIRED
target object(Asset) Każde wyrażenie zawiera zasób docelowy. WYMAGANE

Wypróbuj

Użyj Eksploratora interfejsów API, aby wywołać tę metodę w przypadku bieżących danych i zobaczyć odpowiedź.